02 · гайд

Аутентификация

Все запросы авторизуются ключом в заголовке:

Authorization: Bearer sk-ВАШ_КЛЮЧ

Ключи создаются и отключаются в кабинете (Студия → «API Ключи»); первый выпускается автоматически при первом входе. Ключей может быть до 30 — например, отдельный на каждый проект: у каждого виден собственный расход, а отключение одного не трогает остальные. Полный ключ показывается один раз — при создании.

Лимиты ключа

Отдельного потолка у ключа нет — расход любого ключа ограничен общим балансом аккаунта: кончились токены, запросы перестают проходить.

Безопасность

Ключ — это деньги. Не публикуйте его в клиентском коде, репозиториях и логах. Утёк — отключите или удалите ключ в кабинете и создайте новый: старый перестаёт работать сразу.

Ошибки авторизации: 401 — ключ не передан, не существует или отключён; 403 — аккаунт заблокирован либо на балансе не хватает токенов (в теле ответа — код insufficient_user_quota).