API reference

DALL·E 3

POST

/v1/images/generations

Last modified:2025-02-05 11:14:30

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Authorization

string

optional

Example:

Bearer {{YOUR_API_KEY}}

Body Params application/json

prompt

string

required

所需图像的文本描述。最大长度为 1000 个字符。

integer

optional

要生成的图像数。必须介于 1 和 10 之间。

size

string

optional

生成图像的大小。必须是256x256、512x512或 1024x1024之一。

Example

{
  "prompt": "A colorful sunset over the mountains",
  "n": 1,
  "model": "dall-e-3",
  "size": "1024x1024"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '/v1/images/generations' \
--header 'Authorization: Bearer ' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "prompt": "A colorful sunset over the mountains",
  "n": 1,
  "model": "dall-e-3",
  "size": "1024x1024"
}'

Responses

🟢200Create image

application/json

Body

created

integer

required

data

array [object {1}]

required

url

string

required

Example

{
  "created": 1589478378,
  "data": [
    {
      "url": "https://..."
    },
    {
      "url": "https://..."
    }
  ]
}

Speech

Create