主题
编辑 image
POST
https://az.gptplus5.com/v1/images/edits
请求参数
Header 参数
| 参数名 | 类型 | 必需 | 说明 | 示例 |
|---|---|---|---|---|
Authorization | string | 可选 | Bearer {{YOUR_API_KEY}} |
Body 参数 (multipart/form-data)
| 参数名 | 类型 | 必需 | 说明 |
|---|---|---|---|
model | string | 必需 | 用于生成图像的模型。 |
prompt | string | 必需 | |
image | file | 必需 | 要编辑的图片支持传入1张 |
aspect_ratio | string | 可选 | 【可选参数】宽高比 "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_format | string | 可选 | 【可选参数】输出格式 b64_json 或者 url |
resolution | string | 可选 | 【可选参数】分辨率 "1k" | "2k" |
quality | string | 可选 | 【可选参数】质量 "low" | "medium" | "high" |
n | integer | 可选 | 【可选参数】输出图片数量 默认为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
}
}