图像(images)

创建图像

post

图片

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

相关指南：图像生成

根据提示创建图像。

头参数

Authorizationstring可选Example: Bearer {{YOUR_API_KEY}}

请求体

application/json

promptstring必填

所需图像的文本描述。最大长度为 1000 个字符。

modelstring可选

用于图像生成的模型。

ninteger可选

要生成的图像数。必须介于 1 和 10 之间。

qualitystring可选

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

response_formatstring可选

返回生成的图像的格式。必须是 或url之一b64_json。

stylestring可选

生成图像的大小。必须是256x256、512x512或1024x1024for之一dall-e-2。对于模型来说，必须是1024x1024、1792x1024、 或之一。1024x1792``dall-e-3

userstring可选

生成图像的风格。必须是 或vivid之一natural。生动使模型倾向于生成超真实和戏剧性的图像。自然使模型生成更自然、不太真实的图像。此参数仅支持dall-e-3.

sizestring可选

生成图像的大小。必须是256x256、512x512或 1024x1024之一。

响应

200成功

application/json

post

/v1/images/generations

HTTPcURLJavaScriptPython

POST /v1/images/generations HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 78

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

200成功

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

创建图片编辑

post

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

头参数

Authorizationstring可选Example: Bearer {{YOUR_API_KEY}}

请求体

multipart/form-data

imagestring · binary必填

要编辑的图像。必须是有效的 PNG 文件，小于 4MB，并且是方形的。如果未提供遮罩，图像必须具有透明度，将用作遮罩。

Example: cmMtdXBsb2FkLTE2ODc4MzMzNDc3NTEtMjA=/31225951_59371037e9_small.png

maskstring · binary可选

附加图像，其完全透明区域（例如，alpha 为零的区域）指示image应编辑的位置。必须是有效的 PNG 文件，小于 4MB，并且尺寸与原始image相同。

promptstring必填

所需图像的文本描述。最大长度为 1000 个字符。

Example: A cute baby sea otter wearing a beret.

nstring可选

要生成的图像数。必须介于 1 和 10 之间。

Example: 2

sizestring可选

生成图像的大小。必须是256x256、512x512或 1024x1024之一。

Example: 1024x1024

response_formatstring可选

生成的图像返回的格式。必须是url或b64_json。

Example: url

userstring可选

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

响应

200成功

application/json

post

/v1/images/edits

HTTPcURLJavaScriptPython

POST /v1/images/edits HTTP/1.1
Content-Type: multipart/form-data
Accept: */*
Content-Length: 199

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

200成功

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

创建图像变体

post

创建给定图像的变体。

头参数

Authorizationstring可选Example: Bearer {{YOUR_API_KEY}}

请求体

multipart/form-data

imagestring · binary必填

用作变体基础的图像。必须是有效的 PNG 文件，小于 4MB，并且是方形的。

Example: cmMtdXBsb2FkLTE2ODc4MzMzNDc3NTEtMjc=/31225951_59371037e9_small.png

nstring可选

要生成的图像数。必须介于 1 和 10 之间。

Example: 2

sizestring可选

生成图像的大小。必须是256x256、512x512或 之一1024x1024。

Example: 1024x1024

response_formatstring可选

生成的图像返回的格式。必须是 或url之一b64_json。

Example: url

userstring可选

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

响应

200成功

application/json

post

/v1/images/variations

HTTPcURLJavaScriptPython

POST /v1/images/variations HTTP/1.1
Content-Type: multipart/form-data
Accept: */*
Content-Length: 139

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

200成功

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