Частые вопросы про API
Короткие ответы про API kosareva.cloud: подключение, оплата, лимиты и ошибки.
Нужен ли VPN?
Нет. Запросы идут на наш домен api.kosareva.cloud, он отвечает из России напрямую. Оплата в рублях.
Можно ли использовать один ключ для разных моделей?
Да. Модель задаётся полем model в каждом запросе и к ключу не привязана, один ключ открывает весь каталог.
Чем ваш API отличается от OpenAI API?
Форматом ничем: те же пути, параметры, ответы и SDK. Отличаются адрес, ключ и имена моделей: у нас они латиницей через дефисы, как в каталоге, gpt-5-6, а не gpt-5.6. И по одному ключу доступны модели разных вендоров, не только OpenAI.
Как оплатить?
Физлицам картой или через СБП, от 50 ₽. Юрлицам по счёту. Абонентской платы нет, деньги списываются с баланса по факту запросов.
Дадите ли вы закрывающие документы?
Да: договор, счёт, акт и инвойс. Оплата в рублях банковским переводом, счёт можно выставить в разделе «Пополнение баланса».
Как списываются деньги?
За текстовые модели по токенам, по цене из каталога. За картинки, озвучку, видео и музыку по своим единицам, цена указана на странице модели. Когда баланс в нуле, запросы блокируются.
Списываются ли деньги за запросы с ошибкой?
Нет. Запрос, который закончился ошибкой, не списывается, в том числе наш 504, когда модель не начала отвечать за отведённое время.
Как ограничить расход одного ключа?
Заведите на проект или сотрудника свой ключ и задайте ему лимит в рублях и период. Когда лимит исчерпан, запросы этим ключом получают 402, остальные ключи работают. Расход по ключу виден в кабинете.
Что делать, если модель отвечает пустым текстом?
Обычно это рассуждающая модель, которой не хватило лимита: всё ушло в размышления. Признак: finish_reason: "length" при пустом content. Поставьте max_tokens от 512 или не передавайте его совсем.
Можно ли генерировать видео по API?
Да: POST /v1/videos ставит задачу, GET /v1/videos/{id} отдаёт статус, GET /v1/videos/{id}/content готовый mp4. Формат как у видео-API OpenAI, модели и допустимые длительности на карточках видеомоделей в каталоге. Ролик можно начать с картинки: input_reference станет первым кадром, last_frame последним.
Подойдут LangChain, LlamaIndex, n8n и другие библиотеки?
Да, если в них можно указать base URL для OpenAI: подставьте https://api.kosareva.cloud/v1 и свой ключ. Для клиентов в формате Anthropic адрес без /v1.
Где посмотреть, сколько стоил конкретный запрос?
В расходах личного кабинета. У текстовых моделей количество токенов приходит ещё и в поле usage ответа, а цена за миллион токенов указана на странице модели в каталоге.