Генерация изображений

OpenAI-совместимый Images API, параметры запросов и обработка ответов

Для image-only моделей используйте отдельный Images API. Генерация выполняется синхронно, а готовое изображение возвращается как base64 в поле data[].b64_json.

Endpoint

POST
/v1/images/generations

Канонический OpenAI-совместимый путь

POST
/images/generations

Совместимый путь без префикса /v1

POST
/v1/images

Legacy/native alias; сохранён для обратной совместимости

POST
/images

Legacy alias без префикса /v1

Нужный scope
API-ключ должен иметь scope gateway:write или admin:*. Если у ключа задан allowlist моделей, добавьте в него точный ID image-модели.

Пример запроса

bash
curl -X POST "https://api.kodikrouter.ru/v1/images/generations" \
  -H "Authorization: Bearer $KODIK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen/qwen-image-3-pro",
    "prompt": "Кинематографичный вид Москвы в синий час",
    "n": 1,
    "size": "1024x1024",
    "response_format": "b64_json"
  }'

Параметры

modelreq
string
Точный ID модели с API surface images
promptreq
string
Описание изображения, до 100 000 символов
n
integer
Количество изображений, от 1 до 10
size
string
Размер, поддерживаемый моделью, например 1024x1024
aspect_ratio
string
Соотношение сторон, например 1:1 или 16:9
response_format
b64_json
Можно не передавать; поддерживается только b64_json
seed
integer
Seed для воспроизводимости, если модель его поддерживает
quality
string
Качество генерации; допустимые значения зависят от модели

Дополнительно поддерживаются resolution, output_format, background, output_compression, moderation, input_references и provider. Конкретные возможности зависят от выбранной модели.

Формат ответа

json
{
  "created": 1748372400,
  "data": [
    { "b64_json": "<base64-encoded-image>" }
  ],
  "usage": {
    "prompt_tokens": 0,
    "completion_tokens": 4175,
    "total_tokens": 4175,
    "cost": 0.04
  }
}
Текущие ограничения
Формат ответа через URL и streaming-превью пока не поддерживаются. Используйте b64_json или не передавайте response_format — результат всё равно придёт в base64.

Типовые ошибки

Model must use the 'images' API surface

Image-only модель отправлена в /chat/completions. Отправьте image-модель в /images/generations, а для /chat/completions используйте модель с API surface chat.

Not Found

Проверьте Base URL: он должен быть ровно https://api.kodikrouter.ru/v1. Полный путь вручную в это поле добавлять не нужно.

Server Connection Error

Повторите запрос через cURL и проверьте сетевую доступность API. Убедитесь, что у ключа есть scope gateway:write, модель разрешена allowlist-ом, а на балансе достаточно средств.