支持最多 100 张产品图、可选 1 张参考图，并可通过 count 批量生成洗图结果，可选择 Seedream 5.0 Pro。
Seedream 1K/2K 3/6积分/张；其他模型 4-6积分/张基础说明
支持最多 100 张产品图、可选 1 张参考图，并可通过 count 批量生成洗图结果，可选择 Seedream 5.0 Pro。
提交任务
提交批量洗图任务。平台会根据产品图、参考图和 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。 |
| prompt | string | 是 | 洗图指令，建议明确替换内容、保留内容和最终画面风格。 |
| productImages | string[] | 是 | 产品图 URL 列表，最多 100 张。 |
| referenceImages | string[] | 否 | 参考图 URL 列表，当前建议最多 1 张。 |
| resolution | string | 否 | 输出分辨率；Seedream 仅支持 1k、2k，其他图片模型可传 1k、2k、4k。 |
| aspectRatio | string | 否 | 输出比例，如 auto、1:1、4:3。 |
| 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"
}注意事项
- 图片模式与图片生成使用相同通道路由：gpt-image-2 按 Zhangyu、Runmux、KIE 的顺序提交和自动兜底；Nano Banana 2 与 Nano Banana Pro 按 Zhangyu、Lingjing 的顺序提交和自动兜底。
- Seedream 5.0 Pro 使用火山方舟通道，仅支持 1K/2K，每个子任务分别扣 3/6 积分。
- gpt-image-2 每个子任务按分辨率计费：1K 4 积分、2K 5 积分、4K 6 积分；Nano Banana 系列仍为 4 积分/张。
- 单次最多生成 100 个子任务，超出后建议拆批提交。
- 达到服务端并发提交上限时，子任务会进入等待队列；等待超时或队列满时返回 429，请稍后重试。
- partial_failed 表示部分子任务成功，调用方可优先展示成功结果。