通过让模型根据新的文本提示替换预先存在图像的某些区域,创建图像的编辑版本(仅限DALL·E 2)
注意:APIFOX不支持此API在线调试价格:
文字输入 5 PTC/1M
图片输入 10 PTC/1M
图片输出 40 PTC/1M Request
示例值:Bearer {{YOUR_API_KEY}}
Body Params multipart/form-data
要编辑的图片。必须是受支持的图片或图片数组。对于 gpt-image-1,每张图片应为小于 25MB 的 png、webp 或 jpg 文件。
所需图像的文本描述。gpt-image-1 的最大长度为 32000 个字符。
一张附加图片,其完全透明区域(例如,alpha 值为零)指示应编辑 image 位置。如果提供了多张图片,则遮罩将应用于第一张图片。必须是有效的 PNG 文件,小于 4MB,且尺寸与 image 相同。
生成图像的质量。只支持 high、medium 和 low 质量。默认为 auto。
必须为 1024x1024、1536x1024(横向)、1024x1536(纵向)或 auto(默认值)之一
Request samples
curl --location --request POST 'https://api.302.ai/v1/images/edits?response_format=url' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: multipart/form-data' \
--form 'image=@""' \
--form 'prompt=""' \
--form 'model="gpt-image-1"' \
--form 'mask=@""' \
--form 'quality="auto"' \
--form 'size="1024x1024"' \
--form 'n="1"'
Responses
application/json {
"data": [
{
"url": "",
"b64_json": ""
}
],
"created": 1745694920,
"usage": {
"prompt_tokens": 0,
"completion_tokens": 0,
"total_tokens": 4172,
"prompt_tokens_details": {
"cached_tokens_details": {}
},
"completion_tokens_details": {},
"input_tokens": 12,
"output_tokens": 4160,
"input_tokens_details": {
"text_tokens": 12,
"cached_tokens_details": {}
}
}
}
Modified at 2025-05-15 07:18:20