API-ключи моделей и лимиты расходов

Как создать ключ для модели

Сначала откройте каталог и проверьте статус, опубликованный тариф и доступные протоколы модели. Наличие карточки в каталоге ещё не означает, что запросы уже доступны. У модели со статусом «Подключается» параметры проверяются перед публикацией.

1. В кабинете откройте «API-ключи» и выберите создание ключа.
2. Выберите одну опубликованную модель, укажите название и накопительный лимит в USD.
3. Сохраните показанный секрет в защищённом хранилище своего сервера. Полное значение показывается один раз.
4. Используйте точный ID модели из каталога и протокол, указанный в её карточке.

Чем лимит ключа отличается от баланса

Лимит — это ограничение расходов, а не пополнение. Если в кошельке меньше средств, чем осталось по лимиту ключа, доступный бюджет всё равно ограничен кошельком. Несколько ключей одного аккаунта используют общий кошелёк; их лимиты не складываются в дополнительный баланс.

При проверке лимита учитываются уже списанные суммы и средства, зарезервированные под незавершённые запросы. Поэтому одновременно запущенные запросы не должны ориентироваться только на сумму завершённых операций. Состояние расходов и резервов видно в кабинете.

Как разделить приложения и расходы

Создавайте отдельные ключи для разных приложений, окружений или задач. Так в истории проще найти источник запроса, сверить расходы и отозвать доступ только у одного приложения. Для доступа к другой модели создайте новый ключ, закреплённый за ней.

Ключи предназначены для серверного использования. Не помещайте секрет в публичный JavaScript, мобильную сборку или репозиторий. Приложение пользователя должно обращаться к вашему серверу, а сервер — к API с ключом из переменной окружения или хранилища секретов.

Что происходит при ротации или отзыве

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

Если секрет мог попасть к посторонним, отзовите ключ и проверьте историю запросов. Перед повтором запроса с неизвестным результатом сначала выясните состояние исходной операции: смена ключа не отменяет уже отправленную генерацию.