> ## Documentation Index
> Fetch the complete documentation index at: https://docs.senseaudio.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 视频生成介绍

> 视频生成能力总览

SenseAudio 视频生成服务面向短视频创作、营销素材制作、内容可视化和创意分镜生成等场景，提供统一的视频生成 API。开发者可以通过文本描述或图像参考快速创建视频任务，并通过状态查询接口获取生成进度与最终结果。

## 什么是视频生成

视频生成能力支持从文字或图片描述中自动生成短视频内容，适合用于创意预演、广告素材生成和内容工业化生产。

**核心能力**：

* **文生视频**：通过自然语言提示词直接生成视频
* **图生视频**：支持参考图、首帧图、首尾帧图约束视频生成
* **多模视频**：支持参考图、参考视频、参考音频用于视频生成
* **参数可控**：支持设置时长、分辨率、宽高比和模型专属参数
* **任务式生成**：通过任务创建 + 状态查询完成完整生成流程

## 模型版本

当前视频生成模块已明确支持以下模型：

| 模型             | 特点                           | 适用场景            |
| :------------- | :--------------------------- | :-------------- |
| `Seedance-2.0` | 支持文生视频、首尾帧生视频、参考图生视频、多模态生成视频 | 短视频创作、动画创作、商业素材 |

## API 能力概览

SenseAudio 视频生成提供以下核心 API 接口：

### 1. 创建视频生成任务

用于提交视频生成任务，支持文本生成视频、图生视频等模式。

* 文档：**[创建视频生成任务](/api-reference/endpoint/video/create)**
* 接口地址：`POST https://api.senseaudio.cn/v1/video/create`

### 2. 查询视频生成状态

用于根据任务 ID 查询当前进度、状态和最终生成结果。

* 文档：**[查询视频生成状态](/api-reference/endpoint/video/status)**
* 接口地址：`GET https://api.senseaudio.cn/v1/video/status`

## 参数建议

| 参数           | 建议                                        | 说明           |
| :----------- | :---------------------------------------- | :----------- |
| `content`    | 文本描述尽量包含主体、动作、场景和风格                       | 有助于提升结果稳定性   |
| `ratio`      | 根据投放渠道选择 `16:9`、`9:16`、`4:3`、`3:4`、`1:1`  | 横屏、竖屏场景对应不同  |
| `resolution` | 对视频生成速度有要求使用 `720p`，对视频清晰度有更高要求使用 `1080p` | 兼顾生成速度与清晰度   |
| `duration`   | 先用较短时长测试，再放大                              | 更适合快速验证提示词效果 |

## 计费说明

请参考 **[计费规则](/guides/account/billing)**。

## 典型应用场景

### 短视频内容制作

用于生成营销短片、产品展示视频、账号运营视频等高频视觉内容。

### 广告创意预演

在正式拍摄或外包制作之前，先快速验证创意分镜、画面风格与节奏方向。

### 电商与品牌宣传

结合商品卖点、品牌风格和活动文案，快速生成适合推广投放的视频素材。

## 开始使用

<Steps>
  <Step title="获取 API Key">
    前往 [API 密钥](https://senseaudio.cn/api-platform/api-key) 创建您的 API Key。
  </Step>

  <Step title="组织提示词或准备参考图">
    按照主体、动作、场景、风格组织文本描述，或准备首帧、末帧、参考图素材。
  </Step>

  <Step title="创建视频任务">
    调用 [创建视频生成任务](/api-reference/endpoint/video/create) 提交生成请求，记录返回的 `task_id` 用于后续状态查询。
  </Step>

  <Step title="轮询并获取结果">
    调用 [查询视频生成状态](/api-reference/endpoint/video/status) 轮询当前状态，任务完成后获取视频 URL、缩略图与 GIF 预览。
  </Step>
</Steps>

## 相关资源

<CardGroup cols={2}>
  <Card title="创建视频任务" icon="video" href="/api-reference/endpoint/video/create">
    提交文生视频或图生视频任务。
  </Card>

  <Card title="查询视频状态" icon="clock" href="/api-reference/endpoint/video/status">
    根据 `task_id` 获取生成进度与结果。
  </Card>

  <Card title="计费规则" icon="credit-card" href="/guides/account/billing">
    查看视频生成的积分消耗规则。
  </Card>
</CardGroup>