本服务面向非中国大陆地区 · ZetaAPI.AI 的网站与控制台主要面向非中国大陆市场，注册与开通功能在你当前地区不可用。

Справочник API

Эндпоинты ZetaAPI, аутентификация, совместимые форматы, коды ошибок и лимиты. Сквозная поддержка форматов OpenAI и Anthropic — без изменения SDK.

Обновлено 2026-04-17

Base URL

https://api.staging.cosmos-router.com

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

Каждый запрос должен содержать Authorization: Bearer sk-xxxxx:

curl https://api.staging.cosmos-router.com/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxx" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "hi"}]}'

Формат Anthropic также принимает x-api-key (как у официального API):

curl https://api.staging.cosmos-router.com/v1/messages \
  -H "x-api-key: sk-xxxxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-sonnet-4-6", "max_tokens": 1024, "messages": [{"role": "user", "content": "hi"}]}'

Обзор эндпоинтов

ЭндпоинтПротоколПримечания
POST /v1/chat/completionsOpenAIДополнение чата, поддержка SSE-стрима
POST /v1/completionsOpenAIКлассическое дополнение текста (старые модели)
POST /v1/embeddingsOpenAIВекторные эмбеддинги
POST /v1/messagesAnthropicНативный формат Claude, поддержка prompt cache
GET /v1/modelsOpenAIСписок моделей, доступных аккаунту

Поддерживаемые семейства моделей

Модели и цены обновляются с каждым деплоем; списки выше — лишь примеры. Полный список моделей и актуальные коэффициенты цен см. на странице цен — она является источником истины.

Потоковые ответы (SSE)

Установите в запросе "stream": true:

stream = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Напиши быструю сортировку на Python"}],
    stream=True,
)

for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="", flush=True)

SSE возвращает формат data: {...}\n\n и завершается data: [DONE] — полностью как в официальных API OpenAI / Anthropic.

Prompt Cache

Модели OpenAI

Кэшируются автоматически, без дополнительных параметров. Повторяющиеся префиксы тарифицируются по ставке попадания в кэш (50% от цены ввода или ниже, в зависимости от модели).

Claude (формат Anthropic)

Отметьте явно на блоке system или messages:

{
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "system": [
    {
      "type": "text",
      "text": "Длинный системный промпт...",
      "cache_control": { "type": "ephemeral" }
    }
  ],
  "messages": [...]
}

Ставка попадания в кэш — 10% от цены ввода, как у официального API. См. замер стоимости Prompt Cache.

Коды ошибок

HTTPCodeЗначениеРекомендация
400invalid_request_errorНеверные параметры (нет поля, неверный формат, имя модели)Проверьте тело запроса
401authentication_errorКлюч недействителен или отозванСоздайте новый ключ
402insufficient_quotaНедостаточно средствПополните в консоли
403permission_errorКлюч не имеет доступа к этой моделиПроверьте права ключа
404not_found_errorОпечатка в имени моделиСм. /v1/models
429rate_limit_errorСработал лимитПовтор с экспоненциальной задержкой
500internal_errorВнутренняя ошибка платформыУчитывается в статистике сбоев; компенсация — по заявке согласно опубликованным правилам
502 / 503upstream_errorСбой вышестоящего, идёт переключение каналовКлиент может повторить сразу
504timeout_errorТаймаут вышестоящегоКлиент может повторить сразу

Тело ошибки совпадает с форматом OpenAI:

{
  "error": {
    "type": "invalid_request_error",
    "message": "model 'gpt-4-vision' not found",
    "code": null
  }
}

Лимиты

Автоматическое переключение

Когда доступность вышестоящего канала аномально падает, платформа автоматически перенаправляет трафик на резервный канал — в подавляющем большинстве случаев прозрачно для клиента.

Компенсация SLA рассчитывается по календарному месяцу + группе SKU; сейчас выплата оформляется по заявке (ручной расчёт); как подать заявку и уровни: Заявка на компенсацию (архитектура: Правила компенсации как продукт).

Поддержка SDK

Дополнительно