Перейти к основному содержанию
POST
/
v1
/
images
/
generations
curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "Древний замок под звёздным небом, кинематографическое освещение, гиперреализм",
    "size": "16:9",
    "resolution": "2k",
    "quality": "high",
    "n": 1
  }'

{
  "id": "tsk_img_01KPTXXXXXXXXXXXXXXX",
  "object": "generation.task",
  "model": "gpt-image-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}
  • Официальная модель OpenAI gpt-image-2
  • Асинхронная обработка — возвращает ID задачи для последующего опроса
  • Поддержка text-to-image, image-to-image с несколькими reference-изображениями и inpainting (mask)
  • 13 соотношений сторон с тремя уровнями разрешения: 1K / 2K / 4K
  • До 4 изображений за запрос, до 16 reference-изображений
Примечание: gpt-image-2 не поддерживает прозрачный фон. Параметр background: "transparent" будет автоматически понижен до auto.

​
Авторизация

​
Authorization
string
обязательно
Все запросы требуют аутентификации Bearer TokenПолучите API Key на странице управления API ключамиДобавьте в заголовок запроса:
Authorization: Bearer YOUR_API_KEY

​
Тело запроса

​
model
string
по умолчанию:"gpt-image-2"
обязательно
Название модели генерации изображенийИспользуйте gpt-image-2
​
prompt
string
обязательно
Текстовый промпт для генерации изображенияПоддерживается русский, английский и китайский языки; рекомендуется детально описывать сцену, стиль и композицию
​
size
string
по умолчанию:"1:1"
Соотношение сторонПоддерживаемые значения, или auto для автоматического выбора:1:1 · 3:2 · 2:3 · 4:3 · 3:4 · 5:4 · 4:5 · 16:9 · 9:16 · 2:1 · 1:2 · 21:9 · 9:21
4K-режим поддерживает только 6 соотношений: 16:9 / 9:16 / 2:1 / 1:2 / 21:9 / 9:21. Для остальных используйте 1K или 2K.
​
resolution
string
по умолчанию:"1k"
Уровень разрешения
  • 1k — база 1024 пикс., быстро и экономично (по умолчанию)
  • 2k — база 2048 пикс., подходит для постеров и HD-контента
  • 4k — база 3840 пикс., только 6 соотношений выше; high качество может занять >120с

​
Таблица размеров

size1K2K4K
1:11024x10242048x2048Не поддерживается
3:21536x10242048x1360Не поддерживается
2:31024x15361360x2048Не поддерживается
4:31024x7682048x1536Не поддерживается
3:4768x10241536x2048Не поддерживается
5:41280x10242560x2048Не поддерживается
4:51024x12802048x2560Не поддерживается
16:91536x8642048x11523840x2160
9:16864x15361152x20482160x3840
2:12048x10242688x13443840x1920
1:21024x20481344x26881920x3840
21:92016x8642688x11523840x1648
9:21864x20161152x26881648x3840
​
quality
string
по умолчанию:"high"
Качество изображения
  • low — быстро и экономично, для черновиков/превью
  • medium — баланс скорости и качества
  • high — максимальная детализация, по умолчанию (4K + high занимает 120с+)
​
output_format
string
по умолчанию:"png"
Формат вывода
  • png — по умолчанию
  • jpeg — меньший размер файла (поддерживает сжатие)
Azure OpenAI не поддерживает формат webp.
​
output_compression
integer
по умолчанию:100
Уровень сжатия JPEG, диапазон 0–100 (0 — без сжатия, 100 — максимальное сжатие, по умолчанию 100)Применяется только при output_format: "jpeg"
​
n
integer
по умолчанию:1
Количество генерируемых изображенийДиапазон: 1 ~ 10
​
image_urls
string[]
Массив URL reference-изображений для image-to-image генерации
  • Максимум 16 изображений, должны быть публично доступными стабильными URL
  • Используйте API загрузки изображений для получения URL
​
mask_url
string
URL маски для inpaintingИспользуется совместно с image_urls. Маска должна совпадать по размеру с первым reference-изображением и содержать Alpha-канал (прозрачные области — это зоны для перерисовки)

​
Ответ

​
id
string
Уникальный идентификатор задачи
​
object
string
Тип объекта, всегда generation.task
​
model
string
Используемая модель
​
status
string
Статус задачи
  • queued — ожидает обработки
  • in_progress — обрабатывается
  • completed — успешно завершена
  • failed — ошибка
​
progress
integer
Прогресс задачи в процентах (0-100)
​
created_at
integer
Время создания задачи (Unix timestamp)
curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "Древний замок под звёздным небом, кинематографическое освещение, гиперреализм",
    "size": "16:9",
    "resolution": "2k",
    "quality": "high",
    "n": 1
  }'

{
  "id": "tsk_img_01KPTXXXXXXXXXXXXXXX",
  "object": "generation.task",
  "model": "gpt-image-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}