认证 Header
X-API-Token: your_token1
选择能力接口
按业务场景选择图片生成、批量洗图或一键详情图，使用对应 generate 接口提交任务。
POST /api/third-party/{capability}/generate
2
提交任务获取 taskId
请求头携带页面上方给出的 X-API-Token，提交成功后保存响应中的 taskId。
data.taskId
3
轮询结果接口
使用提交接口返回的 taskId 调用统一结果接口，建议每 20 到 30 秒轮询一次，直到 completed 或 failed。
GET /api/third-party/common/result?taskId=task_xxxxxxxx
认证方式
所有请求都需要在请求头中携带X-API-Token。如 Token 缺失、无效、过期或未授权，会返回 401/403。
任务状态
推荐状态流转：pending 到 processing，再到 completed 或 failed。完成后请以结果接口中的业务字段为准。
接入建议
- 提交生成任务后，请保存返回的 taskId。
- 建议每 20 到 30 秒调用一次获取结果接口，直到任务完成或失败。
- 图片生成、批量洗图、一键详情页单次最多 100 个子任务；视频生成单次最多 200 个子任务。
- 达到服务端并发提交上限时任务会进入等待队列；等待超时或队列满时返回 429。
- genDetail 返回 10 张详情图，并额外返回 psdUrl；如有模板图，请在提交时传 templateImage。
- 如需查看接口消费，请调用消费记录接口，读取 totalConsumedCoins。
| HTTP | code | 说明 |
|---|---|---|
| 200 | 200 | 请求成功 |
| 400 | 400 | 参数校验失败 |
| 401 | 401 | Token 缺失、无效或过期 |
| 402 | 402 | 积分不足 |
| 403 | 403 | 无权限调用当前能力 |
| 404 | 404 | 任务不存在 |
| 429 | 429 | 请求过于频繁，或提交队列等待超时/队列已满 |
| 500 | 500 | 服务器内部错误或上游调用失败 |
充值换算
1元=10积分
按充值金额换算积分，例如 10元=100积分、100元=1000积分。在线调试会提交真实任务并扣积分；积分不足时接口返回 402，不会放行。
图片生成
genImage 1K / 2K / 4K 当前统一扣 4 积分。
4 积分 / 次
批量洗图
imageWash 按实际生成次数计费；产品图、参考图与 count 会展开为多次生成。
2 积分 / 次
视频生成
videoGenerate Seedance 2.0：480P 7 积分/秒，720P 15 积分/秒；Fast：480P 6 积分/秒，720P 13 积分/秒。
按秒计费
一键详情页
genDetail 提交成功即预扣 50 积分；上游提交失败或任务失败会退回。
50 积分 / 次
视频生成
videoGenerate Seedance 2.0：480P 为 7 积分/秒、720P 为 15 积分/秒；Seedance 2.0 Fast：480P 为 6 积分/秒、720P 为 13 积分/秒。
| 时长 | Seedance 2.0 480P | Seedance 2.0 720P | Seedance 2.0 Fast 480P | Seedance 2.0 Fast 720P |
|---|---|---|---|---|
| 4 秒 | 28 积分 | 60 积分 | 24 积分 | 52 积分 |
| 5 秒 | 35 积分 | 75 积分 | 30 积分 | 65 积分 |
| 6 秒 | 42 积分 | 90 积分 | 36 积分 | 78 积分 |
| 7 秒 | 49 积分 | 105 积分 | 42 积分 | 91 积分 |
| 8 秒 | 56 积分 | 120 积分 | 48 积分 | 104 积分 |
| 9 秒 | 63 积分 | 135 积分 | 54 积分 | 117 积分 |
| 10 秒 | 70 积分 | 150 积分 | 60 积分 | 130 积分 |
| 11 秒 | 77 积分 | 165 积分 | 66 积分 | 143 积分 |
| 12 秒 | 84 积分 | 180 积分 | 72 积分 | 156 积分 |
| 13 秒 | 91 积分 | 195 积分 | 78 积分 | 169 积分 |
| 14 秒 | 98 积分 | 210 积分 | 84 积分 | 182 积分 |
| 15 秒 | 105 积分 | 225 积分 | 90 积分 | 195 积分 |