Claude Opus 5.5 · API

Быстрый старт

Два шага: отправить запрос, а затем получить ответ в потоковом режиме. Замените YOUR_API_KEY своим ключом, и команды ниже заработают как есть. Эндпоинт совместим с OpenAI Chat Completions, поэтому в готовом коде для OpenAI достаточно поменять base_url и model.

Шаг 1 · Отправка запроса

curl https://kovapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-opus-5-5", "messages": [{"role": "user", "content": "Объясни одним предложением, что такое фотосинтез"}]}'

Ответ (HTTP 200)

{
  "id": "chatcmpl-7f3c9a1e2b4d6f8a",
  "object": "chat.completion",
  "created": 1791281400,
  "model": "claude-opus-5-5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Фотосинтез — это процесс, в котором растения с помощью солнечного света превращают углекислый газ и воду в сахар и выделяют кислород."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 18,
    "completion_tokens": 42,
    "total_tokens": 60
  }
}

message.content — это ответ, а в usage — токены, по которым оплачивается этот запрос; как оплачивается кэширование промптов, описано ниже в разделе «Кэширование промптов».

Шаг 2 · Потоковый вывод (рекомендуется)

curl -N https://kovapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-opus-5-5", "stream": true, "messages": [{"role": "user", "content": "Объясни одним предложением, что такое фотосинтез"}]}'

Поток — это стандартный SSE: каждый фрагмент несёт текст в choices[0].delta.content, последний фрагмент содержит usage, а завершается поток строкой data: [DONE]. Для длинных ответов и моделей с размышлениями используйте потоковый вывод: непотоковый запрос обрывается примерно через 10 минут.

Python (OpenAI SDK)

from openai import OpenAI

client = OpenAI(base_url="https://kovapi.com/v1", api_key="YOUR_API_KEY")

# 1. Один запрос — один ответ
resp = client.chat.completions.create(
    model="claude-opus-5-5",
    messages=[{"role": "user", "content": "Объясни одним предложением, что такое фотосинтез"}],
)
print(resp.choices[0].message.content)

# 2. Потоковый вывод
stream = client.chat.completions.create(
    model="claude-opus-5-5",
    messages=[{"role": "user", "content": "Объясни одним предложением, что такое фотосинтез"}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Или используйте Anthropic SDK (нативный API)

import anthropic

client = anthropic.Anthropic(base_url="https://kovapi.com/anthropic", api_key="YOUR_API_KEY")
msg = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Объясни одним предложением, что такое фотосинтез"}],
)
print(next(b.text for b in msg.content if b.type == "text"))

В Anthropic SDK укажите base_url до /anthropic включительно — /v1/messages SDK добавит сам; ключ тот же.

Аутентификация

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Чтобы начать, создайте API-ключ в консоли.

Основные характеристики

Параметры запроса

JSON-тело запроса POST /v1/chat/completions — такое же, как в OpenAI Chat Completions. Основные параметры и то, как каждый из них работает у этой модели:

Остальные параметры OpenAI (например, stop, seed, user) передаются модели без изменений; сработают ли они, зависит от модели.

Цена

Оплата за токены по актуальным ценам ниже (за миллион токенов). Токены, записанные в кэш промптов, оплачиваются по цене записи в кэш, а попадания в кэш — по цене попадания в кэш. Оплачиваются только успешные запросы и только по фактическому расходу. 1 кредит = $0.005.

Например, запрос с 2000 входных токенов и 1000 выходных (включая размышления) стоит около $0.0175.

Размышления

Адаптивные размышления, всегда включены: модель сама решает, сколько размышлять над каждым вопросом. В OpenAI-совместимом API модель работает с интенсивностью по умолчанию, поэтому reasoning_effort там не действует.

Чтобы управлять интенсивностью (от low до max) или получать сводки размышлений, используйте нативный API /anthropic: "output_config": {"effort": "high"} и "thinking": {"type": "adaptive", "display": "summarized"}.

Токены размышлений считаются выходными и оплачиваются по цене выхода.

Кэширование промптов

Длинные промпты могут автоматически записываться в кэш даже без пометки (по цене записи в кэш), и тогда повторяющийся префикс оплачивается по цене попадания в кэш. В нативном API /anthropic место кэширования можно задать самостоятельно: "cache_control": {"type": "ephemeral"} в системном промпте или в блоке сообщения; Claude Code делает это сам.

Нативный API сообщает число токенов кэша в usage.cache_creation_input_tokens (запись) и usage.cache_read_input_tokens (попадания), и списание считается по этим числам.

Ввод изображений

Добавьте в массив content часть image_url. Рекомендуемый вариант — data URI в base64 (data:image/png;base64,...): его всегда удаётся прочитать. Изображение по публичной ссылке сначала нужно скачать, и иногда это не удаётся или не укладывается в таймаут. Изображения пересчитываются во входные токены по правилам разработчика модели.

curl https://kovapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-opus-5-5", "messages": [{"role": "user", "content": [{"type": "text", "text": "Что изображено на этой картинке"}, {"type": "image_url", "image_url": {"url": "data:image/png;base64,iVBORw0KGgo..."}}]}]}'

Вызов инструментов (function calling)

Опишите свои функции в tools с помощью JSON Schema. Когда модель решит вызвать функцию, она вернёт finish_reason: "tool_calls", а в message.tool_calls — имя функции и аргументы (строкой JSON).

curl https://kovapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-opus-5-5", "messages": [{"role": "user", "content": "Какая сейчас погода в Шанхае"}], "tools": [{"type": "function", "function": {"name": "get_weather", "description": "Current weather of a city", "parameters": {"type": "object", "properties": {"city": {"type": "string"}}, "required": ["city"]}}}]}'

Выполните функцию, добавьте результат в диалог сообщением с role: "tool" и соответствующим tool_call_id и отправьте диалог повторно — модель даст итоговый ответ. tool_choice принимает auto, none, required или конкретную функцию.

Веб-поиск

Добавьте в запрос "web_search": true (или элемент {"type": "web_search"} в tools): шлюз сначала ищет в интернете в реальном времени по содержанию диалога, передаёт модели до 5 результатов со ссылками как справочные материалы, а модель отвечает и указывает источники. Сам поиск бесплатный; справочный текст оплачивается как входные токены.

curl https://kovapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-opus-5-5", "web_search": true, "messages": [{"role": "user", "content": "Какие главные технологические новости сегодня"}]}'

Нативный API Anthropic (/anthropic)

• Адрес — https://kovapi.com/anthropic/v1/messages, запросы и ответы используют формат Anthropic Messages: потоковые события, вызовы инструментов (tool_use / tool_result) и блоки изображений полностью совпадают с Anthropic, поэтому Anthropic SDK и Claude Code работают без изменений.
• Авторизация — через заголовок x-api-key: YOUR_API_KEY (подходит и Authorization: Bearer); ключ тот же, что и для /v1. Заголовки anthropic-version и anthropic-beta передаются без изменений, а max_tokens обязателен.
• Здесь доступны только модели Claude: на любую другую модель вернётся 404 not_found_error. Также есть POST /anthropic/v1/messages/count_tokens (подсчёт токенов, бесплатно) и GET /anthropic/v1/models.
• Здесь доступны все возможности: output_config.effort (от low до max), сводки размышлений, структурированный вывод и ввод PDF. Принудительный вызов инструментов (tool_choice со значением any или с указанным инструментом) заменяется на auto.
• Ошибки возвращаются в формате Anthropic: {"type": "error", "error": {"type": ..., "message": ...}}; если на балансе не хватает средств, возвращается 402 billing_error.
• Веб-поиск на этом эндпоинте по умолчанию выключен (чтобы не менять префикс, который Claude Code повторяет в каждом ходе, и не сбивать его кэш); включается заголовком x-web-search: 1.

curl https://kovapi.com/anthropic/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-opus-5-5", "max_tokens": 1024, "messages": [{"role": "user", "content": "Объясни одним предложением, что такое фотосинтез"}]}'

Использование в Claude Code →

Надёжность и автоматические повторы

• Если запрос завершился ошибкой, не уложился в таймаут или упёрся в предел нагрузки, шлюз ещё до начала ответа автоматически повторяет его: повторять запрос самому не нужно, и дважды ничего не спишется.
• Начав передачу, поток больше не повторяется автоматически: если он оборвётся на середине, оплачивается то, что успело сгенерироваться до обрыва (см. Оплата и возвраты).
• Если модель загружена до предела, шлюз возвращает 429 с Retry-After: подождите указанное число секунд и повторите. Неудачные запросы не оплачиваются. Статус каждой модели — на странице статуса.

Ошибки и возвраты

Ошибки возвращаются объектом error (message, type, code, param); ориентируйтесь на HTTP-статус и code, а не на текст message. Неудачные запросы не оплачиваются; полный список — в разделе Коды ошибок.

Если поток дал сбой уже после начала передачи, код статуса не меняется: ошибка приходит строкой данных с error, или поток просто заканчивается (без data: [DONE]). Считайте такой поток оборванным.