Генерация и редактирование изображений

Создавайте и редактируйте изображения через конечные точки, совместимые с OpenAI, с поддержкой multipart-загрузок и URL изображений в JSON.

Обзор

Создавайте новые или редактируйте существующие изображения через стандартные маршруты OpenAI с поддержкой загрузки файлов и не потокового ввода URL-адресов изображений в JSON для gpt-image-2.

Генерация изображений

POST/v1/images/generations
  • Канонический эндпоинт: POST /v1/images/generations (operationId: openai.images.generations) создает изображения по текстовому промпту.
  • Параметры генерации: Принимает prompt, а также необязательные model, n, quality и size.
  • Псевдоним совместимости: Принимает POST /openai/v1/images/generations (operationId: openai.images.generations.alias).

Редактирование изображений

POST/openai/v1/images/edits
json
{
  "model": "gpt-image-2",
  "prompt": "Объедините эти референсные изображения в целостный сюрреалистический портрет.",
  "images": [
    { "image_url": "https://cdn.example.com/reference-1.png" },
    { "image_url": "https://cdn.example.com/reference-2.png" }
  ],
  "mask": {
    "image_url": "https://cdn.example.com/mask.png"
  },
  "n": 1,
  "quality": "medium",
  "size": "1024x1024"
}
  • Канонический эндпоинт: POST /openai/v1/images/edits (operationId: openai.images.edits) с псевдонимом совместимости POST /v1/images/edits (operationId: openai.images.edits.alias).
  • Ввод URL в JSON: Для gpt-image-2 и поддерживаемых нативных каналов отправляйте не потоковый JSON с параметрами model, prompt, массивом images (от 1 до 16 объектов с image_url) и необязательным объектом mask (image_url).
  • Требования к публичному HTTPS: URL-адреса изображений должны быть общедоступными HTTPS-адресами без встроенных учетных данных, читаемыми поставщиком напрямую.
  • Контроль качества и размеров: Для gpt-image-2 качество по умолчанию medium (также поддерживаются low и high); дополнительные нативные параметры передаются без изменений.
  • Контракт операции: Опубликован под operationId: openai.images.edits с совместимым псевдонимом POST /v1/images/edits.