AgentEarth
登录

Ae · Openai · Gpt · Image · 2 · 5 · Edit

5积分/次起
ae_openai_gpt_image_2_5_edit

使用 GPT Image 2.5 根据文字要求编辑参考图片，支持局部精修、遮罩编辑、对象添加或替换、背景调整和风格变化。参考图与遮罩图使用无需登录即可访问的 HTTP/HTTPS 图片链接，不要传 Base64、data: URI 或本地路径。本地图片先申请上传地址，按 uploadURL 上传后使用返回的 downloadURL；已有公开图片链接无需重复上传。返回 task_id 时，调用 ae_get_result 查询进度及最终结果，任务创建或处理中不代表已完成。

图像
5积分/次起

价格说明

5积分/次起
画质图片尺寸：其他尺寸／自定义／未指定图片尺寸：4:3或3:4图片尺寸：16:9或9:16
低8积分/张5积分/张6积分/张
中16积分/张11积分/张13积分/张
自动 / 高 / 未指定64积分/张44积分/张48积分/张
超高113积分/张78积分/张85积分/张
最高253积分/张174积分/张191积分/张

图片数量未填写时按1张计费。 起价对应图片尺寸：3:4纵向，画质：低。

API 调用

通过统一工具网关发起同步请求，鉴权和计费由 AgentEarth 处理。

cURL
curl --request POST \
  --url 'https://api.agentearth.ai/v1/tools/run' \
  --header 'Authorization: Bearer $AGENTEARTH_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "tool": "ae_openai_gpt_image_2_5_edit",
  "input": {
    "prompt": "xxx",
    "quality": "high",
    "mask_url": "xxx",
    "sync_mode": "false",
    "background": "auto",
    "image_size": "auto",
    "image_urls": "xxx",
    "num_images": "1",
    "output_format": "png",
    "output_compression": "xxx"
  }
}'
请求方式
POST
接口地址
/v1/tools/run
鉴权方式
Bearer Token
超时时间
60 秒
当前版本
—
响应示例
{
  "error_no": 0,
  "error_msg": "",
  "result": [
    {
      "type": "text",
      "text": "xxx"
    }
  ],
  "platform_annotations": {
    "source": "AgentEarth",
    "platform_note": "xxx",
    "platform_suggestion": "xxx"
  }
}

工具参数

未传入的可选参数将使用平台默认值。

参数类型必填说明默认值
promptstring是用于指导图片编辑的文本提示词，详细描述需要进行的修改、添加或调整内容，长度在 1 到 32000 个字符之间。—
qualityenum (auto | low | medium | high | xhigh | max)否生成图片的画质等级，可选值为 'auto'、'low'、'medium'、'high'、'xhigh'、'max'。画质越高细节更丰富，默认值为 'high'。high
mask_urlstring否可选遮罩图片，需为无需登录即可公开访问的 HTTP/HTTPS 图片链接；本地遮罩先上传并使用 downloadURL，不要传 Base64、data: URI 或本地路径。不使用遮罩时省略该参数。—
sync_modeboolean否是否启用同步响应模式。设为 true 时媒体以 Data URI 格式返回且不保留在请求历史中，默认值为 false。false
backgroundenum (auto | transparent | opaque)否生成图片的背景类型，可选值为 'auto'（自动推断）、'transparent'（透明背景）或 'opaque'（不透明背景），默认值为 'auto'。auto
image_sizeobject | string否生成图片的尺寸规格。可传入预设比例字符串（例如 'square_hd'、'square'、'portrait_4_3'、'portrait_16_9'、'landscape_4_3'、'landscape_16_9' 或 'auto' 表示从参考图自适应推断），也可传入包含 width 和 height（像素值 1 到 14142，默认均为 512）的自定义尺寸对象，默认值为 'auto'。auto
image_urlsarray是用于编辑的参考图片链接列表，最多 16 张。每项必须是无需登录即可公开访问的 HTTP/HTTPS 图片链接，不要传本地路径、Base64 或 data: URI。本地图片先调用 ae_file_service_get_upload_addr，按返回的 uploadURL 上传图片，再把 downloadURL 填入此列表；已有公开图片链接无需重复上传。—
num_imagesinteger否要生成的图片数量，取值范围为 1 到 10，默认值为 1。1
output_formatenum (jpeg | png | webp)否输出图片的格式，可选值为 'png'、'jpeg'、'webp'，默认值为 'png'。png
output_compressioninteger否输出图片的压缩比例，仅在 output_format 为 'jpeg' 或 'webp' 时生效，取值范围为 0 到 100，设为 null 时表示默认压缩。—