# OpenAI/图像（Images）

# POST 创建图像

POST /v1/images/generations

给定提示和/或输入图像，模型将生成新图像。

根据提示创建图像。

Body 请求参数

{
  "model": "dall-e-3",
  "prompt": "A cute baby sea otter",
  "n": 1,
  "size": "1024x1024"
}

# 请求参数

名称	位置	类型	必选	说明
Authorization	header	string	否	none
body	body	object	否	none
» prompt	body	string	是	所需图像的文本描述。最大长度为 1000 个字符。
» model	body	string	否	用于图像生成的模型。
» n	body	integer	否	要生成的图像数。必须介于 1 和 10 之间。
» quality	body	string	否	将生成的图像的质量。`hd`创建具有更精细细节和更高一致性的图像。此参数仅支持`dall-e-3`.
» response_format	body	string	否	返回生成的图像的格式。必须是或url之一b64_json。
» style	body	string	否	生成图像的大小。必须是`256x256`、`512x512`或`1024x1024`for之一`dall-e-2`。对于模型来说，必须是`1024x1024`、`1792x1024`、或之一。1024x1792``dall-e-3
» user	body	string	否	生成图像的风格。必须是或`vivid`之一`natural`。生动使模型倾向于生成超真实和戏剧性的图像。自然使模型生成更自然、不太真实的图像。此参数仅支持`dall-e-3`.
» size	body	string	否	生成图像的大小。必须是256x256、512x512或 1024x1024之一。

返回示例

Create image

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

# 返回结果

状态码	状态码含义	说明	数据模型
200	OK (opens new window)	Create image	Inline

# 返回数据结构

状态码 200

名称	类型	必选	约束	说明
» created	integer	true	none	none
» data	[object]	true	none	none
»» url	string	true	none	none

# POST 创建图片编辑

POST /v1/images/edits

在给定原始图像和提示的情况下创建编辑或扩展图像。

Body 请求参数

image: cmMtdXBsb2FkLTE2ODc4MzMzNDc3NTEtMjA=/31225951_59371037e9_small.png
mask: []
prompt: A cute baby sea otter wearing a beret.
n: "2"
size: 1024x1024
response_format: url
user: string

# 请求参数

名称	位置	类型	必选	说明
Authorization	header	string	否	none
body	body	object	否	none
» image	body	string(binary)	是	要编辑的图像。必须是有效的 PNG 文件，小于 4MB，并且是方形的。如果未提供遮罩，图像必须具有透明度，将用作遮罩。
» mask	body	string(binary)	否	附加图像，其完全透明区域（例如，alpha 为零的区域）指示image应编辑的位置。必须是有效的 PNG 文件，小于 4MB，并且尺寸与原始image相同。
» prompt	body	string	是	所需图像的文本描述。最大长度为 1000 个字符。
» n	body	string	否	要生成的图像数。必须介于 1 和 10 之间。
» size	body	string	否	生成图像的大小。必须是`256x256`、`512x512`或 `1024x1024`之一。
» response_format	body	string	否	生成的图像返回的格式。必须是`url`或`b64_json`。
» user	body	string	否	代表您的最终用户的唯一标识符，可以帮助 OpenAI 监控和检测滥用行为。了解更多 (opens new window)。

返回示例

成功

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

# 返回结果

状态码	状态码含义	说明	数据模型
200	OK (opens new window)	成功	Inline

# 返回数据结构

状态码 200

名称	类型	必选	约束	说明
» created	integer	true	none	none
» data	[object]	true	none	none
»» url	string	true	none	none

# POST 创建图像变体

POST /v1/images/variations

创建给定图像的变体。

Body 请求参数

image: cmMtdXBsb2FkLTE2ODc4MzMzNDc3NTEtMjc=/31225951_59371037e9_small.png
n: "2"
size: 1024x1024
response_format: url
user: string

# 请求参数

名称	位置	类型	必选	说明
Authorization	header	string	否	none
body	body	object	否	none
» image	body	string(binary)	是	用作变体基础的图像。必须是有效的 PNG 文件，小于 4MB，并且是方形的。
» n	body	string	否	要生成的图像数。必须介于 1 和 10 之间。
» size	body	string	否	生成图像的大小。必须是`256x256`、`512x512`或之一`1024x1024`。
» response_format	body	string	否	生成的图像返回的格式。必须是或`url`之一`b64_json`。
» user	body	string	否	代表您的最终用户的唯一标识符，可以帮助 OpenAI 监控和检测滥用行为。了解更多 (opens new window)。

返回示例

成功

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

# 返回结果

状态码	状态码含义	说明	数据模型
200	OK (opens new window)	成功	Inline

# 返回数据结构

状态码 200

名称	类型	必选	约束	说明
» created	integer	true	none	none
» data	[object]	true	none	none
»» url	string	true	none	none