Перейти к содержимомуKumoДокументация
Документация

Один ключ на все модели

Поменяйте base URL и ключ — остальной код остаётся тем же. Какие модели доступны, что они умеют и сколько стоят, платформа публикует сама.

Создать ключЗа три минутыПроверить ключКаталог моделей
curl https://api.kumorouter.com/v1/chat/completions \
  -H "Authorization: Bearer $KUMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<model>",
    "max_tokens": 128,
    "messages": [{ "role": "user", "content": "Объясни токены одной строкой." }]
  }'

Начало работы

Быстрый стартТри минуты между браузером и ответом модели: ключ в консоли, base URL в клиенте, первый вызов. Ниже — то же самое подробно.АутентификацияОдин ключ, заголовок, который его несёт, и три вещи, которые платформа помнит о ключе: как он называется, чем оплачивается и до чего ему разрешено дотягиваться.Проверьте свой ключЕдинственная живая операция на этом сайте: вставьте ключ — и платформа прочитает вслух, что это за ключ и что ему разрешено.МоделиКаталог моделей публикует сама платформа: что доступно прямо сейчас, как это назвать в запросе, что означает каждая возможность и как выбрать модель под свою задачу.

Интеграции

ИнтеграцииНаправьте инструмент, который у вас уже стоит, на шлюз: base URL и ключ. Живые рецепты платформы, пошаговые гайды и промпт, которым настройку делает ваш агент.Claude CodeТри переменные окружения — и Claude Code ходит через шлюз. Плюс вариант через settings.json, порядок приоритетов ключей и проверка одной командой.Codex CLIПровайдер в config.toml, ключ из переменной окружения — и Codex CLI работает через шлюз, не меняя ни одной вашей привычки.CursorСвой ключ и переопределённый base URL в настройках моделей Cursor — и чат редактора ходит через шлюз. Плюс честный список того, что через него не ходит.Расширения VS CodeCline, Roo Code и Continue — один и тот же OpenAI-совместимый провайдер: base URL, ключ, идентификатор модели. Где эти поля лежат у каждого.Другие инструментыAider, Zed, OpenClaw — и способ подключить инструмент, которого здесь нет: отдать реквизиты кодовому агенту и дать ему сделать настройку.SDKОфициальные SDK OpenAI и Anthropic, Python и Node: установка, клиент с base URL шлюза и ключом из окружения, один вызов. Ваш код остаётся вашим кодом.Kumo Usage CLI BarПанель расхода и остатка под промптом Claude Code и Codex — ставится одной командой, находит ваш ключ сама и показывает, сколько осталось: пакет, баланс или ваш лимит.

Шлюз

Chat CompletionsВызов POST /v1/chat/completions — члены запроса, роли в разговоре, форма ответа и указатели на поток, инструменты и структурированный вывод.ResponsesВызов POST /v1/responses — чем он отличается от Chat Completions, члены запроса, типизированные элементы ответа и завершающее событие потока.MessagesДиалект Anthropic Messages — голый base URL, два носителя ключа, члены запроса, блоки ответа, события потока и подсчёт токенов, который не тратит квоту.ЭмбеддингиВызов POST /v1/embeddings — пачка входов, вектор на каждый вход в base64 и то, во что этот вызов обходится.ИзображенияВызов POST /v1/images/generations — промпт, число картинок и размер, форма ответа и то, что генерация считается в изображениях, а не в токенах.СтримингSSE в трёх диалектах шлюза — как включить поток, какие приходят события, чем кончается целый ответ и почему после первого байта вызов уже не переносят.ИнструментыВызов функций на трёх диалектах шлюза — как объявить инструмент, как выглядит круг «вызов — результат» и почему поддержка инструментов подтверждается отдельно для каждой модели.Структурированный выводОтвет по именованной JSON-схеме — какой формат принимает API, что значит строгость, как это выглядит на трёх диалектах и почему поддержка проверяется отдельно для каждой модели.ОшибкиКонверт, в котором приходит отказ, коды ответа шлюза и два поведения, которые должен учитывать клиент.ЛимитыПотолки, по которым меряется вызов, что получает упёршийся в потолок вызов и как просят о более высоком.Справочник APIКаждая операция шлюза Kumo, сгенерированная из опубликованного описания API: адрес, способ аутентификации, содержимое запроса и то, что приходит в ответ.

Аккаунт и оплата

АккаунтРегистрация, вход, профиль и организация — что платформа помнит об аккаунте, что из этого меняется в консоли и что нельзя изменить самому.КлючиВся жизнь ключа: что выбирается при создании и уже не меняется, один показ секрета, выключение, корзина и стирание навсегда.ОплатаКошелёк организации, пополнение через платёжную систему, закреплённый курс, из чего складывается списание и что отвечает вызов на пустом кошельке.ПакетыОдин пакет на аккаунт: лимит в процентах от плана, докупка и минимальная покупка, какие ключи тратят пакет, заморозка, уведомления и чем пакет отличается от кошелька.Расход и логиПотребление по окнам, разрезы по моделям, ключам и проектам, лог вызовов и то, как найти в нём один конкретный вызов.ПроектыЯрлык, которым ключи группируются между собой: как создать проект, как перенести в него ключ, что показывает его карточка и чем архив отличается от удаления.

Запускаете агента? Вся эта документация доступна как Markdown по адресу/llms-full.txt.