OpenRouter-совместимый API
OpenRouter-совместимый API хаба предоставляет генерацию изображений и видео.
Адрес и авторизация
Базовый адрес — https://hub.coreinfra.ai/openrouter/api/v1. Передавайте ключ хаба в Authorization: Bearer sk-ci2-....
Описание полей запросов приведено в документации OpenRouter. Настройка клиента описана на странице «OpenRouter-совместимый API».
API методы
Пути в таблице указаны относительно базового адреса https://hub.coreinfra.ai/openrouter/api/v1. OPTIONS выполняет CORS preflight для того же пути и возвращает статус-код 204 без тела; ключ для preflight не нужен.
| Методы | Путь | Назначение |
|---|---|---|
GET, OPTIONS | /models | Список доступных моделей |
POST, OPTIONS | /images | Генерация изображений |
POST, OPTIONS | /videos | Создание задания генерации видео |
GET, OPTIONS | /videos/{jobId} | Статус задания генерации видео |
GET, OPTIONS | /videos/{jobId}/content | Скачивание видео |
Ответы и поток
Список моделей, генерация изображений без потока и операции со статусом заданий генерации видео используют JSON. Скачивание видео возвращает поток байтов.
Для изображений stream: true запрашивает SSE с Content-Type: text/event-stream. В data: приходит JSON с полем type: image_generation.partial_image, image_generation.text_chunk, image_generation.completed или error. Для некоторых моделей потоковый режим не поддерживается — в таких случаях хаб возвращает обычный JSON-ответ.
Когда в usage присутствуют данные о стоимости и сумма списания рассчитана, хаб возвращает стоимость запроса в рублях в поле usage.cost_rub (у изображений — в JSON-ответе и событии image_generation.completed, у видео — в ответе со статусом завершенного задания). Правила расчета описаны на страницах «Стоимость генерации изображений» и «Стоимость видео», цены — на странице «Тарифы».
Ошибки
Ошибки имеют формат OpenRouter:
{"error":{"code":400,"message":"Missing required parameter: 'model'."}}
Данный формат ошибок используется при проверке параметров медиазапроса. Ошибка авторизации или недостатка средств возвращает ответ со статус-кодом 400 (при недействительном ключе или недостатке средств — с текстовым сообщением об ошибке; при отсутствующем заголовке авторизации — с пустым телом). Подробнее формат и коды общих ошибок хаба описаны в общем справочнике и на странице «Лимиты и ограничения».
