Создать изображение

Создание изображений по текстовому запросу через API, совместимый с OpenAI.

Количество результатов, размеры, качество, стиль и формат ответа можно настраивать в пределах возможностей модели.

POST/v1/images/generations

Создавайте одно или несколько изображений по текстовому запросу. Опишите объект, сцену, композицию, ракурс, художественный стиль и общую атмосферу, затем настройте результат с помощью размеров, качества и формата ответа, поддерживаемых моделью.

Доступность моделей и конкретные ограничения параметров n, quality, size, style и других зависят от выбранной модели. Используйте ID модели, доступной текущему ключу API и поддерживающей генерацию изображений.

Аутентификация

bearerAuth

АутентификацияBearer <token>

Используйте Bearer your-api-key в Header Authorization.

Расположение: header

Тело запроса

application/json

Параметры запроса на генерацию изображений.

Определения типов TypeScript

Используйте тип request body в TypeScript.

model?string

ID модели для генерации изображений. Выберите модель, доступную текущему ключу API и поддерживающую генерацию изображений; параметры и ограничения могут различаться между моделями.

Длина1 <= length

prompt*string

Текстовое описание желаемого изображения. Укажите объект, ключевые визуальные элементы, композицию, ракурс, художественный стиль и атмосферу.

DALL·E 2 принимает до 1 000 символов, DALL·E 3 — до 4 000; ограничения других моделей определяются их фактическими возможностями. При неудачной генерации также проверьте соответствие текстового запроса политике в отношении контента.

Длина1 <= length

n?integer|null

Количество генерируемых изображений: от 1 до 10. DALL·E 3 поддерживает только n=1; возможность возврата нескольких изображений другими моделями зависит от их фактических возможностей.

Диапазон1 <= value <= 10

По умолчанию1

quality?string

Качество изображения. hd позволяет создавать более детализированные и согласованные изображения и применяется только к DALL·E 3; другие модели могут использовать иные значения.

По умолчанию"standard"

Допустимые значения

"standard"
"hd"

response_format?string|null

Формат ответа с изображениями. url возвращает временный URL изображения, действительный в течение 60 минут после генерации; b64_json возвращает данные изображения в Base64.

По умолчанию"url"

Допустимые значения

"url"
"b64_json"
null

size?string|null

Размеры изображения. DALL·E 2 поддерживает 256x256, 512x512, 1024x1024; DALL·E 3 — 1024x1024, 1792x1024, 1024x1792.

По умолчанию"1024x1024"

Допустимые значения

"256x256"
"512x512"
"1024x1024"
"1792x1024"
"1024x1792"
null

style?string|null

Стиль изображения. vivid тяготеет к сюрреалистичному и драматичному результату, а natural — к естественному и реалистичному. Параметр применяется только к DALL·E 3.

По умолчанию"vivid"

Допустимые значения

"vivid"
"natural"
null

user?string

Уникальный идентификатор конечного пользователя для мониторинга и обнаружения злоупотреблений.

Длина1 <= length

Тело ответа

`application/json`

curl -X POST "https://example.com/v1/images/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "Милый маленький калан играет в прозрачной воде, мягкое естественное освещение, чёткие детали",    "n": 1,    "size": "1024x1024"  }'

{
  "created": 1589478378,
  "data": [
    {
      "url": "https://example.com/generated-image.png",
      "revised_prompt": "Милый маленький калан играет в прозрачной воде; у него круглые глаза и пушистый мех."
    }
  ]
}

Создать изображение

Аутентификация

Тело запроса

Тело ответа

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`