Вопросы и ответы
Короткие ответы на то, обо что спотыкаются чаще всего, и ссылка на страницу, где каждый разобран целиком.
Подключение
Какой base URL подставлять?
Для OpenAI-совместимого клиента — https://api.kumorouter.com/v1. Для клиента, написанного под нативный API Anthropic, — https://api.kumorouter.com, голый origin без пути: такой клиент дописывает путь сам, и base URL с префиксом отправит его туда, где ничего нет.
Как пишется заголовок → Первый вызов →
Какие модели можно называть?
Те, что перечисляет сам шлюз по адресу https://api.kumorouter.com/v1/models, и они же — в прайс-листе. Эта документация не называет ни одной модели намеренно: в примерах стоит подстановка, а актуальный список принадлежит каталогу, а не тексту.
Почему запрос отклонён без `max_tokens`?
Потолок вывода обязателен. На поверхности Chat Completions это max_tokens либо max_completion_tokens, на поверхности Messages — max_tokens, и умолчания у него нет. Причина в деньгах: измерение без конечного потолка нельзя зарезервировать до обращения к провайдеру.
Нужно ли менять код под Kumo?
Нет: поверхности отвечают своими собственными протоколами, а не переводом чужого. Меняются base URL и ключ.
Ключи
Я потерял секрет ключа. Как его посмотреть?
Никак. Секрет показывается один раз, в момент создания; дальше платформа хранит только его хэш, и прочитать секрет не может ни экран, ни операция, ни поддержка. Лекарство — новый ключ.
Можно ли переименовать ключ?
Нет. Название фиксируется при создании, и операции переименования у ключа нет. Меняются срок действия, проект и выключатель.
Как проверить, что ключ живой, не совершая вызова?
Эхо личности отвечает о самом ключе, а не выводом модели: имя, фрагменты для показа, чем оплачивается и срок. Прямо на этом сайте, из браузера.
Почему `401` не говорит, что именно не так?
Потому что отсутствующий, искажённый, неизвестный, отозванный, выключенный и истёкший ключи отвечаются одинаково — намеренно. Различать их значило бы превратить шлюз в оракул по ключевому материалу: со списком догадок можно было бы выяснить, какие из них существуют.
Отказы
`429` или `503` — в чём разница?
429 — это потолок, выше которого вы оказались, и лечит его время. 503 — сейчас никто наверху не может обслужить этот вызов. Ни один не лечится немедленным повтором.
Поток кончился раньше — ответ полный?
Нет. Считайте поток, кончившийся без завершающего кадра, неудавшимся вызовом, а не коротким: сбой после начала потока просто обрывает его, и в полученных байтах ничто не скажет, что ответ усечён.
Как читать обрыв → Поведение отказа →
Как поднять свои лимиты?
Разговором с поддержкой. Ни один потолок не правится в консоли, и ни один член запроса не просит о более высоком.
С чем выпускается ключ → Как написать →
Деньги
Кошелёк или пакет — что выбрать?
Кошелёк считает в долларах и пополняется любой суммой; пакет — предоплаченный лимит токенов, он один на аккаунт, покупается от 30 миллионов токенов и дальше только пополняется. Каждый ключ сам выбирает, из чего тратить, — из пакета или с баланса, — и выбор можно поменять в любой момент; ключ на пакете может продолжить с баланса, когда лимит кончится.
Сравнение → Как считает кошелёк →
Есть ли минимальная сумма пополнения?
Да: $2, или рублёвый эквивалент по курсу чекаута на момент оплаты. Пакет при этом покупается объёмом токенов — от 30 миллионов.
Можно ли попробовать без денег?
Нет. Кошелёк, на котором ничего нет, отклоняет каждый вызов ключей, которые тратят с баланса, с кодом 402: выпуск ключа бесплатен, вызов — нет.
Где прайс-лист?
На странице цен. В тексте документации цен нет намеренно: их публикует прайс-лист, а страница, повторившая цифру, устареет молча.
Почему расход показан двумя числами, а не одним?
Потому что это две разные единицы: доллары кошелька и токены пакета. Курса между ними платформа не публикует, поэтому их сумма была бы числом без единицы.
Данные и инструменты
Хранит ли Kumo мои промпты?
Вызов записывается формой, а не содержимым: ни промпта, ни ответа, ни заголовков, ни адреса клиента в истории нет — их не хранят вовсе. Обратная сторона та же: восстановить по логу, о чём был запрос, не сможете и вы.
Сколько хранится история денег?
Движения средств — пять лет. Одним запросом читается окно не больше 366 дней, поэтому более старый период берётся сдвигом окна назад.
Как подключить Claude Code, Cursor или другой инструмент?
Готовым рецептом: платформа публикует их сама, вместе с промптом, который настроит инструмент за вас.
Все инструменты → Claude Code → Cursor →
Я сменил пароль и меня выкинуло со всех устройств. Так и должно быть?
Да. Смена пароля завершает все сессии, включая ту, из которой её делали: если пароль меняют потому, что старый утёк, чужая открытая вкладка обязана перестать работать сразу.