Skip to content

Flux编辑(OpenAI dall-e-3格式)

POST https://az.gptplus5.com/v1/images/edits

给定一个提示,该模型将返回一个或多个预测的完成,并且还可以返回每个位置的替代标记的概率。

为提供的提示和参数创建完成

官方文档:https://platform.openai.com/docs/api-reference/images/createEdit

请求参数

Header 参数

参数名类型必需说明示例
Acceptstring必需application/json
Authorizationstring可选Bearer {{YOUR_API_KEY}}

Body 参数 (multipart/form-data)

参数名类型必需说明
imagefile必需要编辑的图片。必须是受支持的图片文件或图片数组。对于 gpt-image-1,每张图片应为小于 25MB 的 png、webp 或 jpg 文件。对于 dall-e-2,您只能提供一张图片,并且该图片应为小于 4MB 的方形 png 文件。
promptstring必需所需图像的文本描述。dall-e-2 的最大长度为 1000 个字符,gpt-image-1 的最大长度为 32000 个字符。
maskstring可选一张附加图片,其完全透明区域(例如,alpha 值为零)指示应编辑 image 位置。如果提供了多张图片,则遮罩将应用于第一张图片。必须是有效的 PNG 文件,小于 4MB,且尺寸与 image 相同。
modelstring可选用于生成图像的模型。仅 gpt-image-1, gpt-image-1-all , flux-kontext-pro , flux-kontext-max。
nstring可选要生成的图像数量。必须介于 1 到 10 之间。
qualitystring可选生成图像的质量。只有 gpt-image-1 支持 high、medium 和 low 质量。dall-e-2 仅支持 standard 质量。默认为 auto。
response_formatstring可选返回生成图像的格式。必须是 url 或 b64_json 之一。URL 在图像生成后 60 分钟内有效。此参数仅适用于 dall-e-2,因为 gpt-image-1 始终返回 base64 编码的图像,请不要使用这个参数。
aspect_ratiostring可选生成图像的尺寸。枚举值Possible enum values: 21:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 9:21
backgroundstring可选允许为生成的图像的背景设置透明度。此参数仅在 gpt-image-1 中受支持。其值必须为 “透明(transparent)”、“不透明(opaque)” 或 “自动(auto)”(默认值)之一。当使用 “自动(auto)” 时,模型将自动为图像确定最佳背景。
moderationstring可选控制由 gpt-image-1 生成的图像的内容审核级别。可以设置为 “low” 以进行限制较少的过滤,也可以设置为 “auto”(默认值)。

cURL 示例

bash
curl --location --request POST 'https://az.gptplus5.com/v1/images/edits' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer ' \
--form 'image=@"C:\\Users\\Administrator\\Desktop\\87069cf1-8838-4acf-bb31-e02e6c9a11eb.png"' \
--form 'prompt="换成红色衣服"' \
--form 'model="flux-kontext-max"' \
--form 'n="1"' \
--form 'aspect_ratio="16:9"'

返回响应

🟢200OK

响应 Body

参数名类型必需说明
idstring必需
objectstring必需
createdinteger必需
choicesarray[object]必需
  └ indexinteger可选
  └ messageobject可选
  └ finish_reasonstring可选
usageobject必需
  └ prompt_tokensinteger必需
  └ completion_tokensinteger必需
  └ total_tokensinteger必需

响应示例

json
{
    "id": "chatcmpl-123",
    "object": "chat.completion",
    "created": 1677652288,
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "\n\nHello there, how may I assist you today?"
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 9,
        "completion_tokens": 12,
        "total_tokens": 21
    }
}