---
url: /video.md
description: >-
  简创AIGC 视频能力文档：文生视频与图生视频接口 POST /v1/video/generations，基地址
  https://api.jcaigc.cn/v1，异步任务按秒计费（0.08~5 元/秒），支持万相 wan3.0-video、HappyHorse
  happyhorse-1.1、豆包 doubao-seedance-2.x 与 Veo 3.1 系列模型。
---

# 视频

[← 返回全部能力](/)

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

## 接口一览

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

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

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

### 支持的模型

| 模型 | 类型 |
|------|------|
| `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` 同样接受。给了它就进数字人，见[数字人板块](/avatar/) |
| `video_url` | 视频对口型必填 | 人物视频地址，配 `audio_url` 走视频对口型，见[数字人板块](/avatar/) |
| `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：是否让上游扩写提示词，布尔值 |

::: tip 其余字段也会带到上游
上表之外的键不会被丢掉：提示词类字段（`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` | 超时未取走结果 |

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

::: warning 任务只对提交它的账号可见
轮询要带**提交时用的那把密钥**。换了密钥或换了账号来查，网关一律返回 `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`），不会回落到任何默认价。

## 相关模块

* [数字人](/avatar/) — 图片说话与视频对口型两种方案，走同一个提交接口
* [图像](/image/) — 先用文生图出首帧，再交给图生视频
* [大语言模型](/llm/) — 用模型批量生成提示词
