Частые вопросы об API

Частые вопросы о вызовах API. Найдите свой симптом, затем перейдите по ссылкам за подробностями.

Получаете 401 Unauthorized?

• Неверный ключ: убедитесь, что используете полный ключ, сохранённый при создании (запись в списке с маской — это не полный ключ);
• Ключ удалён или истёк: проверьте его статус на странице «API-ключи» и при необходимости создайте новый;
• Ошибка в заголовке: протокол, совместимый с OpenAI, ожидает Authorization: Bearer <key> — не опускайте префикс Bearer ;
• Подробнее в разделе Аутентификация.

Ошибка «Model not found»?

• Опечатка в ID модели — скопируйте точный ID из каталога моделей, не вводите его вручную;
• Модель отсутствует на платформе или сейчас недоступна — проверьте, что карточка модели есть в каталоге и доступна.

Тайм-ауты или медленные ответы?

• Запросы с длинным контекстом / длинным выводом по своей природе медленнее; проверьте, не задан ли max_tokens без необходимости слишком большим;
• Настройте разумные тайм-ауты на клиенте и повторы с экспоненциальной задержкой;
• Для интерактивных интерфейсов используйте "stream": true — первые байты приходят раньше, и воспринимаемая задержка снижается.

Частые 429?

Вы упираетесь в ограничение частоты запросов. Снизьте параллелизм, добавьте интервалы задержки; при постоянной высокой нагрузке обратитесь к платформе по поводу квот. См. Коды ошибок.

Пустые или обрезанные ответы?

• finish_reason равен length: ответ упёрся в лимит max_tokens — увеличьте его;
• Проверьте, что ни одна запись в messages не содержит пустой content;
• Некоторые модели предъявляют требования к формату ввода (например, к формату изображений) — см. примечания в карточке модели.

Как убедиться, что вызов действительно прошёл?

Две проверки: HTTP 200 и наличие choices / usage в ответе; а также соответствующая запись (с расходом токенов и стоимостью) на странице журналов в консоли. Если оба совпадают, цепочка работает.