支持最多 100 张产品图、可选 1 张参考图，并可通过 count 批量生成洗图结果。支持 Nano Banana 2、Nano Banana Pro、gpt-image-2 和 Seedream 5.0 Pro，默认 Nano Banana 2。
3-6积分/张基础说明
支持最多 100 张产品图、可选 1 张参考图，并可通过 count 批量生成洗图结果。支持 Nano Banana 2、Nano Banana Pro、gpt-image-2 和 Seedream 5.0 Pro，默认 Nano Banana 2。
提交任务
提交批量洗图任务。平台会根据产品图、参考图和 count 自动生成多个洗图任务。
POST/api/third-party/imageWash/generate
请求头
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| X-API-Token | string | 是 | 平台提供的调用凭证，用于识别当前账号或租户。 |
| Content-Type | string | 是 | 提交任务时固定使用 application/json。 |
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 否 | 模型，可传 nanoBanana2、nanoBananaPro、gpt-image-2 或 Seedream 5.0 Pro；默认 nanoBanana2。 |
| prompt | string | 是 | 洗图指令，建议明确替换内容、保留内容和最终画面风格。 |
| productImages | string[] | 是 | 产品图 URL 列表，最多 100 张。 |
| referenceImages | string[] | 否 | 参考图 URL 列表，当前建议最多 1 张。 |
| resolution | string | 否 | 输出分辨率；Seedream 仅支持 1k、2k；其他图片模型可传 1k、2k、4k，默认 2k。 |
| aspectRatio | string | 否 | 输出比例；Seedream 5.0 Pro 默认 1:1，仅支持 1:1、2:3、3:2、3:4、4:3、9:16、16:9、21:9、9:21，不提供 auto 选项；接口收到 auto 时自动转换为 1:1。其他模型默认 auto。 |
| count | number | 否 | 每组输入生成张数；最终子任务数会乘以 count。 |
请求示例
bash
curl -X POST "https://yunfanzhilian.com/api/third-party/imageWash/generate" \
-H "X-API-Token: your_token" \
-H "Content-Type: application/json" \
-d '{
"model": "nanoBanana2",
"prompt": "以产品图为主体，可参考参考图的风格/服装/场景进行洗图，保持产品信息与电商主图质感",
"productImages": [
"https://your-cdn.com/product-1.jpg"
],
"referenceImages": [
"https://your-cdn.com/reference.jpg"
],
"resolution": "2k",
"aspectRatio": "auto",
"count": 1
}'响应字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| code | number | - | 业务状态码，200 表示请求成功。 |
| message | string | - | 本次请求的结果说明。 |
| data.taskId | string | - | 任务 ID。提交成功后请保存，用于查询生成结果。 |
| data.cost | number | - | 本次提交预扣积分。 |
| data.status | string | - | 任务初始状态，通常为 pending 或 processing。 |
| timestamp | string | - | 响应时间，ISO 8601 格式。 |
响应示例
json
{
"code": 200,
"message": "批量洗图任务已提交",
"data": {
"taskId": "task_xxxxxxxx",
"status": "pending",
"totalTasks": 1,
"submittedTasks": 1,
"failedSubmissions": 0,
"resolution": "2k",
"aspectRatio": "auto",
"cost": 4
},
"timestamp": "2026-03-31T09:33:00.000Z"
}注意事项
- 与图片生成使用相同规则：原模型只尝试一次，1K/2K 失败后统一使用相同分辨率的 Seedream 5.0 Pro 兜底一次；4K 失败直接退款。
- Seedream 5.0 Pro：1K 3 积分、2K 6 积分。
- gpt-image-2：1K/2K/4K 分别为 4/5/6 积分；Nano Banana 2：1K/2K/4K 分别为 4/4/4 积分；Nano Banana Pro：1K/2K/4K 分别为 4/4/4 积分。
- 单次最多生成 100 个子任务，超出后建议拆批提交。
- 服务端不设置提交并发上限，上游服务自身的限流仍可能返回 429。
- partial_failed 表示部分子任务成功，调用方可优先展示成功结果。