ProxyAPI предоставляет удобный способ взаимодействия с моделями OpenRouter, поддерживая оригинальный API и формат запросов и ответов.
Для отправки запросов к OpenRouter через ProxyAPI используйте базовый путь:
https://api.proxyapi.ru/openrouter/v1
Вы можете выбрать любую модель из списка поддерживаемых OpenRouter.
Важно: Модели ведущих провайдеров — OpenAI, Anthropic и Google — поддерживаются в ProxyAPI отдельно и не доступны через OpenRouter ни для одного типа контента (текст, изображения, видео). Мы обеспечиваем прямую совместимость с оригинальными API этих провайдеров, внимательно следим за обновлениями, поддерживаем пулы аккаунтов и продвинутую ротацию трафика для предотвращения блокировок. Используйте соответствующие прямые API этих провайдеров.
OpenRouter автоматически выбирает наиболее выгодного провайдера для каждой модели:
- Сначала используется самый дешевый вариант.
- Если у него возникают проблемы с доступностью, OpenRouter переключается на более дорогого провайдера.
Стоимость запроса зависит от выбранного провайдера и возвращается в ответе в поле usage.cost (оригинальная стоимость в USD). Это работает одинаково для всех типов контента — текста, embeddings, изображений и видео.
ProxyAPI конвертирует сумму в рубли и добавляет 50% комиссии, которая включает:
- 25% — комиссия OpenRouter и налоги в стране назначения.
- 25% — комиссия ProxyAPI.
OpenRouter использует API, совместимое с OpenAI Chat Completions, что позволяет работать через стандартные SDK.
POST https://api.proxyapi.ru/openrouter/v1/chat/completions
curl "https://api.proxyapi.ru/openrouter/v1/chat/completions" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer <КЛЮЧ>" \ -d '{ "model": "mistralai/mistral-medium-3.1", "messages": [ { "role": "user", "content": "Привет!" } ] }'
POST https://api.proxyapi.ru/openrouter/v1/embeddings — создать embedding GET https://api.proxyapi.ru/openrouter/v1/embeddings/models — список доступных моделей
curl "https://api.proxyapi.ru/openrouter/v1/embeddings" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer <КЛЮЧ>" \ -d '{ "model": "mistralai/mistral-embed-2312", "input": "Привет, мир!" }'
Генерация изображений работает через стандартный /chat/completions. В тело запроса необходимо добавить параметр modalities:
["image"]— для моделей, которые генерируют только изображения (Flux, Sourceful, Seedream и другие)["image", "text"]— для мультимодальных моделей, которые возвращают и текст, и изображение
Полный список поддерживаемых моделей доступен на странице Image Generation Models.
Примечание для TypeScript/JavaScript: Параметр modalities отсутствует в стандартных типах OpenAI SDK, поэтому в примере используется нативный fetch. При использовании OpenAI SDK передайте его через extra_body (Python) или напрямую в теле запроса.
curl "https://api.proxyapi.ru/openrouter/v1/chat/completions" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer <КЛЮЧ>" \ -d '{ "model": "black-forest-labs/flux.2-klein-4b", "modalities": ["image"], "messages": [ { "role": "user", "content": "Рыжий кот на подоконнике" } ] }'
Сгенерированные изображения возвращаются в поле choices[0].message.images в виде base64 data URL:
{ "choices": [{ "message": { "role": "assistant", "content": null, "images": [ { "type": "image_url", "image_url": { "url": "data:image/png;base64,iVBORw0KGgo..." } } ] } }] }
Генерация видео работает асинхронно: вы отправляете запрос, получаете идентификатор задачи, а затем опрашиваете статус до завершения.
Почему не SDK? Генерация видео через OpenRouter использует собственный API (/videos), несовместимый с OpenAI SDK. Формат запросов и ответов отличается от OpenAI Videos API (Sora), поэтому для работы с видео необходимо использовать HTTP-запросы напрямую.
Среди популярных моделей для генерации видео:
- Kling v3.0 Pro (
kwaivgi/kling-v3.0-pro) — премиальная модель от Kuaishou с высоким качеством, клипы от 3 до 15 секунд с генерацией аудио - Kling v3.0 Standard (
kwaivgi/kling-v3.0-std) — стандартная версия Kling, баланс качества и стоимости - Seedance 2.0 (
bytedance/seedance-2.0) — модель от ByteDance с сильным сохранением стиля и движения камеры - Wan 2.6 (
alibaba/wan-2.6) — модель от Alibaba с поддержкой синхронизации звука и видео до 1080p - Hailuo 2.3 (
minimax/hailuo-2.3) — модель от MiniMax с реалистичной анимацией персонажей
Полный и актуальный список доступен через эндпоинт /openrouter/v1/videos/models.
POST https://api.proxyapi.ru/openrouter/v1/videos — создать задачу на генерацию GET https://api.proxyapi.ru/openrouter/v1/videos/{id} — проверить статус задачи GET https://api.proxyapi.ru/openrouter/v1/videos/{id}/content — скачать готовое видео GET https://api.proxyapi.ru/openrouter/v1/videos/models — список доступных моделей
Отправьте POST-запрос с указанием модели и промпта. Параметр duration (длительность в секундах) опционален — по умолчанию 5 секунд.
curl -X POST "https://api.proxyapi.ru/openrouter/v1/videos" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer <КЛЮЧ>" \ -d '{ "model": "kwaivgi/kling-v3.0-pro", "prompt": "Кинематографичный трекинговый кадр: камера плавно следует за поездом, который мчится по горному мосту на рассвете. Внизу — река в утреннем тумане, лучи солнца пробиваются сквозь облака", "duration": 10 }'
В ответе вы получите идентификатор задачи и URL для опроса статуса:
{ "id": "job-abc123", "status": "pending", "polling_url": "https://api.proxyapi.ru/openrouter/v1/videos/job-abc123" }
Опрашивайте polling_url (или GET /openrouter/v1/videos/{id}) до тех пор, пока status не станет completed или failed. Генерация видео обычно занимает от 30 секунд до нескольких минут в зависимости от модели и длительности.
curl "https://api.proxyapi.ru/openrouter/v1/videos/job-abc123" \ -H "Authorization: Bearer <КЛЮЧ>"
Когда статус задачи completed, скачайте результат:
GET https://api.proxyapi.ru/openrouter/v1/videos/{id}/content
