首页/开放能力
Guide

快速开始

认证 Header
X-API-Token: your_token
1
选择能力接口

按业务场景选择图片生成、批量洗图或一键详情图,使用对应 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
Common

通用约定

认证方式

所有请求都需要在请求头中携带X-API-Token。如 Token 缺失、无效、过期或未授权,会返回 401/403。

任务状态

推荐状态流转:pending 到 processing,再到 completed 或 failed。完成后请以结果接口中的业务字段为准。

接入建议

  1. 提交生成任务后,请保存返回的 taskId。
  2. 建议每 20 到 30 秒调用一次获取结果接口,直到任务完成或失败。
  3. 图片生成、批量洗图、一键详情页单次最多 100 个子任务;视频生成单次最多 200 个子任务。
  4. 达到服务端并发提交上限时任务会进入等待队列;等待超时或队列满时返回 429。
  5. genDetail 返回 10 张详情图,并额外返回 psdUrl;如有模板图,请在提交时传 templateImage。
  6. 如需查看接口消费,请调用消费记录接口,读取 totalConsumedCoins。
HTTPcode说明
200200请求成功
400400参数校验失败
401401Token 缺失、无效或过期
402402积分不足
403403无权限调用当前能力
404404任务不存在
429429请求过于频繁,或提交队列等待超时/队列已满
500500服务器内部错误或上游调用失败
Billing

积分规则

充值换算
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 480PSeedance 2.0 720PSeedance 2.0 Fast 480PSeedance 2.0 Fast 720P
428 积分60 积分24 积分52 积分
535 积分75 积分30 积分65 积分
642 积分90 积分36 积分78 积分
749 积分105 积分42 积分91 积分
856 积分120 积分48 积分104 积分
963 积分135 积分54 积分117 积分
1070 积分150 积分60 积分130 积分
1177 积分165 积分66 积分143 积分
1284 积分180 积分72 积分156 积分
1391 积分195 积分78 积分169 积分
1498 积分210 积分84 积分182 积分
15105 积分225 积分90 积分195 积分