生成图像

生成图像

POST /v1/images/generations/

在给定提示的情况下创建图像。了解更多。

请求头 (Headers)

参数名	类型	必选	描述	示例
Authorization	string	否	鉴权令牌	Bearer ********************

请求体 (Request Body)

Content-Type: application/json

字段	类型	必选	描述
model	string	否	用于图像生成的模型。dall-e-2、dall-e-3 或 gpt-image-1 之一。默认为 dall-e-2，除非使用特定于 gpt-image-1 的参数。
prompt	string	是	所需图像的文本描述。gpt-image-1 的最大长度为 32000 个字符，dall-e-2 的最大长度为 1000 个字符，dall-e-3 的最大长度为 4000 个字符。
n	integer	否	要生成的图像数量。必须介于 1 到 10 之间。对于 dall-e-3，仅支持 n=1。
size	string	否	生成的图像的大小。对于 gpt-image-1，必须是 1024x1024、1536x1024（横向）、1024x1536（纵向）或自动（默认值）之一，对于 dall-e-2，必须是 256x256、``512x512 或 1024x1024 之一，对于 dall-e-3，必须是 1024x1024、1792x1024 或 1024x1792 之一。
background	string	否	允许为生成的图像的背景设置透明度。此参数仅支持 gpt-image-1。必须是以下之一 透明、不透明或自动（默认值）。使用自动时，模型将自动确定图像的最佳背景。

如果是透明的，则输出格式需要支持透明度，因此应将其设置为 png（默认值）或 webp。 | | moderation | string | 否 | 控制 gpt-image-1 生成的图像的内容审核级别。必须为低， 以进行限制较少的筛选或自动（默认值）。 | | quality | string | 否 | 将生成的图像的质量。 | | stream | string | 否 | | | style | string | 否 | | | user | string | 否 | |

请求体示例

{
  "model": "string",
  "prompt": "string",
  "n": 0,
  "size": "string",
  "background": "string",
  "moderation": "string",
  "quality": "string",
  "stream": "string",
  "style": "string",
  "user": "string"
}

返回响应 (Responses)

200 -

字段	类型	描述
created	integer
data	array of object
data[].b64_json	string
data[].url	string
usage	object
usage.total_tokens	integer
usage.input_tokens	integer
usage.output_tokens	integer
usage.input_tokens_details	object
usage.input_tokens_details.text_tokens	integer
usage.input_tokens_details.image_tokens	integer

响应示例

{
  "created": 0,
  "data": [
    {
      "b64_json": "string",
      "url": "string"
    }
  ],
  "usage": {
    "total_tokens": 0,
    "input_tokens": 0,
    "output_tokens": 0,
    "input_tokens_details": {
      "text_tokens": 0,
      "image_tokens": 0
    }
  }
}