Матрица эндпоинтов
Base URL:
text
https://api.rout.my/v1| Endpoint | Method | Тело | Ответ | Примечания |
|---|---|---|---|---|
GET /models | GET | нет | OpenAI-style список моделей | Сначала вызови его и скопируй точный ID модели. |
POST /chat/completions | POST | model, messages, опционально stream, tools, vision content | Chat completion или SSE stream | Основной вариант для OpenAI-compatible клиентов. |
POST /responses | POST | model, input, опционально tools/stream-like поля | Responses-style объект или stream | Для клиентов, которые ожидают Responses API shape. |
POST /embeddings | POST | model, input, опционально encoding_format | Список embedding vectors | Для поиска, RAG, кластеризации и semantic matching. |
POST /images/generations | POST | model, prompt, опционально n, size, quality, image_config | data[].url или data[].b64_json | Генерация изображения по одному prompt. |
POST /video/generations | POST | model, prompt, опциональные video поля | Ответ генерации видео | Возможности зависят от выбранной модели. |
GET https://api.rout.my/embed/image:{model} | GET | query params | Raw image bytes | Удобно для вставки generated images в страницы. Этот route находится вне /v1. |
POST /messages | POST | Anthropic-style messages body | Anthropic-compatible ответ | Для Anthropic-native клиентов. |
POST /compatible/v1beta/models/{model}:generateContent | POST | Gemini-style contents | Gemini-compatible ответ | Для Gemini-compatible клиентов. |
Compatibility Notes
- rout.my передает model-specific поля, если выбранный provider их поддерживает.
- Неизвестные поля могут игнорироваться или отклоняться в зависимости от endpoint family и provider behavior.
- Для browser tools держи ключ пользовательским. Не вшивай общий ключ в публичный frontend.
- Для retry используй exponential backoff на
429,500,502и503.