创建图像变体

POST

https://api.openai.com/v1/images/variations

创建给定图像的变体。

请求参数

Authorization

Header 参数

Authorization

string

可选

示例值:

Bearer {{YOUR_API_KEY}}

Body 参数multipart/form-data

image

file

必需

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

示例值:

cmMtdXBsb2FkLTE2ODc4MzMzNDc3NTEtMjc=/31225951_59371037e9_small.png

string

可选

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

示例值:

size

string

可选

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

示例值:

1024x1024

response_format

string

可选

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

示例值:

url

user

string

可选

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

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.openai.com/v1/images/variations' \
--header 'Authorization: Bearer ' \
--form 'image=@"cmMtdXBsb2FkLTE2ODc4MzMzNDc3NTEtMjc=/31225951_59371037e9_small.png"' \
--form 'n="2"' \
--form 'size="1024x1024"' \
--form 'response_format="url"' \
--form 'user=""'

返回响应

🟢200成功

application/json

Body

created

integer

必需

data

array [object {1}]

必需

url

string

必需

示例

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

修改于 2025-03-28 12:56:11

创建图片编辑

README