图像生成 - API调用文档

请求参数

Body 参数application/json

prompt

string

提示词

必需

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

model

string

模型名称

必需

支持 dall-e-2 和 dall-e-3

n

number | null

生成数量

可选

（默认值 1）一次性生成的图片数量：dall-e-2 支持1-10张 dall-e-3 只支持1张（可进行批量轮询请求多张）

response_format

string | null

数据格式

可选

返回生成图像的数据格式。必须是 url 或 b64_json之一。URL 仅在图像生成后的 60 分钟内有效。

size

string | null

图片尺寸

可选

生成的图片尺寸 dall-e-2 支持的尺寸 256x256、512x512、1024x1024。dall-e-3 支持的尺寸 1024x1024、1024x1792、1792x1024。

style

string | null

图像风格

可选

默认为 vivid。生成的图像的风格。可选值 vivid 或 natural 。Vivid 使模型生成的图像更写实。natural 使模型生成更不真实的图像。

user

string | null

用户

可选

代表您的最终用户的唯一标识符，可以帮助 OpenAI 监控和检测滥用行为。了解更多

示例

{
  "model": "dall-e-3",
  "prompt": "一幅详细的图像描绘了一个广阔的石器时代城市，城市中高耸的摩天大楼由巨石和骨头构成。这里热闹非凡，各种性别和种族的人们共同展现出原始人和原始女性的统一外貌。他们身穿商务服装，与史前背景形成鲜明对比。化石化的塔楼点缀着石质天际线，而人们则保留着原始的设计，身上披着毛皮，搭配现代的西装和领带。形成了现代生活与史前时代的美丽融合。",
  "n": 1,
  "size": "1024x1024"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/v1/images/generations' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "dall-e-3",
    "prompt": "一幅详细的图像描绘了一个广阔的石器时代城市，城市中高耸的摩天大楼由巨石和骨头构成。这里热闹非凡，各种性别和种族的人们共同展现出原始人和原始女性的统一外貌。他们身穿商务服装，与史前背景形成鲜明对比。化石化的塔楼点缀着石质天际线，而人们则保留着原始的设计，身上披着毛皮，搭配现代的西装和领带。形成了现代生活与史前时代的美丽融合。",
    "n": 1,
    "size": "1024x1024"
}'

返回响应

🟢200成功

application/json

Body

created

integer

必需

data

array [object {2}]

必需

revised_prompt

string

可选

url

string

可选

示例

{
  "created": 1725007743,
  "data": [
    {
      "revised_prompt": "A detailed image illustrating a sprawling Stone Age city with towering skyscrapers made from massive rocks and bones. The city is bustling with people of all genders and descents, such as Hispanic, Caucasian, South Asian, and Middle Eastern, unified in their appearance as primordial men and women. They are clad in business attire, contrasting significantly with the prehistoric backdrop. Fossilized towers adorn the stony skyline, while the people retain primitive designs, draped in pelts along with modern suits and ties, forming a beautiful blend of modern living with the prehistoric era.",
      "url": "https://oaidalleapiprodscus.blob.core.windows.net/private/org-ckj8cP1MmQK3ZdLPGoozEzD9/vv/img-l4C07hxN49jraolwGOXGc6Ce.png?st=2024-08-30T07%3A49%3A03Z&se=2024-08-30T09%3A49%3A03Z&sp=r&sv=2024-08-04&sr=b&rscd=inline&rsct=image/png&skoid=d505667d-d6c1-4a0a-bac7-5c84a87759f8&sktid=a48cca56-e6da-484e-a814-9c849652bcb3&skt=2024-08-29T19%3A17%3A38Z&ske=2024-08-30T19%3A17%3A38Z&sks=b&skv=2024-08-04&sig=UA38MfIU62lG5JtT2GCOqHEseAqnDceoA3iNwhfS4Xk%3D"
    }
  ]
}