---
title: 视频生成与管理接口 (Videos)
description: 使用 /v1/videos 提交、查询、下载或重混视频任务，并按异步终态处理结果。
lastUpdated: 2026-08-04
---

视频生成通常耗时较长，接口采用“提交任务 + 查询状态”的方式。

## 提交视频生成任务

> **标准端点：** `POST /v1/videos`
> **身份认证：** `Authorization: Bearer 您的API_KEY`

提交任务后，接口不会立刻返回视频，而是会返回一个 **任务 ID (task_id)**。

### 核心参数说明表

| 参数名称 | 是否必填 | 参数说明 |
| :--- | :--- | :--- |
| **model** | **必填** | 视频模型 ID，例如 `kling-v2-6`。请以模型广场当前列表为准。 |
| **prompt** | **必填** | 文字描述提示词，越详细生成的画面越贴合想象。 |
| **input_reference** | 选填 | 参考图片文件，图生视频时使用。 |
| **seconds** | 选填 | 视频时长，支持范围由所选模型决定。 |
| **size** | 选填 | 视频尺寸，支持范围由所选模型决定。 |

## 查询视频任务状态

获取到任务 ID (task_id) 后，您需要在业务系统中定期（例如每隔 5-10 秒）通过 GET 请求查询该任务的处理状态。

> **查询端点：** `GET /v1/videos/{task_id}`
> **身份认证：** `Authorization: Bearer 您的API_KEY`

### 状态说明

1. **queued**：任务已受理，正在排队等待集群算力分配。
2. **in_progress**：AI 正在渲染生成视频。
3. **completed**：生成完成。根据响应中的结果字段获取视频，或调用 `GET /v1/videos/{task_id}/content` 下载内容。
4. **failed**：生成失败。接口会一并返回失败原因（常见原因为提示词触发了内容风控审查）。

## 下载或重混视频

- 下载已完成视频：`GET /v1/videos/{task_id}/content`
- 基于已有视频生成新版本：`POST /v1/videos/{video_id}/remix`

重混只适用于支持该能力的原任务和线路。