OpenAI GPT Image 2.5 Edit

13.92 credits/call
ae_openai_gpt_image_2_5_edit

GPT Image 2.5 Sunburst 根据文字要求编辑参考图片,适用于局部调整、对象替换、背景修改与风格变化。输入编辑提示词和公开可访问的参考图片 URL,可选提供遮罩并设置输出尺寸、画质、背景、图片数量、格式与压缩。提交后返回任务 ID,可据此查询进度;完成后返回编辑后的图片 URL。

Image
13.92 credits/call

Pricing

13.92 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYesNo parameter description.—
request_body.promptstringYes用于指导图片编辑的文本提示词,详细描述需要进行的修改、添加或调整内容,长度在 1 到 32000 个字符之间。—
request_body.qualityenum (auto | low | medium | high | xhigh | max)No生成图片的画质等级,可选值为 'auto'、'low'、'medium'、'high'、'xhigh'、'max'。画质越高细节更丰富,默认值为 'high'。high
request_body.mask_urlstring | nullNo可选的公开 HTTP(S) PNG 遮罩图片URL,宽高应与第一张参考图一致;透明区域表示需要编辑的区域。不使用遮罩时省略。—
request_body.sync_modebooleanNo兼容选项;不改变任务查询方式,最终结果统一返回图片URL。false
request_body.backgroundenum (auto | transparent | opaque)No生成图片的背景类型,可选值为 'auto'(自动推断)、'transparent'(透明背景)或 'opaque'(不透明背景),默认值为 'auto'。auto
request_body.image_sizeobject | stringNo期望输出尺寸,可使用现有预设名称、auto,或包含 width 和 height 的像素尺寸对象。auto
request_body.image_size.widthintegerNoNo parameter description.512
request_body.image_size.heightintegerNoNo parameter description.512
request_body.image_urlsarrayYes用于编辑的参考图片链接列表,最多 16 张。每项必须是无需登录即可公开访问的 HTTP/HTTPS 图片链接,不要传本地路径、Base64 或 data: URI。本地图片先调用 ae_file_service_get_upload_addr,按返回的 uploadURL 上传图片,再把 downloadURL 填入此列表;已有公开图片链接无需重复上传。—
request_body.num_imagesintegerNo期望生成图片数量,范围1–10,默认1。1
request_body.output_formatenum (jpeg | png | webp)No输出图片的格式,可选值为 'png'、'jpeg'、'webp',默认值为 'png'。png
request_body.output_compressioninteger | nullNo输出图片的压缩比例,仅在 output_format 为 'jpeg' 或 'webp' 时生效,取值范围为 0 到 100,设为 null 时表示默认压缩。—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key

Submit first, then query with the returned task_id until the task completes.

Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_openai_gpt_image_2_5_edit' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "image_size": "portrait_4_3",
      "image_urls": [
        "https://agentearth.ai/fileserver/file/dee519c8-9393-4726-b9c7-c4b679777c09.jpg",
        "https://agentearth.ai/fileserver/file/c8dcae2a-2ecf-4e91-ac42-cca6baae4a1c.jpg",
        "https://agentearth.ai/fileserver/file/45a265b0-8b9f-46eb-aec2-f837a2754291.jpg"
      ],
      "num_images": 1,
      "prompt": "竖版 3:4 单帧,全身生活抓拍。参考图只用于逐件复刻鞋款外观,不得生成鞋子特写,不得改造鞋型。\n\n【鞋·最高优先,逐件复刻】严格按参考图,不得替换为复古跑鞋、德训鞋、板鞋、老爹鞋。鞋型:圆头低帮厚底休闲鞋,鞋头圆钝宽厚、不尖;鞋帮低平;鞋底为黑色橡胶厚底,厚度约为鞋帮高度的 45%,鞋底侧壁有横向齿状棱纹;鞋面为整体米白绒面磨砂皮;鞋口与鞋舌内里为白色短毛绒。**鞋面上只允许出现四处深棕色元素,不得多不得少:**① 外侧壁中段一块深棕色实心面状拼色块,形如两个同高圆拱并排相连(像连续两个门洞),自后向前峰—谷—峰,两端收在鞋身轮廓内,前端不到鞋头、后端不到后跟,带宽约鞋帮高的 22%;② 只在鞋头外侧最前端、紧靠鞋头尖:一枚深棕色细线勾勒的骨头轮廓,笔画宽约鞋帮高的 3%、全长约 45%,是勾勒线条不是实心色块;③ 只在后跟外侧下段、贴近中底上沿:深棕色小爪印,一块掌垫加四个小圆点,约鞋帮高的 18%;④ 后跟上部一块深棕色圆角面状拼块,覆盖后跟区上部约六成高度。**除上述四处,鞋面上不得出现任何白色图案、白色骨头、白色描边标记、品牌标识、字母、亮条或额外装饰**;深棕双拱不得到鞋头与前掌;骨头不得出现在鞋侧与后跟;爪印不得出现在鞋头。⑥ 双组鞋带:宽约鞋帮高 14% 的米白扁棉带,加直径约鞋帮高 6% 的黑白斑点圆绳,均系紧,带端为深棕皮质鞋头扣。鞋面中域只有同色细车线形成的两道弧形分割缝。裤脚与袜口止于踝上,两只鞋从鞋面到鞋头完整露出、不被裤脚遮挡;近侧鞋呈四分之三外侧位、完整露出外侧壁,远侧鞋略后撤、脚尖外撇。\n\n【人物】东亚女性,20 岁上下,圆润小巧的脸型、下颌线柔和圆钝、轻微婴儿肥,肤色偏白偏暖;淡妆,腮红落在颧骨偏下,唇色是极淡豆沙;表情自然放松、嘴角极轻微上扬、视线偏下不看镜头。及肩内扣短发,深栗黑发,发尾向内收,额前碎刘海被帽子压住几缕。不戴眼镜。\n\n【朝向与机位】人物斜侧约四分之三朝向画面左前方,双脚一前一后错开约半个脚长、重心落在前脚;相机与胸口同高(平视),地面线压到画面下沿约 1/5,头顶距画面上沿 6%,人物纵向占幅约 84%(留出更多地面给鞋)。右手插在裤侧口袋,左手自然垂在体侧、手背半露。\n\n【内层】米白薄款纯棉圆领打底,贴身不紧身,下摆比中层长出 1.5cm。\n\n【中层】燕麦米白粗针麻花圆领毛衣,落肩宽松:肩宽约比自身肩宽大 5cm,袖筒宽松垂坠、袖口在腕骨处卷起一圈形成厚堆边并露出约 6cm 手腕;麻花辫垂直走向、单条宽约 5cm,针目粗大明显可数。**领口为大圆领**:领口下沿低于锁骨约 2cm、横向宽度约肩宽的 55%,整个颈部和两侧锁骨完整露出,绝不得遮住锁骨、绝不得是高领或小圆领。\n\n【外层】深棕咖双面羊毛混纺 H 型大衣,落肩,长度过膝至小腿中段,完全敞开、两侧前襟向身体两侧掀开(不遮挡胸前毛衣与腰位),面料哑光有细绒毛感;大衣肩宽约比自身肩宽大 6cm。\n\n【下装】深棕咖羊毛混纺阔腿西裤,高腰(自然腰上 2cm),腰头宽 4cm 且有一道压线;裤腿为阔腿:单腿裤口横向宽约肩宽的 1.15 倍,大腿处不贴合腿形,裤管内外侧为垂直直线;裤脚九分,止于踝骨上方约 4cm,无堆叠、不拖地。\n\n【腰位】毛衣前片只把中间一角斜塞进裤腰(半塞),腰头与腰带结在画面中部清晰可见且不被大衣遮盖;一条燕麦本色帆布腰带,宽 3.5cm,系成松弛的平结,两端各垂约 12cm,无金属扣、无金属件。\n\n【配饰】共 2 组。① 主焦点(头部):燕麦米白粗针麻花毛线帽,帽檐向上卷两折形成约 4cm 厚卷边,帽顶收口处一颗豆沙粉(暖灰玫瑰粉)粗毛线大绒球,直径约帽体宽度的三分之一、表面毛线松散带毛刺;整帽柔软哑光无图案,绒球颜色与脚上堆堆袜同色。② 次焦点(脚踝):豆沙粉中筒针织堆堆袜,袜口在踝骨上方约 3cm 处自然堆出两三层褶,薄、哑光。\n\n【留白】2 处:锁骨与颈部(大圆领,纵向约 10cm);右手腕(袖口卷起露约 6cm)。腰腹零露肤。\n\n【色量】燕麦米白约 60%(毛衣+打底+毛线帽+帆布腰带)、深棕咖约 27%(大衣+西裤)、豆沙粉约 13%(绒球+堆堆袜);全身 3 个主色,无高饱和、无撞色;上浅下深;低饱和哑光暖灰调,冬日柔和侧光。\n\n【场景】冬日午后旧书店门前:脚下为深棕近黑的旧木地板(明度约 30%,宽板、磨白木纹与细缝);背景为米灰抹灰墙(明度约 75%,细颗粒+一块淡水渍);左侧木框旧玻璃门与窗,门框漆面斑驳;右侧边缘一只深棕木花箱、箱内过冬干枝,不与人物轮廓重叠。焦点在人物,中景保留可辨纹理,仅远景与门内轻微虚化。\n\n【负向】鞋上不要白色骨头与白色图案/不要把鞋做成复古跑鞋、德训鞋、板鞋、老爹鞋/不要薄底平底鞋/不要卡通印花与字母/不要玩偶挂件/不要蝴蝶结与蕾丝/不要高饱和与荧光/不要高领与遮住锁骨的小领/不要收腰紧身与强调胸臀曲线/不要窄腿裤与束脚裤/不要拖地裤脚/不要低腰垮裆/不要金属链条与金属扣/不要牛仔裤/不要 oversize 吞没头身比/不要腰线缺失的上下等分/不要对称军姿站法;不要鞋面特写。",
      "quality": "medium"
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "description": "task accepted; poll the result via query_tool with this task_id",
  "query_tool": "ae_get_result",
  "status": "created",
  "task_id": "fc4390db-ff88-4022-999a-180e61b5e7d2"
}

This example shows part of the response. Copied content is valid JSON.

Guides using this tool

See how this tool fits into real workflows