Матрица эндпоинтов

Base URL:

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 /images/edits	POST	model, prompt, images или multipart image, опциональные edit fields	data[].url или data[].b64_json	OpenAI-style редактирование изображений через OpenAI-compatible providers.
POST /video/generations	POST	model, prompt, опциональные unified video fields (duration, resolution, audio, quality, media inputs)	Ответ генерации видео	rout.my мапит единые поля в provider-specific video options, если модель их поддерживает.
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.