跳到主要内容

生成图像

POST /v1/images/generations/

请求参数​

参数名类型必选说明
modelstring可选用于图像生成的模型。dall-e-2、dall-e-3 或 gpt-image-1 之一。默认为 dall-e-2，除非使用特定于 gpt-image-1 的参数。
promptstring必选所需图像的文本描述。gpt-image-1 的最大长度为 32000 个字符，dall-e-2 的最大长度为 1000 个字符，dall-e-3 的最大长度为 4000 个字符。
ninteger可选要生成的图像数量。必须介于 1 到 10 之间。对于 dall-e-3，仅支持 n=1。
sizestring可选生成的图像的大小。对于 gpt-image-1，必须是 1024x1024、1536x1024（横向）、1024x1536（纵向）或自动（默认值）之一，对于 dall-e-2，必须是 256x256、``512x512 或 1024x1024 之一，对于 dall-e-3，必须是 1024x1024、1792x1024 或 1024x1792 之一。
backgroundstring可选允许为生成的图像的背景设置透明度。此参数仅支持 gpt-image-1。必须是以下之一 透明、不透明或自动（默认值）。使用自动时，模型将自动确定图像的最佳背景。 如果是透明的，则输出格式需要支持透明度，因此应将其设置为 png（默认值）或 webp。
moderationstring可选控制 gpt-image-1 生成的图像的内容审核级别。必须为低， 以进行限制较少的筛选或自动（默认值）。
qualitystring可选将生成的图像的质量。
streamstring可选-
stylestring可选-
userstring可选-

请求示例​

{
  "body": {
    "prompt": "string"
  }
}

响应字段（200）​

字段名类型说明
modelstringp p-0 用于图像生成的模型。 code code-0 dall-e-2 、 code code-1 dall-e-3 或 code code-2 gpt-image-1 之一。默认为 code code-3 dall-e-2 ，除非使用特定于 code code-4 gpt-image-1 的参数。
promptstringp p-0 所需图像的文本描述。 code code-0 gpt-image-1 的最大长度为 32000 个字符， code code-1 dall-e-2 的最大长度为 1000 个字符， code code-2 dall-e-3 的最大长度为 4000 个字符。
nintegerp p-0 要生成的图像数量。必须介于 1 到 10 之间。对于 code code-0 dall-e-3 ，仅支持 code code-1 n=1 。
sizestringp p-0 生成的图像的大小。 code code-0 对于 gpt-image-1 ，必须是 code code-1 1024x1024 、 code code-2 1536x1024 （横向）、 code code-3 1024x1536 （纵向）或 code code-4 自动 （默认值）之一， code code-5 对于 dall-e-2 ，必须是 code code-6 256x256、``512x512 或 code code-7 1024x1024 之一，对于 code code-8 dall-e-3 ，必须是 code code-9 1024x1024 、 code code-10 1792x1024 或 code code-11 1024x1792 之一。
backgroundstringp p-0 允许为生成的图像的背景设置透明度。此参数仅支持 code code-0 gpt-image-1 。必须是以下之一 code code-1 透明 、 code code-2 不透明 或 code code-3 自动 （默认值）。使用 code code-4 自动 时，模型将自动确定图像的最佳背景。 p p-1 如果 code code-0 是透明 的，则输出格式需要支持透明度，因此应将其设置为 code code-1 png （默认值）或 code code-2 webp 。
moderationstringp p-0 控制 code code-0 gpt-image-1 生成的图像的内容审核级别。必须为 code code-1 低， 以进行限制较少的筛选或 code code-2 自动 （默认值）。
qualitystringp p-0 将生成的图像的质量。
streamstring-
stylestring-
userstring-