GetRouterДокументация
  • Русский

    • Базовый URL и эндпоинты

    Для OpenAI-совместимых SDK и инструментов используйте следующий базовый URL:

    https://getrouter.ai/v1

    Для прямых HTTP-запросов добавляйте путь нужного эндпоинта из таблицы ниже.

    Распространённые эндпоинты

    ВозможностьМетодПолный эндпоинт
    Список моделей в формате OpenAIGEThttps://getrouter.ai/v1/models
    Chat CompletionsPOSThttps://getrouter.ai/v1/chat/completions
    ResponsesPOSThttps://getrouter.ai/v1/responses
    Сжатие контекста ResponsesPOSThttps://getrouter.ai/v1/responses/compact
    ЭмбеддингиPOSThttps://getrouter.ai/v1/embeddings
    Генерация изображенийPOSThttps://getrouter.ai/v1/images/generations
    Редактирование изображенийPOSThttps://getrouter.ai/v1/images/edits
    Распознавание аудиоPOSThttps://getrouter.ai/v1/audio/transcriptions
    Перевод аудиоPOSThttps://getrouter.ai/v1/audio/translations
    Синтез речиPOSThttps://getrouter.ai/v1/audio/speech
    Создание задачи генерации видеоPOSThttps://getrouter.ai/v1/videos
    Статус задачи генерации видеоGEThttps://getrouter.ai/v1/videos/{task_id}
    ПереранжированиеPOSThttps://getrouter.ai/v1/rerank
    Claude MessagesPOSThttps://getrouter.ai/v1/messages
    Модели в формате GeminiGEThttps://getrouter.ai/v1beta/models
    Gemini generateContentPOSThttps://getrouter.ai/v1beta/models/{model}:generateContent

    Базовый URL и полный эндпоинт

    SDK обычно запрашивают базовый URL и самостоятельно добавляют путь операции:

    Базовый URL, указанный в OpenAI SDK:
https://getrouter.ai/v1

SDK отправляет запрос на адрес:
https://getrouter.ai/v1/chat/completions

    Некоторые инструменты, напротив, запрашивают полный эндпоинт. Прежде чем вручную добавлять /chat/completions, /responses или /messages, проверьте название поля и руководство по интеграции.

    Избегайте дублирования путей

    Дублирование пути — распространённая причина ошибок 404 Not Found.

    Правильный базовый URL OpenAI:
https://getrouter.ai/v1

Неправильно, если инструмент уже добавляет /v1:
https://getrouter.ai/v1/v1

Неправильно, если инструмент уже добавляет /chat/completions:
https://getrouter.ai/v1/chat/completions/chat/completions
    Tip

    Если в инструменте есть отдельные поля API Host, API Version и Endpoint, следуйте специальному руководству по интеграции для этого инструмента, а не пытайтесь угадать, какой путь он добавляет.

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

    Если в руководстве по интеграции не указано иное, отправляйте:

    Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

    Для multipart-эндпоинтов, например распознавания аудио и создания видео, граница Content-Type задаётся автоматически при использовании curl -F или SDK.

    Дальнейшие действия