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

POST /images — генерация изображений

POST /openrouter/api/v1/images создает изображения по тексту и референсам для моделей изображений из списка медиамоделей. Поля запроса описаны в документации OpenRouter.

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":"..."}]}

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

Поле user и настройки маршрутизации в provider (кроме provider.options) игнорируются.

В изображениях из input_references поле image_url.url должно содержать встроенное изображение в кодировке base64 (data:image/...;base64,...). Ссылки на внешние ресурсы отклоняются со статус-кодом 400.

Недоступная модель возвращает ошибку со статус-кодом 400.

Для некоторых моделей stream: true не поддерживается — в таких случаях хаб возвращает обычный JSON-ответ. Формат потока описан в разделе API.

Перед вызовом хаб резервирует стоимость запрошенного числа изображений n, а при завершении списывает фактическую стоимость (правила расчета — на странице «Стоимость генерации изображений»). Отключение клиента не останавливает обработку уже запущенного запроса.

Когда в usage присутствуют данные о стоимости и сумма списания рассчитана, хаб возвращает стоимость запроса в рублях в поле usage.cost_rub в JSON-ответе и в завершающем событии потока image_generation.completed (в промежуточных событиях потока или при отсутствии данных о стоимости в usage поле не добавляется). Цены опубликованы на странице «Тарифы».

Ошибки​

Статус-кодУсловие
400Отсутствующая или недоступная для этого API метода модель
400Некорректный JSON или ссылка на внешний ресурс вместо изображения в кодировке base64
502Ошибка на стороне провайдера модели при выполнении запроса

Общие ошибки ключа, баланса и лимитов — в справочнике API; формат ошибок — в разделе этого API.