主题切换
视频
用一段提示词,或用一张首帧图加一段提示词,生成一段短视频。提交是异步的:先拿任务号,再轮询取结果。
接口一览
| 接口 | 方法与路径 | 说明 |
|---|---|---|
| 提交生成任务 | 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-fast | 2.0 快速版,只出 480P / 720P |
doubao-seedance-2.0-mini | 2.0 经济版,480P / 720P,批量出片成本最低 |
veo-3.1 | Veo 3.1 标准版,720P–4K,可生成原生音频 |
veo-3.1-fast | Veo 3.1 快速版,出片更快,可生成原生音频 |
veo-3.1-lite | Veo 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-video | 480P | 0.3 元/秒 |
wan3.0-video | 720P | 0.6 元/秒 |
wan3.0-video | 1080P | 1.2 元/秒 |
happyhorse-1.1-t2v / happyhorse-1.1-i2v | 480P | 0.45 元/秒 |
happyhorse-1.1-t2v / happyhorse-1.1-i2v | 720P | 0.9 元/秒 |
happyhorse-1.1-t2v / happyhorse-1.1-i2v | 1080P | 1.2 元/秒 |
doubao-seedance-2.5 | 720P | 1.6 元/秒 |
doubao-seedance-2.5 | 1080P | 3.8 元/秒 |
doubao-seedance-2.0 | 480P | 0.45 元/秒 |
doubao-seedance-2.0 | 720P | 1 元/秒 |
doubao-seedance-2.0 | 1080P | 2.5 元/秒 |
doubao-seedance-2.0 | 4K | 5 元/秒 |
doubao-seedance-2.0-fast | 480P / 720P | 0.36 / 0.8 元/秒 |
doubao-seedance-2.0-mini | 480P / 720P | 0.22 / 0.5 元/秒 |
veo-3.1 | 720P | 无声 1.5 / 有声 3 元/秒 |
veo-3.1 | 1080P | 无声 1.5 / 有声 3 元/秒 |
veo-3.1 | 2K | 无声 2.25 / 有声 3.75 元/秒 |
veo-3.1 | 4K | 无声 3 / 有声 4.5 元/秒 |
veo-3.1-fast | 720P | 无声 0.75 / 有声 1.125 元/秒 |
veo-3.1-fast | 1080P | 无声 0.75 / 有声 1.125 元/秒 |
veo-3.1-fast | 2K | 无声 1.5 / 有声 1.875 元/秒 |
veo-3.1-fast | 4K | 无声 2.25 / 有声 2.625 元/秒 |
veo-3.1-lite | 720P | 无声 0.225 / 有声 0.375 元/秒 |
veo-3.1-lite | 1080P | 无声 0.375 / 有声 0.6 元/秒 |
veo-3.1-lite | 2K | 无声 0.6 / 有声 0.9 元/秒 |
veo-3.1-lite | 4K | 无声 0.75 / 有声 1.125 元/秒 |
wan2.2-s2v(图片说话) | 480P | 0.5 元/秒 |
wan2.2-s2v(图片说话) | 720P | 0.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),不会回落到任何默认价。
