Перейти к основному содержанию
Sunra предоставляет три эндпоинта LLM API, каждый из которых следует своему формату. Все три используют одну и ту же аутентификацию и базовый URL (https://api-llm.sunra.ai), поэтому вы можете выбрать тот формат, который лучше подходит для вашего стека. Прежде чем начать, получите API-ключ в вашей панели управления.

Chat Completions — /v1/chat/completions

Эндпоинт Chat Completions следует формату OpenAI Chat Completions. Он принимает список сообщений с ролями (system, user, assistant) и возвращает completion. Используйте этот эндпоинт, когда вам нужна полная совместимость с SDK и инструментами OpenAI. Ключевые возможности: streaming, function calling, vision (изображения, аудио, видео, файлы), reasoning, structured outputs (JSON schema / grammar), logprobs.
curl -X POST https://api-llm.sunra.ai/v1/chat/completions \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "messages": [
      { "role": "system", "content": "You are a helpful assistant." },
      { "role": "user", "content": "What is the capital of France?" }
    ]
  }'

Anthropic Messages — /v1/messages

Эндпоинт Anthropic Messages следует формату Anthropic Messages API. Он использует роли сообщений user / assistant с расширенными блоками контента и отдельным параметром system. Используйте этот эндпоинт, когда вам нужен нативный доступ к моделям Anthropic Claude и таким функциям, как extended thinking, prompt caching, citations и встроенные инструменты (web search, code execution). Ключевые возможности: streaming, extended thinking, prompt caching, tool use (custom + built-in), ввод PDF/документов, citations, structured outputs.
curl -X POST https://api-llm.sunra.ai/v1/messages \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "Hello, how are you?" }
    ]
  }'

Responses — /v1/responses

Эндпоинт Responses следует формату OpenAI Responses API. Он принимает гибкие input items (сообщения, function calls, reasoning) и возвращает structured output items. Используйте этот эндпоинт, когда вам нужны новейшие возможности OpenAI Responses, такие как встроенный web search, file search, code interpreter, computer use, интеграция MCP tools или image generation. Ключевые возможности: streaming, function calling, web search, file search, code interpreter, computer use, MCP tools, image generation, reasoning, structured outputs.
curl -X POST https://api-llm.sunra.ai/v1/responses \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "input": [
      { "type": "message", "role": "user", "content": "Hello, how are you?" }
    ]
  }'

Выбор подходящего эндпоинта

Chat CompletionsAnthropic MessagesResponses
ФорматOpenAI ChatAnthropic MessagesOpenAI Responses
Лучше всего дляСовместимость с SDK OpenAIНативные функции ClaudeНовейшие функции OpenAI
StreamingSSESSESSE
Function callingДаДа (custom + built-in)Да
ReasoningДаExtended thinkingДа
Structured outputJSON schema, grammarJSON schemaJSON schema
Built-in toolsWeb search, code executionWeb search, file search, code interpreter, computer use, MCP
Все три эндпоинта используют одну и ту же аутентификацию — просто передайте ваш API-ключ как Bearer-токен в заголовке Authorization.