Skip to main content
POST

Поддерживаемые модели

Авторизация

string
обязательно
Все запросы к API требуют аутентификации Bearer TokenПолучение API-ключа:Перейдите на страницу управления API-ключами, чтобы получить ваш API-ключДобавьте следующее в заголовки запроса:

Body

string
обязательно
Название модели
  • gpt-image-1-official — Стабильность в приоритете, подходит для общей генерации изображений
  • gpt-image-1.5-official — Новая версия, подходит для более качественной и сложной обработки
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации изображения.
  • true: проверить промпты и входные изображения с помощью omni-moderation-latest
  • false или параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
string
обязательно
Текстовое описание для генерации изображения, поддерживает как китайский, так и английский
string
по умолчанию:"1:1"
Соотношение сторонПоддерживаемые соотношения:
  • 1:1 — Квадрат (по умолчанию)
  • 3:2 — Горизонтальное
  • 2:3 — Вертикальное
integer
по умолчанию:"1"
Количество генерируемых изображенийДиапазон: 1–4
  • Значения ≤ 0 будут интерпретироваться как 1
  • Значения > 4 будут интерпретироваться как 4
Внимание: Должно быть обычным числом (например, 1), без кавычек, иначе возникнет ошибка
string
по умолчанию:"auto"
Качество изображения
  • auto — Автоматический выбор качества (по умолчанию)
  • low — Быстрее, экономичнее
  • medium — Баланс между качеством и стоимостью
  • high — Более высокое качество, более высокая стоимость
string
по умолчанию:"auto"
Режим фона
  • auto — Автоматический фон (по умолчанию)
  • opaque — Непрозрачный фон
  • transparent — Прозрачный фон, рекомендуется с выходным форматом png
background: transparent нельзя использовать одновременно с output_format: jpeg
string
по умолчанию:"auto"
Уровень модерации
  • auto — Уровень модерации по умолчанию
  • low — Более мягкая модерация
string
по умолчанию:"png"
Выходной формат
  • png — Формат по умолчанию, подходит для прозрачных фонов
  • jpeg — Меньший размер файла, подходит для обычного вывода изображений
background: transparent нельзя использовать одновременно с output_format: jpeg
integer
Уровень сжатия вывода, диапазон 0–100
  • Рекомендуется только для jpeg
  • Не рекомендуется для png
array
Массив URL эталонных изображений, при наличии включает режим image-to-imageЛимит: До 15 эталонных изображений
string
URL маски для inpainting
  • Должен использоваться вместе с image_urls
  • Будет отправлен через официальный API редактирования
  1. Перед загрузкой маски убедитесь, что у изображения включён альфа-канал.
  2. Размер маски должен совпадать с размером первого эталонного изображения.

Справочник по размерам

Соотношения сторон используются внешне; система автоматически сопоставляет их с официальными размерами внутри.

Примеры использования

Text-to-Image (минимальный)
Text-to-Image (полный набор параметров)
Image-to-Image (одна ссылка)
Image-to-Image (объединение нескольких ссылок)
Несколько изображений (n > 1)

Response

integer
Код состояния ответа
array
Массив данных ответа

Примечания

  1. Асинхронная обработка: После отправки возвращается task_id. Опрашивайте /v1/tasks/{task_id}, чтобы получить результаты
  2. Выбор модели: используйте gpt-image-1-official для общей генерации изображений; используйте gpt-image-1.5-official для высококачественного редактирования и сложных задач image-to-image
  3. Требования к URL изображений: для image-to-image используйте публично доступные и стабильные URL
  4. Биллинг: оплата за каждое успешно сгенерированное изображение; за неудачные не взимается