POST Images Generations
Генерация изображений (OpenAI-совместимый API)
/v2/images/generations. При использовании OpenAI SDK с base_url="https://polza.ai/api/v1" запросы автоматически направляются на правильный путь.Параметры
Обязательные
Опциональные
size
Размер генерируемого изображения:quality
Качество генерации:Примеры
Поведение при таймауте
Генерация выполняется синхронно с таймаутом 120 секунд.Успешная генерация (до 120 сек)
Возвращается объект с результатом:Таймаут (более 120 сек)
Если генерация не успевает завершиться за 120 секунд, запрос автоматически переходит в асинхронный режим:GET /v1/media/{id} для проверки статуса. Рекомендуется polling с интервалом 3-5 секунд.
Статусы генерации
Авторизации
API ключ передаётся в заголовке: Authorization: Bearer <POLZA_AI_API_KEY>
Тело
ID модели для генерации изображений
"dall-e-3"
Текстовое описание изображения для генерации (до 32000 символов для GPT image models, 4000 для dall-e-3)
"A white siamese cat sitting on a windowsill"
Количество генерируемых изображений (1-10, для dall-e-3 только 1)
1 <= x <= 101
Размер генерируемого изображения. auto для GPT image models
auto, 256x256, 512x512, 1024x1024, 1536x1024, 1024x1536, 1792x1024, 1024x1792 "auto"
Качество изображения. auto/high/medium/low для GPT image models, hd/standard для DALL-E
auto, low, medium, high, standard, hd "auto"
Формат ответа - URL или base64-encoded JSON
url, b64_json "url"
Стиль изображения (только для dall-e-3)
vivid, natural "vivid"
Формат выходного изображения (для gpt-image-1)
png, jpeg, webp "png"
Фон изображения: transparent, opaque или auto (для gpt-image-1)
transparent, opaque, auto "auto"
Степень сжатия выходного изображения (0-100, для gpt-image-1)
0 <= x <= 10075
Уникальный идентификатор конечного пользователя для отслеживания и предотвращения злоупотреблений
"user-123"
Ответ
Успешная генерация изображения. При таймауте (>120 сек) возвращается ImagePendingResponsePresenter с taskId для проверки статуса через GET /v2/media/{id}