X-API-Token: your_token按业务场景选择图片生成、一键白底图、批量洗图或视频翻译,使用对应 generate 接口提交任务。
请求头携带页面上方给出的 X-API-Token,提交成功后保存响应中的 taskId。
使用提交接口返回的 taskId 调用统一结果接口,建议每 20 到 30 秒轮询一次,直到 completed 或 failed。
认证方式
所有请求都需要在请求头中携带X-API-Token。如 Token 缺失、无效、过期或未授权,会返回 401/403。
任务状态
推荐状态流转:pending 到 processing,再到 completed 或 failed。完成后请以结果接口中的业务字段为准。
接入建议
- 提交生成任务后,请保存返回的 taskId。
- 建议每 20 到 30 秒调用一次获取结果接口,直到任务完成或失败。
- 图片生成、批量洗图单次最多 100 个子任务;视频生成单次最多 200 个子任务。
- 达到服务端并发提交上限时任务会进入等待队列;等待超时或队列满时返回 429。
- 如需查看接口消费,请调用消费记录接口,读取 totalConsumedCoins。
| HTTP | code | 说明 |
|---|---|---|
| 200 | 200 | 请求成功 |
| 400 | 400 | 参数校验失败 |
| 401 | 401 | Token 缺失、无效或过期 |
| 402 | 402 | 积分不足 |
| 403 | 403 | 无权限调用当前能力 |
| 404 | 404 | 任务不存在 |
| 429 | 429 | 请求过于频繁,或提交队列等待超时/队列已满 |
| 500 | 500 | 服务器内部错误或上游调用失败 |
| 503 | 503 | 能力暂时停用 |
按充值金额换算积分,例如 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 积分
imageHd 标准版 0.1 积分/张、专业版 0.5 积分/张、大模型增强版 3 积分/张;失败会退回。
imageErase 自动移除文字或图标并修复背景;提交成功即预扣 0.03 积分,失败会退回。
imageElementRemoval 自动清理水印、Logo、促销贴纸、价格标签和多余文字;上游失败会退回积分。
whiteBgImage 提交成功即预扣 0.03 积分;上游提交失败或任务失败会退回。
subjectExtract 使用火山 AI MediaKit 自动移除背景;提交成功即预扣 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 积分
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 积分/分钟。
genDetail 当前不会创建任务或扣除积分。
audioClone 按成品音频实际时长结算,实际时长向上取整到秒;提交时按文案预计时长预扣,完成后多退少补,失败自动退款。
digitalHuman 按 duration 向上取整到分钟计费;通过 RunningHub 数字人口播 AI App 生成视频,失败自动退款。
videoPrompt 通过 RunningHub 分析视频并返回一个提示词文件,失败自动退款。
imagePrompt 通过 RunningHub 分析1-8张图片并返回一个提示词文件,失败自动退款。
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 480P | Seedance 2.0 720P | Fast 480P | Fast 720P | Mini 480P | Mini 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 积分 |
