智能修图 V3 API 接口文档

POST/image/v3/make/imageEditapplication/json

请求体

imageUrlstring必填

原图

格式：jpg、jpeg、png、webp尺寸：300×300～4096×4096宽高比：0.4～2.5

promptstring必填

提示词，不能为空；最多 3000 个字符

providerstring必填

模型，可选值详见比例与分辨率

outputNuminteger可选默认1

输出张数，取值范围 1～4

templatestring可选

提示词模板名称，模板中的 provider、needOptimize 配置优先于入参

可选值白底图 / 商品主图精修 / 生成场景 / 海报制作 / 加人或物 / 换动物 / 服装平铺 / 3D服装 / 人台换模特 / 卡通插画 / 改身材 / 更换风格 / 移除元素 / 文字消除 / 去除水印 / 添加水印

needOptimizeboolean可选

是否需要提示词优化，true：需要，false：不需要

aspectRatiostring可选

输出比例，模型支持范围详见比例与分辨率

resolutionstring可选

输出分辨率，详见比例与分辨率

supplyTypestring可选

供应模式；是否支持该字段及可选值，以当前模型实际提供为准

backgroundstring可选默认auto

画布背景模式，GPT 图片模型生效：transparent（透明）、opaque（不透明）、auto（由模型决定）。

qualitystring可选

输出品质，支持范围详见比例与分辨率；未传时由服务端处理

比例与分辨率

请显式传入所需分辨率。

provider	支持比例	支持分辨率	支持品质
正在读取模型配置...

请求示例

GPT系列模型（GPT_2_IMAGE / GPT_2_5_IMAGE）

JSON

{
    "imageUrl": "https://test-file-ai.linkfox.com/UPLOAD/image.jpg",
    "prompt": "将背景替换为简洁白色，保留主体商品",
    "provider": "GPT_2_IMAGE",
    "outputNum": 1,
    "resolution": "2K",
    "aspectRatio": "1:1",
    "quality": "high",
    "supplyType": "stable",
    "needOptimize": false
}

GPT_2_5_IMAGE / GPT_2_5_F_IMAGE 请求参数与上方完全一致，仅将 provider 改为对应模型码。

其他模型

JSON

{
    "imageUrl": "https://test-file-ai.linkfox.com/UPLOAD/image.jpg",
    "prompt": "将背景替换为简洁白色，保留主体商品",
    "provider": "BANANA_PRO",
    "outputNum": 1,
    "resolution": "2K",
    "aspectRatio": "1:1",
    "supplyType": "stable",
    "needOptimize": false
}

Qwen模型（QWEN_IMAGE_3_PRO）

JSON

{
    "imageUrl": "https://test-file-ai.linkfox.com/UPLOAD/image.jpg",
    "prompt": "将背景替换为简洁白色，保留主体商品",
    "provider": "QWEN_IMAGE_3_PRO",
    "outputNum": 1,
    "resolution": "2K",
    "aspectRatio": "1:1",
    "supplyType": "stable",
    "needOptimize": false
}

BANANA_2

JSON

{
    "imageUrl": "https://test-file-ai.linkfox.com/UPLOAD/image.jpg",
    "prompt": "将背景替换为简洁白色，保留主体商品",
    "provider": "BANANA_2",
    "outputNum": 1,
    "resolution": "1K",
    "supplyType": "stable",
    "needOptimize": false
}

提交后返回什么

提交成功后返回任务编号 data.id，表示任务已创建，结果还需等待生成。请保存编号。查看返回示例。

查询生成结果

用任务编号 data.id 调用获取作图结果，每次查询至少间隔 10 秒。data.status=3 表示成功；若生成了图片或视频，从 data.resultList[].url 获取地址。data.status=4 表示失败。查看统一示例。

扣费标准

正在读取当前模型扣点...

扣点数 = 单张扣点 × 输出数量（outputNum）。

创建上限

配置项	上限
创建中 / 生成中任务上限	100 个

智能修图V3

请求体

比例与分辨率

请求示例

提交后返回什么

查询生成结果

扣费标准

创建上限