Images

Используйте POST /v1/images/generations для OpenAI-style генерации изображений.

POST https://api.rout.my/v1/images/generations

Запрос

curl https://api.rout.my/v1/images/generations \
  -H "Authorization: Bearer $ROUTMY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "provider/image-model-id",
    "prompt": "A clean product photo of a translucent blue cube on a white table",
    "n": 1,
    "image_config": {
      "aspect_ratio": "1:1",
      "image_size": "1K"
    }
  }'

Поля запроса

Поле	Тип	Обязательное	Примечания
model	string	Да	Точный image model ID из /v1/models.
prompt	string	Да	Текстовое описание изображения.
n	integer	Нет	Количество изображений. Если опущено, используется поведение провайдера.
size	string	Нет	OpenAI-style size, если модель поддерживает.
quality	string	Нет	Quality hint, если модель поддерживает.
style	string	Нет	Style hint, если модель поддерживает.
user	string	Нет	Client-side user identifier.
image_config	object	Нет	Provider-neutral настройки изображения.

image_config

Поле	Тип	Примечания
aspect_ratio	string	Частые значения: 1:1, 16:9, 9:16, 4:3, 3:4, 4:5, 5:4, 21:9.
image_size	string	Частые значения: 1K, 2K, 4K. Значение пробрасывается провайдеру, если поддерживается.

Ответ

Ответ использует OpenAI-style image generation shape. В зависимости от upstream provider, изображение может прийти как URL или base64 payload.

{
  "created": 1744000000,
  "data": [
    {
      "url": "https://example.com/generated-image.png",
      "revised_prompt": "A clean product photo of a translucent blue cube..."
    }
  ]
}

или:

{
  "created": 1744000000,
  "data": [
    {
      "b64_json": "iVBORw0KGgo..."
    }
  ]
}

Клиенту стоит обрабатывать и url, и b64_json.

Расход квоты

Image generation списывает за каждое сгенерированное изображение, умножая на token_multiplier модели:

Requested size	Base quota units per image
empty, 1K, 2K или другие non-4K значения	5,000
4K	12,500

Provider-reported usage может использоваться внутри, если доступен. Public response не раскрывает billing metadata.

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

Некоторые image-capable chat models используют /v1/chat/completions с modalities: ["image", "text"]. Формат описан в Chat Completions.