Skip to main content
POST
  • Унифицированный API генерации изображений
  • Выбор модели gpt-image-2-vip через параметр model
  • Параметры совпадают с gpt-image-2
  • Поддержка text-to-image, single-reference и multi-reference generation
  • Асинхронное управление задачами с получением результата по task ID
Важное изменение: Для повышения производительности и контроля затрат base64 больше не поддерживается в image_urls и reference_images. Сначала используйте API загрузки изображений, затем передайте полученный URL.

Авторизация

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

Тело запроса

string
по умолчанию:"gpt-image-2-vip"
обязательно
Название модели генерации изображенийПример: "gpt-image-2-vip"
string
обязательно
Текстовый промпт для генерации изображенияМаксимум 32 000 символов для GPT image models
string
по умолчанию:"1:1"
Соотношение сторон выходного изображенияПредустановленные соотношения: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Также можно передать любое соотношение в формате ширина:высота, например 1:3 или 7:4, с учетом ограничений ниже.Можно передать auto, чтобы поставщик автоматически выбрал размеры, но итоговое соотношение сторон и размеры в пикселях не гарантируются.
string
по умолчанию:"1k"
Уровень разрешения изображенияПоддерживаемые значения: 1k, 2k, 4k

Произвольное разрешение

Помимо предустановленных соотношений выше, можно передать любое соотношение в формате ширина:высота через size. Сервис рассчитывает размеры в пикселях на основе выбранного уровня resolution. Результат должен соответствовать всем ограничениям:
  • Обе стороны должны быть кратны 16 пикселям
  • Длинная сторона не более 3 840 пикселей (4K)
  • Соотношение сторон не более 3:1
  • Общее количество пикселей от 655 360 до 8 294 400
Примеры:
  • size: "1:3" и resolution: "2k"1024x3072
  • size: "7:4" и resolution: "1k"1344x768
string
по умолчанию:"medium"
Качество изображения
  • low — быстро и экономично, для черновиков/превью
  • medium — баланс скорости и качества
  • high — максимальная детализация, подходит для финальных изображений
integer
по умолчанию:1
Количество изображенийПо умолчанию: 1
string
по умолчанию:"url"
Формат ответаAPI возвращает URL изображения, рекомендуемое значение: url
string[]
URL эталонных изображений для image-to-image⚠️ Только URL (base64 больше не поддерживается)
  • Публично доступные URL (http:// или https://)
  • Можно использовать API загрузки изображений для загрузки локальных файлов
  • Поддерживаются одиночные и множественные reference images
string[]
Поле обратной совместимостиВ ToAPIs автоматически нормализуется в reference_images
string
Стандартный callback завершения ToAPIs. Настройте HTTPS URL и secret Token; разрешено только same-origin переопределение. См. Webhook.

Ответ

string
Уникальный идентификатор задачи
string
Тип объекта, всегда generation.task
string
Используемая модель
string
Статус задачи
  • queued
  • in_progress
  • completed
  • failed
integer
Прогресс задачи (0-100)
integer
Время создания задачи (Unix timestamp)