POST Images Generations

Генерация изображений (OpenAI-совместимый API)

POST Images Generations

OpenAI-совместимый эндпоинт для генерации изображений.

Этот эндпоинт совместим с OpenAI SDK и подходит для быстрой миграции существующего кода. Если вы разрабатываете новый софт — рекомендуем использовать Media API, который предоставляет единый интерфейс для всех медиа-операций.

Параметры

Обязательные

Параметр	Тип	Описание
`model`	string	Модель для генерации
`prompt`	string	Текстовое описание изображения

Опциональные

Параметр	Тип	По умолчанию	Описание
`size`	string	auto	Размер изображения
`quality`	string	auto	Качество генерации
`response_format`	string	url	Формат ответа: url, b64_json
`style`	string	vivid	Стиль: vivid, natural (только DALL-E 3)
`user`	string	—	Идентификатор конечного пользователя

size

Размер генерируемого изображения:

Значение	Описание
`auto`	Провайдер сам определит размер (по умолчанию)
`256x256`	Маленький квадрат
`512x512`	Средний квадрат
`1024x1024`	Большой квадрат
`1536x1024`	Горизонтальный
`1024x1536`	Вертикальный
`1792x1024`	Широкий горизонтальный
`1024x1792`	Высокий вертикальный

quality

Качество генерации:

Значение	Описание
`auto`	Автоматический выбор (по умолчанию)
`low`	Низкое качество (быстрее)
`medium`	Среднее качество
`high`	Высокое качество
`standard`	Стандартное (для DALL-E)
`hd`	HD качество (для DALL-E 3)

Примеры

curl -X POST "https://api.usellm.ru/v1/images/generations" \
  -H "Authorization: Bearer <USELLM_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-1",
    "prompt": "Космический пейзаж с планетами",
    "size": "1024x1024",
    "quality": "high"
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://api.usellm.ru/v1",
    api_key="<USELLM_API_KEY>"
)

response = client.images.generate(
    model="openai/gpt-image-1",
    prompt="Футуристический город на закате",
    size="1792x1024",
    quality="high"
)

print(response.data[0].url)

Поведение при таймауте

Генерация выполняется синхронно с таймаутом 120 секунд.

Успешная генерация (до 120 сек)

Возвращается объект с результатом:

{
  "created": 1706123456,
  "data": [
    {
      "url": "https://cdn.usellm.ru/...",
      "revised_prompt": "Улучшенный промпт..."
    }
  ],
  "usage": {
    "input_tokens": 10,
    "output_tokens": 0,
    "total_tokens": 10,
    "cost_rub": 2.50,
    "cost": 2.50
  }
}

Таймаут (более 120 сек)

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

{
  "id": "gen_abc123...",
  "status": "pending",
  "model": "openai/gpt-image-1",
  "created": 1706123456
}

Используйте GET /v1/media/{id} для проверки статуса. Рекомендуется polling с интервалом 3-5 секунд.

Статусы генерации

Статус	Описание
`pending`	В очереди
`processing`	Генерация выполняется
`completed`	Готово
`failed`	Ошибка