KovAPI API — документация для разработчиков

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

Просто укажите свои Base URL и API-ключ — и ваш существующий OpenAI SDK заработает сразу, без доработок.

https://kovapi.com/v1

curl https://kovapi.com/v1/chat/completions -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"model": "gpt-5.5", "messages": [{"role": "user", "content": "Напишите короткое вступление о продукте — API для ИИ"}], "stream": false}'

Полные параметры запроса, примеры и особенности асинхронных задач для каждой модели — в её собственной документации: откройте её из таблицы моделей и цен ниже.

Больше готовых к запуску примеров (Python / Node / curl, включая асинхронный процесс для изображений и видео): github.com/gaoorange/nezhagate-api-examples

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

Для всех запросов к API требуется Bearer-токен.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Модели и цены

Полные параметры запроса, примеры и особенности асинхронных задач для каждой модели — в её собственной документации: откройте её из таблицы моделей и цен ниже.

Использование в приложении (без кода)

В любом приложении, которое поддерживает API OpenAI, заполните эти три поля — программирование не требуется:

Проверено с ChatBox, Cherry Studio, NextChat, LobeChat, Immersive Translate, Open WebUI и др.

Пошаговые инструкции для клиентов: SillyTavern · Cherry Studio · Cline

Нативный API Anthropic (Claude Code)

Помимо совместимого с OpenAI маршрута, модели Claude также предоставляют нативный Anthropic Messages API. Укажите Claude Code (или любому SDK Anthropic) базовый URL ниже и используйте ваш ключ шлюза в качестве x-api-key — рассуждение, вызов инструментов и кэширование промптов сохраняются в нативном виде.

export ANTHROPIC_BASE_URL=https://kovapi.com/anthropic
export ANTHROPIC_API_KEY=YOUR_API_KEY
# claude-sonnet-4-6 / claude-opus-5 / claude-fable-5 / claude-opus-5-5 / claude-sonnet-5-5

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-sonnet-4-6", "max_tokens": 1024, "messages": [{"role": "user", "content": "Hello"}]}'

Модели: claude-opus-5-5, claude-sonnet-5-5, claude-opus-5, claude-sonnet-5, claude-fable-5, claude-sonnet-4-6. Тарификация как у /v1 — за токен.

Тарификация кэша промптов: попадания в кэш (чтение кэша) оплачиваются по 1/10 (0.1×) от цены ввода, запись в кэш — по 1.25× (тарифы по каждой модели — на странице цен). Для попадания в кэш нужен стабильный и достаточно длинный префикс (Claude Opus ≥ 4096 токенов, Sonnet ≥ 2048), повторяющийся в течение короткого промежутка времени — Claude Code с большим CLAUDE.md или системным промптом поверх реальной кодовой базы попадает в кэш на каждом шаге, снижая стоимость ввода примерно до 1/10. Короткие чаты в песочнице слишком малы, чтобы кэшироваться.

Генерация видео (асинхронно)

Текст в видео / изображение в видео — это асинхронные задачи: вызов сразу возвращает HTTP 202 и id задачи ({"id":"img_...","object":"video.generation.job","status":"queued"}); опрашивайте GET /v1/videos/jobs/{id}, пока status не станет succeeded, результат — в data[0].url (переразмещённый mp4). 1-12 мин на клип. Два режима тарификации: Veo 3.1 тарифицируется за клип; Seedance 2.x и MiniMax H3 тарифицируются посекундно (rate x duration). Оба резервируют ровно столько, сколько затем списывают, и полностью возвращают средства при сбое. Соотношение сторон задаётся через size (по умолчанию — 16:9, альбомная ориентация); для варианта «изображение в видео» передайте референс первого кадра в image.

curl https://kovapi.com/v1/videos/generations -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' -d '{"model": "veo-3.1", "prompt": "кот занимается сёрфингом на закате", "tier": "fast", "resolution": "1080p", "size": "16:9"}'

curl https://kovapi.com/v1/videos/jobs/img_3f9a...c2 -H 'Authorization: Bearer YOUR_API_KEY'

Видеомодели: veo-3.1 gemini-omni-flash seedance-2.5-token seedance-2.5-token-draft seedance-2.5 seedance-2.0 seedance-2.0-fast seedance-2.0-mini seedance-2.0-clip seedance-2.5-30s wan3.0-video wan3.0-video-prime minimax-h3 grok-imagine-video-1.5

Вебхуки: уведомления о завершении задач

Генерация видео и изображений выполняется асинхронно: вы отправляете запрос, получаете ID задачи, а результат приходит чуть позже. Вместо постоянного опроса API мы можем отправить результат на ваш сервер, как только задача завершится, и предупредить, когда баланс будет подходить к концу.

Не хотите опрашивать статус? Добавьте callback_url при отправке задачи — по её завершении мы отправим результат на ваш сервер. Или задайте адрес по умолчанию в консоли. Документация по вебхукам →

Agent Skills: видео одной фразой прямо из ИИ-ассистента для кода

Установите скилл KovAPI в Claude Code, Codex, Cursor или другой ассистент с поддержкой скиллов и просто попросите: «сделай из этой картинки 8-секундное видео на seedance-2.5 и сохрани в ./out». Ассистент сам выберет модель, загрузит файлы, дождётся рендера и сохранит результат. Сейчас доступен видеоскилл Seedance 2.5 / 2.0.

npx skills add https://kovapi.com

export KOVAPI_API_KEY=YOUR_API_KEY

github.com/gaoorange/nezhagate-skills · Демо-видео (8 с, один запрос)

Заметки по интеграции для ИИ

Отправьте весь блок ниже в Codex / Claude Code / Cursor — он поймёт, как выполнить интеграцию. Также можно скопировать всю документацию целиком с помощью кнопки «Скопировать страницу» в правом верхнем углу.

Integrate KovAPI through its OpenAI-compatible API.
Base URL: https://kovapi.com/v1
API Key: read it from the environment variable KOVAPI_API_KEY.
Claude models can also use the native Anthropic protocol (for Claude Code / the Anthropic SDK): ANTHROPIC_BASE_URL=https://kovapi.com/anthropic, headers x-api-key=API Key and anthropic-version: 2023-06-01, POST /anthropic/v1/messages (max_tokens is required), models claude-sonnet-4-6 / claude-opus-5 / claude-fable-5 / claude-opus-5-5 / claude-sonnet-5-5.
Chat models (/chat/completions): deepseek-v4.1-flash / deepseek-v4-flash-0731 / glm-5.3 / qwen3.8-max / qwen3.8-flash / gpt-5.6-sol / gpt-5.6-luna / gpt-6-astra / gpt-6.1-sol / gpt-6-sol / gpt-6-luna / claude-sonnet-4-6 / claude-opus-5 / claude-fable-5 / claude-opus-5-5 / claude-sonnet-5-5 / gemini-4-argon / gemini-3.1-pro / gemini-3.8-flash / grok-4.7
Image models (text-to-image /images/generations; image-to-image /images/edits or add an image parameter): gpt-image-2 / gpt-image-2.5-flare / gpt-image-2.5-sunburst / nano-banana-2 / nano-banana-pro / nano-banana-2.1 / grok-imagine-image / grok-imagine-image-quality
Video models (/videos/generations, async jobs; add reference images for image-to-video; how each model uses them is in its own doc): veo-3.1 / gemini-omni-flash / seedance-2.5-token / seedance-2.5-token-draft / seedance-2.5 / seedance-2.0 / seedance-2.0-fast / seedance-2.0-mini / seedance-2.0-clip / seedance-2.5-30s / wan3.0-video / wan3.0-video-prime / minimax-h3 / grok-imagine-video-1.5
Auth: Authorization: Bearer YOUR_API_KEY
Requirements (chat): return choices[0].message.content; on 401 check the key, 402 means insufficient balance, 429/5xx can be retried.
Requirements (images, async): POST /images/generations or /images/edits returns HTTP 202 with a job id right away ({"id":"img_...","object":"image.generation.job","status":"queued"}); then poll GET /v1/images/jobs/{id} until status=succeeded and read data[0].url (an img.kovapi.com link kept for 15 days; download it or copy it to your own storage). Do not read data right after submitting.
Requirements (video, async): POST /videos/generations returns HTTP 202 with a job id (object=video.generation.job); then poll GET /v1/videos/jobs/{id} until status=succeeded and read data[0].url (a re-hosted mp4 link kept for 15 days). Render time varies by model (from a minute or two to over an hour); failed jobs are refunded in full.

Проверка баланса и расхода

С помощью любого API-ключа можно узнать остаток баланса и расход аккаунта — вход в панель управления не требуется. Проще всего: GET /v1/usage. Также доступен совместимый с OpenAI эндпоинт: /v1/dashboard/billing/credit_grants (баланс = total_available).

curl https://kovapi.com/v1/usage -H "Authorization: Bearer YOUR_API_KEY"

curl https://kovapi.com/v1/dashboard/billing/credit_grants -H "Authorization: Bearer YOUR_API_KEY"

Коды ошибок

Ошибки эндпоинтов /v1 имеют структуру ниже (эндпоинты /anthropic используют собственный формат Anthropic). code — стабильный машиночитаемый идентификатор: ориентируйтесь на code, а не на текст message.

{
  "error": {
    "message": "human readable",
    "type": "invalid_request_error | authentication_error | permission_error | insufficient_quota | rate_limit_error | server_error",
    "code": "stable_snake_case",
    "param": "field_name_or_null"
  }
}

Полный список кодов ошибок →

max_tokens для моделей с рассуждением — Модели Gemini 3.x Flash (3-flash-preview / 3.6 / 3.7 / 3.8, все уровни) тратят часть бюджета на скрытые рассуждения ещё до того, как начинают писать видимый ответ, поэтому небольшая часть бюджета расходуется прежде, чем ответ вообще появится: по замерам, max_tokens=16 сразу завершается ошибкой, а 32 / 64 возвращают правдоподобно выглядящее, но неверное значение с finish_reason=length. Шлюз поднимает бюджет вывода для этих моделей минимум до 512 (оплата — только за фактически использованные токены), но всё равно указывайте >=512 сами; любой finish_reason=length считайте возможным усечением ответа и повторяйте запрос с большим max_tokens.

Частые вопросы о доступе, оплате, моделях и безопасности. Частые вопросы KovAPI →