Обзор API

Основной API rout.my совместим с OpenAI. Большинству SDK нужен только custom base URL и rout.my API key.

https://api.rout.my/v1

Авторизация

Для OpenAI-compatible endpoints используйте bearer token:

Authorization: Bearer sk_your_key_here

Некоторые compatibility routes также принимают x-api-key или ?key=..., потому что отдельные клиенты ожидают именно такой формат. Для новых интеграций используйте bearer auth.

Семейства эндпоинтов

Endpoint	Method	Формат
/v1/models	GET	OpenAI-style model list.
/v1/chat/completions	POST	OpenAI Chat Completions.
/v1/responses	POST	OpenAI Responses-style request and stream shape.
/v1/embeddings	POST	OpenAI Embeddings.
/v1/images/generations	POST	OpenAI Images-style response.
/v1/video/generations	POST	OpenAI-ish video generation response.
/v1/messages	POST	Anthropic Messages-compatible route.
/v1/messages/count_tokens	POST	Anthropic Messages token-counting route.
/compatible/v1beta/models/{model}:generateContent	POST	Gemini-compatible route.
/embed/image:{model}	GET	Сырые байты изображения для страниц или чатов.

Минимальный запрос

curl https://api.rout.my/v1/chat/completions \
  -H "Authorization: Bearer $ROUTMY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.4",
    "messages": [
      { "role": "user", "content": "Hello." }
    ]
  }'

CORS

Публичные API endpoints отправляют permissive CORS headers для браузерных клиентов. Не кладите приватные API keys в публичный frontend, если только вы осознанно не хотите, чтобы каждый пользователь приносил свой ключ.

Формат ошибки

Успешные ответы нормализуются под семейство endpoint, которое вы вызвали. Ошибки возвращаются как JSON:

{
  "error": {
    "message": "Model is required",
    "type": "invalid_request_error",
    "code": "Bad Request"
  }
}

Подробнее: Ошибки.

Совместимость video

/v1/video/generations принимает единый формат video-запроса для text-to-video, image-to-video, reference-to-video, motion-control и video editing. Используйте общие поля вроде duration, resolution, aspect_ratio, audio, quality, negative_prompt, input_image, input_video, last_frame_image и reference_urls; rout.my сам мапит их в provider-specific Vercel AI Gateway options, если выбранная модель это поддерживает.

Полный список полей и примеры: Video.