OpenAI API参考文档 | OpenAI开发文档|OpenAI中文官方文档|ChatGPT中文版|ChatGPT教程

创建镜像

帖子 https://api.openai.com/v1/images/generations

在给定提示的情况下创建图像。source

请求正文

提示

字符串source

必填

所需图像的文本描述。的最大长度为 1000 个字符dall-e-2和 4000 个字符dall-e-3.source

MODEL

字符串source

自选

默认为 dall-e-2

用于图像生成的模型。source

整数或 nullsource

自选

默认为 1

要生成的图像数。必须介于 1 和 10 之间。为dall-e-3只n=1受支持。source

质量

字符串source

自选

默认为 standard

将生成的图像质量。hd创建的图像具有更精细的细节和更高的图像一致性。此参数仅支持dall-e-3.source

response_format

string 或 nullsource

自选

默认为 url

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

大小

string 或 nullsource

自选

默认为 1024x1024

生成的图像的大小。必须是以下之一256x256,512x512或1024x1024为dall-e-2.必须是以下之一1024x1024,1792x1024或1024x1792为dall-e-3模型。source

风格

string 或 nullsource

自选

默认为 vivid

生成的图像的样式。必须是以下之一vivid或natural.Vivid 使模型倾向于生成超真实和戏剧性的图像。自然使模型生成更自然、外观更不真实的图像。此参数仅支持dall-e-3.source

用户

字符串source

自选

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

返回图像对象列表。source

示例请求

1
2
3
4
5
6
7
8
9
curl https://api.openai.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d '{
    "model": "dall-e-3",
    "prompt": "A cute baby sea otter",
    "n": 1,
    "size": "1024x1024"
  }'

1
2
3
4
5
6
7
8
9
from openai import OpenAI
client = OpenAI()

client.images.generate(
  model="dall-e-3",
  prompt="A cute baby sea otter",
  n=1,
  size="1024x1024"
)

1
2
3
4
5
6
7
8
9
10
import OpenAI from "openai";

const openai = new OpenAI();

async function main() {
  const image = await openai.images.generate({ model: "dall-e-3", prompt: "A cute baby sea otter" });

  console.log(image.data);
}
main();

响应

1
2
3
4
5
6
7
8
9
10
11
{
  "created": 1589478378,
  "data": [
    {
      "url": "https://..."
    },
    {
      "url": "https://..."
    }
  ]
}