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

OpenRouter-совместимый API

OpenRouter-совместимый API хаба позволяет генерировать изображения и видео через хаб без VPN с оплатой в рублях по ключу хаба.

1. Настройте адрес и ключ​

Укажите базовый адрес https://hub.coreinfra.ai/openrouter/api/v1 и подставьте ключ хаба sk-ci2-... в заголовок Authorization: Bearer.

Проверьте вызов через cURL:

export COREINFRA_API_KEY='sk-ci2-...'
curl https://hub.coreinfra.ai/openrouter/api/v1/images \
-H "Authorization: Bearer $COREINFRA_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"model":"bytedance-seed/seedream-5-0-flash","prompt":"Красный круг на белом фоне"}'

В ответе изображение приходит в data[].b64_json, его тип — в data[].media_type.

Отличия от API OpenRouter​

Полное описание параметров запросов приведено в документации OpenRouter. При работе через хаб действуют следующие отличия:

  • Этот адрес API не поддерживает текстовые модели. Для текстовых запросов используйте OpenAI-совместимый API.
  • Поле user и настройки маршрутизации внутри объекта provider (кроме provider.options) игнорируются.
  • У видео параметр callback_url отсутствует: проверяйте состояние задания опросом GET /videos/{jobId}. Для получения статуса и скачивания видео используйте ключ хаба, с помощью которого было создано задание. До завершения задания скачивание возвращает ошибку со статус-кодом 409.
  • Входные изображения передавайте в кодировке base64 (data:image/...;base64,...). Ссылки на внешние ресурсы отклоняются со статус-кодом 400.
  • Для некоторых моделей изображений stream: true не поддерживается — в таких случаях хаб возвращает обычный JSON-ответ.
  • Когда ответ содержит данные о стоимости и сумма списания рассчитана, хаб возвращает стоимость запроса в рублях в поле usage.cost_rub: для изображений — в JSON-ответе и в завершающем событии потока image_generation.completed (в промежуточных событиях image_generation.partial_image и image_generation.text_chunk поле отсутствует), а для видео — в объекте завершенного задания (пока задание находится в статусе pending или in_progress либо если данные о стоимости в usage отсутствуют, поле не добавляется). Фактическое списание по каждому запросу всегда доступно в аналитике; правила оплаты описаны на страницах «Стоимость генерации изображений» и «Стоимость видео».

Что доступно​

Доступны следующие API методы относительно базового адреса https://hub.coreinfra.ai/openrouter/api/v1:

МетодПутьНазначение и справочник
GET/modelsСписок доступных моделей
POST/imagesСоздание изображений
POST/videosСоздание видео
GET/videos/{jobId}Состояние видео
GET/videos/{jobId}/contentСкачивание видео

Получите список доступных моделей запросом GET /models с тем же Bearer-ключом. Возможности моделей приведены в каталоге моделей, цены — на странице «Тарифы».

Ошибки​

Неизвестная или неподходящая для этого API метода модель возвращает ошибку со статус-кодом 400, а обращение к чужому или несуществующему видеозаданию — со статус-кодом 404. Формат и примеры ошибок приведены в справочнике OpenRouter API, а общие ошибки авторизации, баланса и лимитов расходов — в общем справочнике API и на странице «Лимиты и ограничения».