Company Logo
首页/开放能力
Guide

快速开始

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

按业务场景选择图片生成、一键白底图、批量洗图、一键详情图或视频翻译，使用对应 generate 接口提交任务。

图片：POST /api/third-party/genImage/generate；视频翻译：POST /api/third-party/videoTranslate/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 张详情图和 PSD，统一从 results 读取；如有模板图，请在提交时传 templateImage。
  6. 如需查看接口消费，请调用消费记录接口，读取 totalConsumedCoins。
HTTPcode说明
200200请求成功
400400参数校验失败
401401Token 缺失、无效或过期
402402积分不足
403403无权限调用当前能力
404404任务不存在
429429请求过于频繁，或提交队列等待超时/队列已满
500500服务器内部错误或上游调用失败
Billing

积分规则

充值换算
1元=10积分

按充值金额换算积分，例如 10元=100积分、100元=1000积分。在线调试会提交真实任务并扣积分；积分不足时接口返回 402，不会放行。

图片生成

genImage Seedream 5.0 Pro：1K 3 积分、2K 6 积分；gpt-image-2：1K/2K/4K 分别为 4/5/6 积分；Nano Banana 系列 4 积分/次。

3-6 积分 / 次
图片高清

imageHd 提交成功即预扣 1 积分；支持按 scaleBy 放大高清。

1 积分 / 次
一键白底图

whiteBgImage 提交成功即预扣 0.2 积分；上游提交失败或任务失败会退回。

0.2 积分 / 次
批量洗图

imageWash Seedream 5.0 Pro 按 1K/2K 分别扣 3/6 积分；gpt-image-2 按 1K/2K/4K 分别扣 4/5/6 积分；Nano Banana 4 积分/张。按实际生成次数计费。

3-6 积分 / 张
视频生成（渠道）

videoGenerateChannel 基础生成费、参考视频费、模型单价与视频生成（官方）完全一致。

按秒计费
视频生成（官方）

videoGenerateOfficial 基础生成费 = 视频时长 × 模型与分辨率单价；每个参考视频时长分别向上取整到整秒，参考视频费 = 合计计费秒数 × 10 积分/秒；参考视频最多 3 个且总时长不超过 15 秒。示例：10 秒 Seedance 2.0 480P = 50 积分，720P = 100 积分；10 秒 Fast 480P = 40 积分，720P = 80 积分；10 秒 Mini 480P = 30 积分，720P = 60 积分。

按秒计费
视频高清

videoHd 按 targetResolution 与 frameRate 计费：720P 30fps 为 10 积分/分钟；720P 60fps 与 1080P 30fps 为 20 积分/分钟；1080P 60fps 为 35 积分/分钟。

10 / 20 / 35 积分 / 分钟
一键详情页

genDetail 提交成功即预扣 50 积分；上游提交失败或任务失败会退回。

50 积分 / 次
视频生成（官方）

videoGenerateOfficial 支持参考视频， 基础生成费：Seedance 2.0 480P 为 5 积分/秒、720P 为 10 积分/秒；Seedance 2.0 Fast 480P 为 4 积分/秒、720P 为 8 积分/秒；Seedance 2.0 Mini 480P 为 3 积分/秒、720P 为 6 积分/秒。

时长Seedance 2.0 480PSeedance 2.0 720PFast 480PFast 720PMini 480PMini 720P有参考视频（追加）
4 秒4 × 5 = 20 积分4 × 10 = 40 积分4 × 4 = 16 积分4 × 8 = 32 积分4 × 3 = 12 积分4 × 6 = 24 积分4 × 10 = 40 积分
5 秒5 × 5 = 25 积分5 × 10 = 50 积分5 × 4 = 20 积分5 × 8 = 40 积分5 × 3 = 15 积分5 × 6 = 30 积分5 × 10 = 50 积分
6 秒6 × 5 = 30 积分6 × 10 = 60 积分6 × 4 = 24 积分6 × 8 = 48 积分6 × 3 = 18 积分6 × 6 = 36 积分6 × 10 = 60 积分
7 秒7 × 5 = 35 积分7 × 10 = 70 积分7 × 4 = 28 积分7 × 8 = 56 积分7 × 3 = 21 积分7 × 6 = 42 积分7 × 10 = 70 积分
8 秒8 × 5 = 40 积分8 × 10 = 80 积分8 × 4 = 32 积分8 × 8 = 64 积分8 × 3 = 24 积分8 × 6 = 48 积分8 × 10 = 80 积分
9 秒9 × 5 = 45 积分9 × 10 = 90 积分9 × 4 = 36 积分9 × 8 = 72 积分9 × 3 = 27 积分9 × 6 = 54 积分9 × 10 = 90 积分
10 秒10 × 5 = 50 积分10 × 10 = 100 积分10 × 4 = 40 积分10 × 8 = 80 积分10 × 3 = 30 积分10 × 6 = 60 积分10 × 10 = 100 积分
11 秒11 × 5 = 55 积分11 × 10 = 110 积分11 × 4 = 44 积分11 × 8 = 88 积分11 × 3 = 33 积分11 × 6 = 66 积分11 × 10 = 110 积分
12 秒12 × 5 = 60 积分12 × 10 = 120 积分12 × 4 = 48 积分12 × 8 = 96 积分12 × 3 = 36 积分12 × 6 = 72 积分12 × 10 = 120 积分
13 秒13 × 5 = 65 积分13 × 10 = 130 积分13 × 4 = 52 积分13 × 8 = 104 积分13 × 3 = 39 积分13 × 6 = 78 积分13 × 10 = 130 积分
14 秒14 × 5 = 70 积分14 × 10 = 140 积分14 × 4 = 56 积分14 × 8 = 112 积分14 × 3 = 42 积分14 × 6 = 84 积分14 × 10 = 140 积分
15 秒15 × 5 = 75 积分15 × 10 = 150 积分15 × 4 = 60 积分15 × 8 = 120 积分15 × 3 = 45 积分15 × 6 = 90 积分15 × 10 = 150 积分