首页/开放能力
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. 如需查看接口消费,请调用消费记录接口,读取 totalConsumedCoins。
HTTPcode说明
200200请求成功
400400参数校验失败
401401Token 缺失、无效或过期
402402积分不足
403403无权限调用当前能力
404404任务不存在
429429请求过于频繁,或提交队列等待超时/队列已满
500500服务器内部错误或上游调用失败
503503能力暂时停用
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 积分;gpt-image-2.5:仅支持 1K,为 2 积分;gpt-image-2.5-flare:1K/2K/4K 分别为 2/3/4 积分;gpt-image-2.5-sunburst:1K/2K/4K 分别为 2/3/4 积分;Nano Banana 2:1K/2K/4K 分别为 4/4/4 积分;Nano Banana Pro:1K/2K/4K 分别为 4/4/4 积分

2-6 积分 / 次
图片高清

imageHd 标准版 0.1 积分/张、专业版 0.5 积分/张、大模型增强版 3 积分/张;失败会退回。

0.1-3 积分 / 张
智能移除

imageErase 自动移除文字或图标并修复背景;提交成功即预扣 0.03 积分,失败会退回。

0.03 积分 / 次
牛皮癣擦除

imageElementRemoval 自动清理水印、Logo、促销贴纸、价格标签和多余文字;上游失败会退回积分。

0.8 积分 / 次
一键白底图

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

0.03 积分 / 次
一键透明底

subjectExtract 使用火山 AI MediaKit 自动移除背景;提交成功即预扣 0.03 积分,失败会退回。

0.03 积分 / 次
批量洗图

imageWash 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 积分

3-6 积分 / 张
视频生成(渠道)

videoGenerateChannel MiniMax H3 768P 4积分/秒、2K 8积分/秒;Seedance 2.0 480P 5积分/秒;720P 8积分/秒;Fast 480P 4积分/秒;720P 6积分/秒;Mini 480P 3积分/秒;720P 5积分/秒。参考视频另行计费。

按秒计费
视频生成(官方)

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 为 35、720P 60fps 为 70、1080P 30fps 为 80、1080P 60fps 为 160 积分/分钟。

35 / 70 / 80 / 160 积分 / 分钟
一键详情页

genDetail 当前不会创建任务或扣除积分。

暂时停用
音频刻录

audioClone 按成品音频实际时长结算,实际时长向上取整到秒;提交时按文案预计时长预扣,完成后多退少补,失败自动退款。

0.5 积分 / 秒
数字人口播

digitalHuman 按 duration 向上取整到分钟计费;通过 RunningHub 数字人口播 AI App 生成视频,失败自动退款。

20 积分/分钟
视频返推提示词

videoPrompt 通过 RunningHub 分析视频并返回一个提示词文件,失败自动退款。

1 积分 / 次
图片返推提示词

imagePrompt 通过 RunningHub 分析1-8张图片并返回一个提示词文件,失败自动退款。

1 积分 / 次
视频生成(官方)

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有参考视频(追加)
44 × 5 = 20 积分4 × 10 = 40 积分4 × 4 = 16 积分4 × 8 = 32 积分4 × 3 = 12 积分4 × 6 = 24 积分4 × 10 = 40 积分
55 × 5 = 25 积分5 × 10 = 50 积分5 × 4 = 20 积分5 × 8 = 40 积分5 × 3 = 15 积分5 × 6 = 30 积分5 × 10 = 50 积分
66 × 5 = 30 积分6 × 10 = 60 积分6 × 4 = 24 积分6 × 8 = 48 积分6 × 3 = 18 积分6 × 6 = 36 积分6 × 10 = 60 积分
77 × 5 = 35 积分7 × 10 = 70 积分7 × 4 = 28 积分7 × 8 = 56 积分7 × 3 = 21 积分7 × 6 = 42 积分7 × 10 = 70 积分
88 × 5 = 40 积分8 × 10 = 80 积分8 × 4 = 32 积分8 × 8 = 64 积分8 × 3 = 24 积分8 × 6 = 48 积分8 × 10 = 80 积分
99 × 5 = 45 积分9 × 10 = 90 积分9 × 4 = 36 积分9 × 8 = 72 积分9 × 3 = 27 积分9 × 6 = 54 积分9 × 10 = 90 积分
1010 × 5 = 50 积分10 × 10 = 100 积分10 × 4 = 40 积分10 × 8 = 80 积分10 × 3 = 30 积分10 × 6 = 60 积分10 × 10 = 100 积分
1111 × 5 = 55 积分11 × 10 = 110 积分11 × 4 = 44 积分11 × 8 = 88 积分11 × 3 = 33 积分11 × 6 = 66 积分11 × 10 = 110 积分
1212 × 5 = 60 积分12 × 10 = 120 积分12 × 4 = 48 积分12 × 8 = 96 积分12 × 3 = 36 积分12 × 6 = 72 积分12 × 10 = 120 积分
1313 × 5 = 65 积分13 × 10 = 130 积分13 × 4 = 52 积分13 × 8 = 104 积分13 × 3 = 39 积分13 × 6 = 78 积分13 × 10 = 130 积分
1414 × 5 = 70 积分14 × 10 = 140 积分14 × 4 = 56 积分14 × 8 = 112 积分14 × 3 = 42 积分14 × 6 = 84 积分14 × 10 = 140 积分
1515 × 5 = 75 积分15 × 10 = 150 积分15 × 4 = 60 积分15 × 8 = 120 积分15 × 3 = 45 积分15 × 6 = 90 积分15 × 10 = 150 积分