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

Генерация изображений через AI-модели. API совместимо с OpenAI Images API и предоставляет дополнительные возможности для работы с моделями ru-openrouter.ru.

Базовый URL: https://api.ru-openrouter.ru/v1/

Модели для генерации изображений

GET /v1/images/models

Список image-моделей, доступных для генерации.

curl "https://api.ru-openrouter.ru/v1/images/models" \
  -H "Authorization: Bearer sk_ваш_api_ключ"

Ответ:

{
  "object": "list",
  "data": [
    {
      "id": "bytedance-seed/seedream-4.5",
      "object": "model",
      "created": 1692901234,
      "owned_by": "bytedance-seed",
      "capabilities": {
        "can_generate_image": true,
        "can_understand_image": true,
        "input_modalities": ["text"],
        "output_modalities": ["image"]
      },
      "pricing": {
        "prompt": "0.000000000",
        "completion": "0.050000000",
        "pricing_type": "tokens",
        "image": "0.001000000",
        "image_output": "0.050000000",
        "currency": "RUB"
      },
      "context_length": 4096,
      "description": "A text-to-image model.",
      "supported_parameters": {
        "resolution": {"type": "enum", "values": ["1K", "2K", "4K"]},
        "seed": {"type": "boolean"}
      }
    }
  ]
}

GET /v1/models?filter=image

Альтернативный способ получения списка image-моделей через общий эндпоинт моделей:

curl "https://api.ru-openrouter.ru/v1/models?filter=image" \
  -H "Authorization: Bearer sk_ваш_api_ключ"

Поддерживаемые параметры моделей

Поле supported_parameters описывает, какие параметры доступны для конкретной модели:

Если параметр отсутствует в supported_parameters — он не поддерживается моделью.

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

POST /v1/images/generations
POST /v1/images

Оба эндпоинта идентичны по функциональности. POST /v1/images/generations совместим с OpenAI API, POST /v1/images использует native Images API нашего сервиса.

Обязательные параметры

Опциональные параметры

Параметры image_config

Параметры aspect_ratio и image_size также можно передавать на верхнем уровне запроса — они будут переданы провайдеру напрямую.

Провайдер-специфичные параметры

Эти параметры передаются провайдеру напрямую (сквозной проброс). Поддержка зависит от конкретной модели и провайдера:

Примеры

Базовая генерация:

curl -X POST "https://api.ru-openrouter.ru/v1/images/generations" \
  -H "Authorization: Bearer sk_ваш_api_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance-seed/seedream-4.5",
    "prompt": "красная панда-космонавт в открытом космосе, студийное освещение"
  }'

Несколько изображений с соотношением сторон:

curl -X POST "https://api.ru-openrouter.ru/v1/images/generations" \
  -H "Authorization: Bearer sk_ваш_api_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance-seed/seedream-4.5",
    "prompt": "горный пейзаж, закат",
    "n": 2,
    "image_config": {
      "aspect_ratio": "16:9",
      "image_size": "2K"
    }
  }'

Через legacy OpenAI параметр size:

curl -X POST "https://api.ru-openrouter.ru/v1/images/generations" \
  -H "Authorization: Bearer sk_ваш_api_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/dall-e-3",
    "prompt": "кот в космосе, цифровой арт",
    "n": 1,
    "size": "1024x1024"
  }'

Image-to-image (с референсным изображением):

curl -X POST "https://api.ru-openrouter.ru/v1/images/generations" \
  -H "Authorization: Bearer sk_ваш_api_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-1",
    "prompt": "сделай эту сцену в стиле акварели",
    "input_references": [
      {
        "type": "image_url",
        "image_url": {
          "url": "https://example.com/photo.jpg"
        }
      }
    ]
  }'

С base64 выводом:

curl -X POST "https://api.ru-openrouter.ru/v1/images/generations" \
  -H "Authorization: Bearer sk_ваш_api_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance-seed/seedream-4.5",
    "prompt": "абстрактная картина",
    "response_format": "b64_json"
  }'

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

{
  "id": "gen-xxxxxxxxxxxx",
  "object": "list",
  "created": 1748372400,
  "model": "bytedance-seed/seedream-4.5",
  "data": [
    {
      "url": "data:image/png;base64,",
      "revised_prompt": "A red panda astronaut floating in space, studio lighting"
    }
  ],
  "usage": {
    "prompt_tokens": 16,
    "completion_tokens": 4175,
    "total_tokens": 4191,
    "cost": 0.05
  },
  "provider": "Bytedance"
}

Формат изображения в ответе

При response_format: url (по умолчанию) возвращается data URL с MIME-типом, соответствующим output_format:

При response_format: b64_json возвращается raw base64-строка в поле b64_json.

Роутинг провайдеров

Если модель доступна через нескольких провайдеров, можно управлять выбором через параметр provider:

{
  "model": "google/gemini-2.5-flash-image",
  "prompt": "красная панда-космонавт в космосе",
  "provider": {
    "only": ["google-ai-studio"],
    "allow_fallbacks": false
  }
}

Параметры передаются провайдеру напрямую. Поддержка специфических опций зависит от модели.

Ограничения

• Streaming не поддерживается для генерации изображений. Параметр stream: true вернёт ошибку 400 Bad Request.
• Максимальный размер тела запроса: 10 MB
• Максимальное количество изображений за один запрос: 10 (n: 1–10)
• Все запросы требуют аутентификации через заголовок Authorization: Bearer sk_ваш_api_ключ

Ошибки