Перейти к содержанию

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 (при недействительном ключе или недостатке средств — с текстовым сообщением об ошибке; при отсутствующем заголовке авторизации — с пустым телом). Подробнее формат и коды общих ошибок хаба описаны в общем справочнике и на странице «Лимиты и ограничения».