База знаний
Вопросы и ответы по AI API
Короткие точные ответы: ошибки, оплата, ключи, модели, интеграции и биллинг. Развёрнутые разборы — в гайдах и статьях.
Ошибки
- OpenAI API 401 invalid_api_key: что делать?
- Ошибка 402 insufficient_balance в AI API
- Ошибка 403 model_not_allowed: модель недоступна ключу
- 429 Too Many Requests: rate limit и что делать
- 503 provider_unavailable: модель временно недоступна
- X-Request-Id: зачем сохранять идентификатор запроса
- Таймаут и connection reset: запрос не доходит до AI API
- Streaming-ответ обрывается на середине: что делать?
- Model overloaded: модель перегружена — ждать или переключаться?
- Модель вернула пустой ответ: что проверить?
- Cursor Verify не проходит: как найти причину?
- Cursor пишет Model not found: что проверить?
- Gateway Timeout 504 от AI API: что делать?
- Пустой choices и content null в ответе API: что это?
Оплата и баланс
- Как оплатить AI API из России?
- Spend limit ключа: чем отличается от баланса
- Можно ли вернуть неизрасходованный баланс?
- Какая комиссия при пополнении баланса?
- Как платить за AI API команде или компании?
- Минимальная сумма пополнения баланса
- Есть ли автопополнение баланса?
- Где найти историю пополнений и квитанции?
- В какой валюте ведётся баланс — в долларах или рублях?
- Какими способами пополнить баланс из России?
- Чем агрегатор API отличается от посредника с картой?
- Как считается итог трат за месяц в AI API?
- Зачем отдельный ключ под эксперименты?
- Непонятное списание с баланса: что делать?
API-ключи
- Как создать API-ключ NormaHub?
- Как отозвать скомпрометированный API-ключ?
- Сколько API-ключей заводить и как их разделять?
- Почему нельзя встраивать API-ключ в браузер и приложение?
- Куда чаще всего утекают API-ключи, кроме кода?
- Как хранить ключ в переменных окружения?
- Почему ключ не видно в кабинете после создания?
- Можно ли ограничить API-ключ по IP?
- Как часто ротировать API-ключи?
- Как выдать API-доступ подрядчику безопасно?
- Нужен ли отдельный ключ для n8n?
- Нужен ли отдельный ключ для Telegram-бота?
- Что видно в истории запросов по ключу?
- Как удобно назвать API-ключи?
Модели
- Как выбрать модель под задачу?
- Где взять точный model ID?
- Как переключать модели без переписывания кода?
- Что такое контекстное окно и почему оно дорожает?
- Как работает кэширование входных токенов?
- Как тарифицируются image и video модели?
- Как выбрать max_tokens для запроса?
- Temperature и top_p: как настроить?
- Как получить ответ модели в JSON?
- Как писать system prompt?
- Флагман или младшая модель: когда что выбирать?
- Что такое reasoning-модель?
- Что такое мультимодальность: текст плюс картинки?
- Как следить за новыми моделями в каталоге?
Интеграции
- Какой base URL использовать для NormaHub?
- Как подключить свой API-ключ в Cursor?
- Как подключить AI к n8n через HTTP Request?
- Где держать ключ Telegram-бота на AI API?
- Как добавить NormaHub в OpenCode?
- Работает ли NormaHub с LangChain и LiteLLM?
- Пример curl-запроса к AI API
- Как настроить Postman для AI API?
- Webhook'и и retry: как принимать колбэки надёжно?
- Какие заголовки говорят о rate limit?
- Что делает Override Base URL в Cursor?
- Зачем в OpenCode параметр small_model?
- Webhook или polling для Telegram-бота: что выбрать?
- Как проверить endpoint AI API через curl?
Биллинг
- Формула стоимости AI-запроса
- Где смотреть usage и расходы по запросам?
- Считаются ли повторные запросы после ошибок?
- Почему счёт больше предварительной оценки?
- Как снизить счёт за AI API?
- Сколько стоит генерация изображений через API?
- Как не пропустить аномальный рост трат?
- Как выгрузить расходы для учёта?
- Как ограничить бюджет отдельного проекта?
- Как оценить стоимость перед запуском в прод?
- Как пользоваться калькулятором на странице моделей?
- Что значит топ-5 самых дешёвых моделей?
- Сколько стоит запрос в Cursor-сессии через API?
- Как посчитать бюджет на месяц для AI API?