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 и на странице «Лимиты и ограничения».
