专用生图接口 (DALL-E 格式)

本文档详细说明了如何调用专用的图像生成接口 /v1/images/generations。该接口遵循 OpenAI DALL-E 的标准格式，为您提供稳定、直接的文生图能力。

接口定义

与复用聊天接口的方式不同，这是一个专门为图像生成设计的独立端点。

路径：/v1/images/generations

方法：POST

认证：Bearer Token

请求说明

认证方式与通用聊天接口完全一致，请在 HTTP Header 中包含 Authorization 字段。

Header 示例:

Authorization: Bearer YOUR_API_KEY

Body 参数 (application/json)

参数	类型	是否必需	描述
`prompt`	`string`	是	对所需图像的详细文本描述。描述越具体，生成效果越好。最大长度为 4000 个字符。
`model`	`string`	是	指定用于图像生成的模型，例如 `dall-e-3`, `gpt-4o-image` 等。
`n`	`integer`	否	希望一次性生成的图像数量。对于 `dall-e-3` 模型，此值只能为 `1`。默认为 `1`。
`quality`	`string`	否	生成图像的质量。`standard` 为标准质量，`hd` 为高清质量，`hd` 模式会消耗更多额度。默认为 `standard`。
`response_format`	`string`	否	返回生成图像的格式。`url` 表示返回一个临时的图片链接，`b64_json` 表示返回 Base64 编码的图像数据。默认为 `url`。
`size`	`string`	否	生成图像的尺寸。支持 `1024x1024`, `1792x1024` 或 `1024x1792`。默认为 `1024x1024`。
`style`	`string`	否	图像的风格。`vivid`（生动）会使图像偏向于超现实和戏剧性，`natural`（自然）则会产生更逼真、自然的图像。默认为 `vivid`。
`user`	`string`	否	代表最终用户的唯一标识符，用于监控和防止滥用。

请求 Body 示例

{
    "model": "dall-e-3",
    "prompt": "一只戴着皇冠的狮子，坐在王座上，背景是中世纪城堡，数字艺术风格",
    "n": 1,
    "size": "1792x1024",
    "quality": "hd",
    "style": "vivid"
}

响应说明

成功响应 (200 OK)

成功的响应会包含一个数据列表，其中每个对象都包含了生成图像的信息。

参数	类型	描述
`created`	`integer`	任务创建时的 Unix 时间戳。
`data`	`array`	包含生成结果的数组。
`data[].url`	`string`	生成的图像 URL。如果请求中 `response_format` 为 `url`，则此字段会出现。
`data[].b64_json`	`string`	Base64 编码的图像数据。如果请求中 `response_format` 为 `b64_json`，则此字段会出现。
`data[].revised_prompt`	`string`	系统为了安全或更好的效果而优化的提示词。

响应 Body 示例

{
  "created": 1725000000,
  "data": [
    {
      "revised_prompt": "A majestic lion wearing a crown is regally seated on a throne. The backdrop is a grand medieval castle, all rendered in a digital art style.",
      "url": "https://oaidalleapiprodscus.blob.core.windows.net/private/..."
    }
  ]
}

专用生图接口 (DALL-E 格式)

接口定义

请求说明

Body 参数 (application/json)

请求 Body 示例

响应说明

成功响应 (200 OK)

响应 Body 示例

代码示例

cURL

Python

专用生图接口 (DALL-E 格式)

接口定义#

请求说明#

Body 参数 (application/json)#

请求 Body 示例#

响应说明#

成功响应 (200 OK)#

响应 Body 示例#

代码示例#

cURL#

Python#

接口定义

请求说明

Body 参数 (application/json)

请求 Body 示例

响应说明

成功响应 (200 OK)

响应 Body 示例

代码示例

cURL

Python