OpenAI-совместимый API: несколько ИИ-моделей через один URL

Что означает OpenAI-compatible

Совместимый API повторяет привычную структуру запросов Chat Completions: приложение передаёт model, messages и параметры генерации, а получает ответ с choices и usage. Благодаря этому многие SDK, IDE и агенты подключаются заменой base URL и ключа.

Совместимость не означает, что все модели становятся одинаковыми. Размер контекста, поддержка инструментов, reasoning и мультимодальность по-прежнему зависят от выбранной модели.

Что меняется в приложении

• Base URL указывает на https://apirouter.store/v1.
• API-ключ создаётся в личном кабинете API Router.
• В поле model передаётся точный ID из актуального каталога.
• Формат messages и обработка стандартного ответа остаются привычными.

Когда нужен нативный формат

OpenAI-compatible подходит большинству клиентов. Claude native нужен приложениям, которые формируют Anthropic Messages и используют заголовки x-api-key и anthropic-version. Gemini native нужен клиентам с форматом contents и моделью в URL. Выбирать нативный протокол стоит только тогда, когда этого требует конкретный SDK или функция.

Как переносить production-нагрузку

• Сначала проверьте короткий нестриминговый запрос.
• Затем протестируйте streaming, tool calls и длинный контекст, если они используются.
• Создайте отдельный ключ для каждого приложения.
• Обрабатывайте 429 и временные 5xx повтором с экспоненциальной задержкой и jitter.
• Сверьте фактические input, output и cache-read токены в истории кабинета.