视频模型 API

本文说明如何通过开放 API 调用捷智算 视频生成 / 编辑 模型。调用地址统一为 https://mass.gogpu.cn。

先看这几条

  • 请先看下方「我该选哪个模型」，再打开对应分册
  • 视频生成通常较慢（常见数分钟，复杂任务更久）：创建后请用 tid 轮询查询，不要反复提交
  • 生成结果下载链接约 24 小时内有效，请及时保存
  • 输入的图片/视频 URL 须 公网可访问

我该选哪个模型？

按能力选模型，链接即接口模型名称（与请求体 model 一致）：

你想做打开分册
纯文字生成视频wan2.7-t2v · happyhorse-1.1-t2v · doubao-seedance-t2v
一张图生成视频wan2.7-i2v · happyhorse-1.1-i2v · doubao-seedance-i2v
参考图 / 参考视频生成happyhorse-1.1-r2v · doubao-seedance-r2v
改已有视频happyhorse-1.0-video-edit

调用地址

用途方法完整地址
创建视频任务POSThttps://mass.gogpu.cn/v1/videos/completions
查询任务POSThttps://mass.gogpu.cn/v1/tasks/query
查看可用模型GEThttps://mass.gogpu.cn/v1/models

鉴权：X-API-Key: sk-你的密钥 或 Authorization: Bearer sk-你的密钥。

调用流程（异步）

请预留足够等待时间

视频生成 / 编辑 不是秒级返回。创建成功只表示任务已受理；需轮询 task_status，直到 SUCCEEDED / FAILED 等终态。实测常见需等待数分钟，高清、参考素材、编辑类可能更久。

POST /v1/videos/completions  →  返回 tid（创建成功，任务开始排队/生成）
        ↓
每隔 10～15 秒 POST /v1/tasks/query（model + tid）查看进度
        ↓
成功：从 resp_content 下载视频（约 24 小时有效）
失败：查看 fail_reason

建议：轮询间隔 10～15 秒；客户端总等待 ≥ 15～30 分钟（视频编辑可更长）。期间请勿因「还没出结果」就重复创建同一任务。

media.type 与 role

content.media[] 中：

type含义
2图片
3视频
4音频（仅部分模型支持，见分册）

不要在 media 里使用 type:1（文本请写在 content.prompt）。

role 表示这张图/这段视频的用途，常见值：

媒体种类常见 role
图片first_frame（首帧）、last_frame（尾帧）、reference_image（参考图）
视频reference_video（参考视频）、video_source（待编辑的源视频）
音频reference_audio（参考音频，仅部分模型）

type 与 role 必须匹配，且只使用该模型分册列出的组合；传错会被拒绝。文生视频请传 media: []。

通用参数一览

顶层

字段必传类型说明
model是string接口模型名称（与控制台一致）
content是object含 prompt、media
parameters否object见下表
conversation_id否number一般可不传

content

字段必传类型说明
prompt多数必填string正向提示词 / 编辑指令
negative_prompt否string反向提示词（不希望出现的内容）
media是array媒体列表；文生用 []

parameters（常见，按模型取舍）

字段必传类型常见取值说明
duration否int以控制台该模型为准输出秒数；视频编辑类请勿传
resolution否string"480P" / "720P" / "1080P" 等字符串，如 "720P"
aspect_ratio否string"16:9" / "9:16" / "1:1" 等画面比例
prompt_extend否booltrue / false是否自动扩写提示词（以该模型是否支持为准）
watermark否booltrue / false是否加水印
seed否int整数随机种子

WARNING

resolution 请传字符串（如 "720P"），不要传数字 720。视频编辑类请勿传 duration，输出时长由源视频决定。

创建成功响应（示意）

{
  "code": 0,
  "data": {
    "tid": 164,
    "output": {
      "task_id": "cgt-xxxxxxxx",
      "task_status": "PENDING"
    }
  },
  "msg": "操作成功"
}

查询时使用返回的 tid（平台任务号） 以及创建时的 model。创建响应中的 task_id 一般可忽略。

任务查询

{
  "model": "你的模型名称",
  "tid": 164
}

终态关注：

字段说明
task_statusSUCCEEDED 成功 / FAILED 失败等
complete_status1 进行中，2 成功，3 失败
resp_content成功时的视频下载地址（约 24 小时有效）
quantity计费用量；按秒计费时多为秒数（编辑类可能为输入+输出合计）
billing_metric计费所用清晰度档，如 480P / 720P
total_tokenToken 用量（按 Token 计费的模型会返回）
total_amount本次金额（元，按量时）
fail_reason失败原因

计费提示（概要）

计费方式怎么理解
按秒 × 清晰度费用与视频时长、清晰度档有关；编辑类常按 输入时长 + 输出时长
按 Token 分档费用与 Token 用量有关；带参考图/参考视频通常消耗更多

具体以控制台该模型标价，以及任务查询返回的用量/金额字段为准。详见 计费方式说明。

分模型文档

通义万相 Wan / 欢喜马 HappyHorse

模型 ID能力文档
wan2.7-t2v文生视频wan2.7-t2v
wan2.7-i2v图生视频wan2.7-i2v
happyhorse-1.1-t2v文生视频happyhorse-1.1-t2v
happyhorse-1.1-i2v图生视频happyhorse-1.1-i2v
happyhorse-1.1-r2v参考生视频happyhorse-1.1-r2v
happyhorse-1.0-video-edit视频编辑happyhorse-1.0-video-edit

豆包 Seedance

模型 ID能力文档
doubao-seedance-t2v文生视频doubao-seedance-t2v
doubao-seedance-i2v图生视频doubao-seedance-i2v
doubao-seedance-r2v参考生视频doubao-seedance-r2v

相关链接

复制 MD