OpenAI-compatible API: как проверить endpoint, лимиты и первый запрос

#ai #programming

Короткий путь к первому запросу

При подключении ChatGPT API к прототипу чаще всего ломается не модель, а конфигурация: лишний /v1, неверный model ID, потерянный заголовок Authorization или неожиданный лимит тарифа.

Ниже — небольшой чек-лист для Python, Node.js, curl и других клиентов с OpenAI-compatible интерфейсом.

1. Зафиксируйте четыре значения

Перед запуском запишите:

базовый URL;
имя переменной с API key;
точный model ID из доступного каталога;
квоту и срок действия выбранного тарифа.

Если библиотека сама добавляет /chat/completions и /models, ей обычно нужен корневой адрес:

https://api.ai-router.dev

Если клиент ожидает OpenAI SDK Base URL и сам формирует /v1/chat/completions, используйте:

https://api.ai-router.dev/v1

Не добавляйте /v1 дважды: путь /v1/v1/chat/completions даст 404 даже при правильном ключе.

2. Проверьте каталог и авторизацию

Храните ключ только в переменной окружения или секрет-хранилище:

export AI_ROUTER_API_KEY="замените-на-свой-ключ"

curl https://api.ai-router.dev/models \
  -H "Authorization: Bearer $AI_ROUTER_API_KEY"

Смотрите на фактическое поле data[].id. Не угадывайте имя модели по названию тарифа и не вставляйте ключ в репозиторий, issue, URL или frontend bundle.

3. Сделайте минимальный smoke-test

curl https://api.ai-router.dev/chat/completions \
  -H "Authorization: Bearer $AI_ROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [
      {"role": "user", "content": "Ответь одним предложением: соединение работает?"}
    ],
    "max_tokens": 64
  }'

В рабочем приложении используйте model ID из каталога, доступного именно вашему ключу и тарифу.

4. Обрабатывайте ошибки по классам

401 — проверьте ключ и заголовок Authorization.
404 — сравните фактический URL с правилом /v1.
429 — проверьте квоту, баланс, RPM/TPM и Retry-After; ограничьте параллелизм, а не запускайте бесконечный retry.
Обрыв stream — не доказывает, что запрос не был принят. Повторяйте только операции, для которых replay действительно безопасен.

После первого запроса откройте usage, баланс и срок действия в кабинете. Начинайте с небольшого дневного или недельного объёма, чтобы проверить именно свой workflow.

5. Что проверить перед production

Каталог возвращает ожидаемый model ID.
Короткий запрос завершается успешным ответом.
401/404/429 попадают в понятные метрики.
Таймауты и обрывы не вызывают небезопасные повторы.
Для разных приложений используются отдельные ключи.
Квота и срок тарифа соответствуют реальной нагрузке.

AI-ROUTER в этом примере — независимый ChatGPT API relay с OpenAI-compatible способом вызова, а не официальный сервис OpenAI. Актуальные русскоязычные примеры endpoint и первого запроса: https://ai-router.dev/ru/docs/getting-started/first-request/?utm_source=devto&utm_medium=content&utm_campaign=ru_api_first_request_202608

Если у вас есть другой совместимый клиент, полезно начать с тех же двух проверок: какой URL он формирует и какой model ID реально видит ваш API key.

DEV Community