Skip to content

编辑 image

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

请求参数

Header 参数

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

Body 参数 (multipart/form-data)

参数名类型必需说明
modelstring必需用于生成图像的模型。
promptstring必需
imagefile必需要编辑的图片支持传入1张
aspect_ratiostring可选【可选参数】宽高比 "1:1" | "3:4" | "4:3" | "9:16" | "16:9" | "2:3" | "3:2" | "9:19.5" | "19.5:9" | "9:20" | "20:9" | "1:2" | "2:1" | "auto"
response_formatstring可选【可选参数】输出格式 b64_json 或者 url
resolutionstring可选【可选参数】分辨率 "1k" | "2k"
qualitystring可选【可选参数】质量 "low" | "medium" | "high"
ninteger可选【可选参数】输出图片数量 默认为1 最大 10

cURL 示例

bash
curl --location --request POST 'https://az.gptplus5.com/v1/images/edits' \
--header 'Authorization: Bearer ' \
--form 'model="grok-3-image"' \
--form 'prompt="加一只小鸭"' \
--form 'image=@"C:\\Users\\y\\Pictures\\image-edit-2.webp"' \
--form 'n="1"'

返回响应

🟢200成功

响应示例

json
{
    "created": 1773127037,
    "data": [
        {
            "url": "https://pub-85624410c6c44bdb802187ae2bd8afff.r2.dev/grok/8903fc79-152b-4b80-b384-d74ae6775b07.jpg"
        }
    ],
    "usage": {
        "generated_images": 1,
        "output_tokens": 16384,
        "total_tokens": 16384
    }
}