跳到正文
上新Nano Banana 2.1 已上线：Google 新一代生图模型，单张低至 $0.0336，原生 4K，约上一代半价查看模型
HopBase
← 返回博客

统一视频生成 API:Seedance、可灵、海螺一套接口 | HopBase

HopBase 2026年11月05日 12 分钟阅读

有。HopBase 用一套异步任务接口接入多个视频模型家族:Seedance(2.0 / 2.5)、可灵(含 4.0)、MiniMax 海螺(H3 / H3-Max)和 Grok Imagine 视频,都是 POST /v1/video/generate 提交、GET /v1/video/tasks/{task_id} 轮询;阿里万相 3.0 和 HappyHorse 1.1 保留官方原路径(POST /api/v1/services/aigc/video-generation/video-synthesis,轮询 GET /api/v1/tasks/{task_id})。一把 Key 最多含 10 个分组,可以同时覆盖这些家族,美元计费。统一的是「提交 → 轮询 → 下载」流程和账户、余额;请求体仍按各家族自己的字段写。失败的视频任务不计费,结果链接自任务完成起 24 小时有效。

统一了什么,没统一什么

先看各家族的最小请求和结果位置。这张表决定了你的轮询代码要处理哪些差异:

家族提交 / 轮询最小请求提交返回完成后读取
Seedance/v1/video/generate / /v1/video/tasks/{task_id}model + 非空 content[]200,task.id(vt…)task.outputs
Grok Imagine 视频同上model + prompt 或 content + resolution200,task.id(vt…)task.outputs
MiniMax 海螺同上model + content + resolution + duration(纯文本还需 ratio)202,id(mmt…)outputs
可灵同上model + prompt 或 images[] / videos[]202,id(kt…)outputs
万相 3.0 / HappyHorse 1.1/api/v1/services/aigc/video-generation/video-synthesis / /api/v1/tasks/{task_id}model + input(parameters 可选)200,output.task_idoutput.video_url

提交成功码不同(200 或 202),按任意 2xx 视为提交成功即可。Seedance 和 Grok 的响应包在 task 里,可灵和海螺是顶层字段。进行中的状态值也不同(Seedance 为 pending / processing,可灵和海螺为 queued / processing),终态都是 completed 或 failed;万相 / HappyHorse 读 output.task_status,终态为 SUCCEEDED 或 FAILED。

各视频模型家族对比

下表参数全部取自 HopBase 文档,不同变体以 GET /v1/models 返回的完整 ID 为准:

家族与模型 ID分辨率时长(秒)参考输入声音
Seedance 2.0:dreamina-seedance-2-0-260128(标准)、-fast-260128、-mini-260615;国内版 doubao-seedance-2-0-*-a标准版 480p / 720p / 1080p,海外标准版另有 4K;Fast、Mini 为 480p / 720p4–15 或 -1content:图片 ≤9、视频 ≤3、音频 ≤3generate_audio(2.0 需显式传)
Seedance 2.5:dreamina-seedance-2-5-260628;国内版 doubao-seedance-2-5-260628-a480p / 720p / 1080p(海外 1080p 视分组而定,无 4K)4–30 或 -1content:图片 ≤30、视频 ≤10、音频 ≤10generate_audio 默认 true
可灵 4.0:kling-v4720p / 1080p3–30只支持文生视频和首帧图生视频成片总带声音,audio 不影响价格
可灵 3:kling-v3、kling-v3-omni、kling-v3-turbo720p / 1080p / 2k / 4k3–15images[] / videos[]、主体;v3 与 v3-omni 支持 shots 分镜v3、v3-omni 可选有声或无声
海螺 H3:MiniMax-H3768P / 2K4–15content:图片 ≤9、视频 ≤3、音频 ≤3,合计 ≤12原生生成
海螺 H3-Max:MiniMax-H3-Max480P / 768P5–15仅文本或首尾帧,不收 reference_*原生生成
Grok Imagine:grok-imagine-video-1.5480p / 720p / 1080p(带参考图时仅 480p / 720p)1–15顶层 reference_images ≤14,仅公网 URL无声音参数(generate_audio 会被拒绝)
万相 3.0:wan3.0-video480P / 720P / 1080P2–30input.media[]:图片 ≤10、视频 ≤5、音频 ≤5,文档或网页 ≤1audio 开关,同价
HappyHorse 1.1:happyhorse-1.1-t2v / -i2v / -r2v480P / 720P / 1080P3–15t2v 无;i2v 恰好 1 张首帧;r2v 1–9 张参考图—

可灵还有动作控制(kling-v3-motion-control)、数字人(kling-avatar)和对口型(kling-lip-sync),走同一个任务接口。

完整示例:Seedance 2.5 提交与轮询

1. 提交任务。所有字段都是顶层字段,不要嵌进 parameters:

curl https://api.hop-base.com/v1/video/generate \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-5-260628",
    "content": [
      { "type": "text", "text": "An orange cat runs across sunlit grass as the camera follows" }
    ],
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": false,
    "watermark": false
  }'

2. 提交成功返回 200,记下 task.id:

{
  "task": {
    "id": "vtEXAMPLE",
    "model": "dreamina-seedance-2-5-260628",
    "status": "pending",
    "outputs": [],
    "error": null,
    "created_at": "2026-09-23T08:00:00Z",
    "completed_at": null
  }
}

3. 每 5 秒轮询一次,直到 task.status 为 completed 或 failed。轮询不计费、不占并发:

curl https://api.hop-base.com/v1/video/tasks/vt-your-task-id \
  -H "Authorization: Bearer sk-your-key"

4. 完成后从 task.outputs(字符串数组)取视频链接,顶层 usage.cost_usd 是该任务实际扣的美元金额。链接自完成起 24 小时有效,过期返回 410,请及时下载。480p 和 720p 通常 2–5 分钟出片。

换到其他家族时,轮询代码不用改,只换请求体。例如可灵用 prompt + aspect_ratio,海螺用 MiniMax v2 的 content + resolution + duration。注意:Seedance 会静默忽略 size、seconds、n、aspect_ratio,按默认时长和 720p 生成,所以务必传 duration、resolution、ratio。

和分别去各厂商控制台对比

维度分别对接各厂商统一任务接口(HopBase)
账号每个平台各自注册、认证、充值一个账户、一把 Key(最多 10 个分组)
请求格式各家不同仍按各家字段,但提交和轮询路径统一(万相 / HappyHorse 除外)
计费单位各家不同,需自行换算同样不同:Seedance 按百万视频 token,可灵、海螺、万相、Grok 按秒;都从同一美元余额扣
每任务成本看各家账单任务结束后查询返回 usage.cost_usd
结果链接各家有效期不同统一 24 小时

价格与计费规则

  • 价格 = 各厂商官方牌价 × 分组倍率,见 价格页。官方牌价举例:MiniMax-H3-Max 480p $0.05 / 秒,kling-v4 720p $0.1471 / 秒,wan3.0-video 480p $0.04412 / 秒。
  • 失败的视频任务不计费;提交时的 400 也不计费。
  • 提交时按「可用余额 − 进行中任务预估 − 本任务预估」检查,不足返回 402 insufficient_balance。
  • 任务不能取消;提交成功后不要重复提交,每次重提都是一个新的计费任务。

更多背景:在海外调用国产视频模型讲多家族的接入步骤;Seedance API 价格全解讲按秒成本换算;可灵 4.0 API 接入指南讲 kling-v4 的参数;字段全集见 视频生成文档。想直接试,注册并创建 Key,勾选需要的视频分组。

常见问题

有没有一个 API 同时支持 Seedance、可灵和海螺?

有。在 HopBase 上,这三家和 Grok Imagine 视频共用 POST /v1/video/generate 与 GET /v1/video/tasks/{task_id},一把 Key 加上对应分组即可。请求体按各家族自己的字段写,轮询循环可以共用。

视频生成失败会扣费吗?

不会。失败的视频任务不计费,查询时 usage.cost_usd 显示 0;提交阶段被拒(如参数错误返回 400)也不计费。

海外开发者调用国产视频模型要用国内版还是海外版 ID?

只有 Seedance 分两套 ID:海外版 dreamina-seedance-*,国内版 doubao-seedance-*-a,分别需要对应分组的 Key;4K 只有海外 2.0 标准版。可灵、海螺、万相、Grok 只有一套 ID。用 GET /v1/models 查看你的 Key 实际可用的 ID。

教程