API-ключи и оплата
API-ключ kosareva.cloud создаётся в личном кабинете и открывает весь каталог моделей. Удобнее завести свой ключ на каждый проект: у него будет свой лимит и своя строка в расходах.
Как создать ключ
В кабинете откройте раздел «API-ключи» и нажмите «Создать ключ». Ключ вида sk-... работает и для формата OpenAI, и для формата Anthropic. Полный ключ потом можно скопировать в списке кнопкой «Копировать».
Лимит в рублях
В окне ключа задайте лимит расходов в рублях и период: день, неделя, месяц или без сброса. Ноль значит, что лимита нет.
- Когда лимит исчерпан, запросы этим ключом получают ответ 402 «Достигнут лимит ключа». Остальные ключи продолжают работать.
- Расход по каждому ключу виден в кабинете. Через API кабинета доступны лимит ключа и общий расход баланса.
Только модели в РФ
С этой галочкой ключ работает лишь с моделями, которые обрабатываются на серверах в России: GigaChat, YandexGPT, Алиса, Qwen и другие с пометкой «Модель в РФ» в каталоге. Запрос /v1/models покажет только их.
Пополнение
Физлица платят картой или через СБП от 50 ₽. Юрлица платят по счёту, его можно выставить в разделе «Пополнение баланса». Абонентской платы нет.
Как списываются деньги
- Текстовые модели считаются по токенам, по цене из каталога.
- Картинки, озвучка, видео и музыка считаются по своим единицам, цена указана на странице модели.
- Запрос, который закончился ошибкой, не списывается.
- Когда баланс в нуле, запросы блокируются с ответом 402.
Закрывающие документы
Юрлицо получает договор, счёт, акт и инвойс. Оплата в рублях банковским переводом, обмен документами через ЭДО.
Советы по ключам
- Заводите отдельный ключ на каждый проект: виден расход по направлениям, а скомпрометированный ключ можно отозвать, не задев остальные.
- Храните ключ в переменных окружения, не в коде и не в репозитории.
- Агенту, который работает сам, ставьте лимит в рублях: неудачная ночь обойдётся в заранее известную сумму.