Skip to content

视频 ​

← 返回全部能力

用一段提示词,或用一张首帧图加一段提示词,生成一段短视频。提交是异步的:先拿任务号,再轮询取结果。

接口一览 ​

接口方法与路径说明
提交生成任务POST /v1/video/generations返回任务号,此时还没有视频地址
轮询任务结果GET /v1/video/generations/{task_id}查询进度,完成后返回视频地址

基地址 https://api.jcaigc.cn/v1,请求头带 Authorization: Bearer <密钥>(也接受 x-api-key),密钥是控制台里的 apiKey。

走文生视频还是图生视频,由入参决定,不由模型名决定:带了 image_url 就走图生视频,否则走文生视频。 再带上 audio_url 就进数字人:配 image_url 走图片说话,配 video_url 走视频对口型, 详见数字人板块。同一个提交接口因此在四处都能用。

支持的模型 ​

模型类型
wan3.0-video万相 3.0,文生视频与图生视频合一
happyhorse-1.1-t2v文生视频
happyhorse-1.1-i2v图生视频
doubao-seedance-2.5豆包 Seedance 2.5,4–30 秒直出,只出 720P / 1080P
doubao-seedance-2.0豆包 Seedance 2.0,480P–4K,支持参考视频与音频驱动
doubao-seedance-2.0-fast2.0 快速版,只出 480P / 720P
doubao-seedance-2.0-mini2.0 经济版,480P / 720P,批量出片成本最低
veo-3.1Veo 3.1 标准版,720P–4K,可生成原生音频
veo-3.1-fastVeo 3.1 快速版,出片更快,可生成原生音频
veo-3.1-liteVeo 3.1 轻量版,成本最低的一档

模型名里的 t2v 是文生视频,i2v 是图生视频;wan3.0-video 与三条 veo-* 都是文生 / 图生合一的模型, 同一个模型名两种用法都能跑。调用 GET /v1/models 可以拿到当前账号可用的准确清单。

Veo 的三条模型时长只支持 4 / 6 / 8 秒,缺省 8 秒; 传其它值上游会判 InvalidParameter。计费按上游回报的真实时长结算。 Veo 只做文生视频与图生视频,带 audio_url 或 video_url 会直接返回 400;数字人请换 wan2.2-s2v / videoretalk。

请求参数 ​

参数必填说明
model是模型名,取值见上表
prompt文生视频必填提示词
image_url图生视频必填首帧图地址;别名 image、first_frame_image、img_url 同样接受
audio_url数字人必填音频地址;别名 audio 同样接受。给了它就进数字人,见数字人板块
video_url视频对口型必填人物视频地址,配 audio_url 走视频对口型,见数字人板块
last_frame_url否尾帧图地址(Veo),必须同时提供首帧;别名 last_frame_image
reference_images否参考图列表(Veo),最多 3 张,与首尾帧不能同时使用;单张也可传 ref_image_url
negative_prompt否反向提示词
resolution / size否分辨率,同时影响计费档位。Veo 支持 720P / 1080P / 2K / 4K
aspect_ratio / ratio否宽高比。Veo 只支持 16:9 与 9:16,不传时按 size 的横竖推导,默认 16:9
duration否视频时长(秒)。Veo 只接受 4 / 6 / 8,缺省 8
audio_generation否仅 Veo:是否生成原生音频,enabled / disabled(也接受布尔值),默认 disabled;开启后按有声档计价
prompt_extend / seed否交由上游处理的扩展参数
enhance_prompt否仅 Veo:是否让上游扩写提示词,布尔值

其余字段也会带到上游

上表之外的键不会被丢掉:提示词类字段(prompt、negative_prompt、image_url、audio_url、video_url、ref_image_url、first_frame_url、last_frame_url)放进上游的 input,其余键原样透传进 parameters。 例外是视频对口型(videoretalk):它不分分辨率档位,resolution / size 会被忽略。 Veo 也不透传:它按上表字段重建上游报文,上表之外的键不会带到上游。

提交响应 ​

提交成功即刻返回(HTTP 200),此时视频还没生成好:

json
{
  "id": "task_...",
  "task_id": "task_...",
  "object": "video.generation",
  "created": 1699999999,
  "model": "wan3.0-video",
  "status": "queued",
  "progress": 0
}

id 与 task_id 是同一个值的两个别名,按客户端习惯取用即可。

轮询响应 ​

json
{
  "id": "task_...",
  "status": "succeeded",
  "progress": 100,
  "data": [{ "url": "https://..." }],
  "video_url": "https://..."
}
status含义
queued排队中
processing生成中
succeeded已完成,读 video_url 或 data[0].url
failed失败,读 error.message
expired超时未取走结果

轮询规则

轮询不计费。网关对上游的查询最多每 2 秒一次,更密的请求会由网关直接返回缓存状态,不会真的打到上游。 任务超过 30 分钟没有轮询到终态会转为 expired,此时预扣的费用不退还,所以提交后请及时轮询。

任务只对提交它的账号可见

轮询要带提交时用的那把密钥。换了密钥或换了账号来查,网关一律返回 404(错误码 task_not_found), 既查不到别人的任务,也不会泄漏任务是否存在。

请求示例 ​

bash
# 1. 提交任务
curl -X POST https://api.jcaigc.cn/v1/video/generations \
  -H "Authorization: Bearer 123e4567-e89b-12d3-a456-426614174000" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "prompt": "镜头缓慢推进,雨后的城市街道,霓虹倒影",
    "resolution": "720P",
    "duration": 5
  }'

# 2. 轮询结果,拿到 status=succeeded 即结束
curl https://api.jcaigc.cn/v1/video/generations/task_你的任务号 \
  -H "Authorization: Bearer 123e4567-e89b-12d3-a456-426614174000"

计费说明 ​

视频类任务按秒计费,提交时先按预估时长预扣,任务终结拿到真实用量后再结算差额。

模型分辨率单价
wan3.0-video480P0.3 元/秒
wan3.0-video720P0.6 元/秒
wan3.0-video1080P1.2 元/秒
happyhorse-1.1-t2v / happyhorse-1.1-i2v480P0.45 元/秒
happyhorse-1.1-t2v / happyhorse-1.1-i2v720P0.9 元/秒
happyhorse-1.1-t2v / happyhorse-1.1-i2v1080P1.2 元/秒
doubao-seedance-2.5720P1.6 元/秒
doubao-seedance-2.51080P3.8 元/秒
doubao-seedance-2.0480P0.45 元/秒
doubao-seedance-2.0720P1 元/秒
doubao-seedance-2.01080P2.5 元/秒
doubao-seedance-2.04K5 元/秒
doubao-seedance-2.0-fast480P / 720P0.36 / 0.8 元/秒
doubao-seedance-2.0-mini480P / 720P0.22 / 0.5 元/秒
veo-3.1720P无声 1.5 / 有声 3 元/秒
veo-3.11080P无声 1.5 / 有声 3 元/秒
veo-3.12K无声 2.25 / 有声 3.75 元/秒
veo-3.14K无声 3 / 有声 4.5 元/秒
veo-3.1-fast720P无声 0.75 / 有声 1.125 元/秒
veo-3.1-fast1080P无声 0.75 / 有声 1.125 元/秒
veo-3.1-fast2K无声 1.5 / 有声 1.875 元/秒
veo-3.1-fast4K无声 2.25 / 有声 2.625 元/秒
veo-3.1-lite720P无声 0.225 / 有声 0.375 元/秒
veo-3.1-lite1080P无声 0.375 / 有声 0.6 元/秒
veo-3.1-lite2K无声 0.6 / 有声 0.9 元/秒
veo-3.1-lite4K无声 0.75 / 有声 1.125 元/秒
wan2.2-s2v(图片说话)480P0.5 元/秒
wan2.2-s2v(图片说话)720P0.9 元/秒
videoretalk(视频对口型)不分档位0.08 元/秒
  • 失败任务全额退还;expired 任务不退还。
  • 提交时若判断不了最终时长,会先按 5 秒(Veo 按请求的 4 / 6 / 8 秒,缺省 8 秒)预估预扣,完成时按真实时长补退。
  • 未指定分辨率时按 720P 预扣,结算时按真实分辨率退还多扣部分。
  • 分辨率按模型各配一套价:写成该模型没有的档位(如给 wan3.0-video 传 4K)时,按它 720P 的价结算。
  • Veo 的无声 / 有声是两个价:请求里的 audio_generation 决定;不传即无声。任务终结时按上游回报的真实开关重算,不会出现「按无声收钱、生成了有声视频」。
  • 上表是网关的出厂价目表,线上实际生效的单价以控制台「模型与定价」展示的为准; 价目表里没有条目的模型一律拒绝调用(HTTP 503,error.type = model_not_priced),不会回落到任何默认价。

相关模块 ​

  • 数字人 — 图片说话与视频对口型两种方案,走同一个提交接口
  • 图像 — 先用文生图出首帧,再交给图生视频
  • 大语言模型 — 用模型批量生成提示词

最后更新于: