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

# 整体调用流程

> 视频生成接口调用流程总览，帮助你快速上手。

视频生成接口为**异步接口**。提交任务后平台立即返回任务 ID，视频在后台生成完成后通过查询接口获取结果。

***

## 仅使用文本或公网 URL

适用于文生视频、图生视频（直接传公网 HTTPS URL）等简单场景。

```
POST /v1/videos/generations   →   返回 task id
GET  /v1/videos/generations/{id}  →  轮询直到 status=succeeded
↓
content.video_url  →  下载视频
```

1. 调用 `POST /v1/videos/generations` 提交任务。
2. 保存响应中的 `id`。
3. 轮询 `GET /v1/videos/generations/{id}` 查询任务状态（建议间隔 5–10 秒）。
4. `status=succeeded` 时，从 `content.video_url` 获取视频，**请及时下载转存**，URL 有有效期。

***

## 使用平台素材库（私域素材）

适用于需要复用已上传的图片、视频、音频素材的场景。

```
POST /v1/assets          →   返回 asset_id（status=processing）
GET  /v1/assets/{id}     →  轮询直到 status=active
↓
POST /v1/videos/generations  传入 asset://asset_id
GET  /v1/videos/generations/{id}  →  轮询直到 status=succeeded
↓
content.video_url  →  下载视频
```

1. 调用 `POST /v1/assets` 提交公网 HTTPS 素材 URL，或使用 `multipart/form-data` 上传本地文件。
2. 轮询 `GET /v1/assets/{id}`，等待 `status=active`。
3. 在视频生成请求的 `content[].*.url` 中传入 `asset://asset_xxx`，**必须保留 `asset://` 前缀**。
4. 按"仅使用公网 URL"的第 2–4 步完成任务提交与轮询。

***

## 接口清单

| 接口                                         | 方法   | 说明                                                          |
| ------------------------------------------ | ---- | ----------------------------------------------------------- |
| `/v1/videos/generations`                   | POST | 提交视频生成任务，立即返回任务 ID                                          |
| `/v1/videos/generations/{id}`              | GET  | 查询任务状态、视频结果和用量                                              |
| `/v1/grok-imagine/videos/generations`      | POST | 提交 Grok Imagine 图生视频任务，当前要求传入参考图                            |
| `/v1/grok-imagine/videos/generations/{id}` | GET  | 查询 Grok Imagine 视频任务状态、结果和按秒计费用量；部分配置会额外返回输入图 + 输出视频秒数的费用拆分 |
| `/v1/google-omni/videos/generations`       | POST | 提交 Gemini Omni 文生/图生视频任务                                    |
| `/v1/google-omni/videos/generations/{id}`  | GET  | 查询 Gemini Omni 视频任务状态、结果和按秒计费用量                             |
| `/v1/assets`                               | POST | 创建素材，支持公网 URL 或文件上传                                         |
| `/v1/assets/{id}`                          | GET  | 查询单个素材状态                                                    |
| `/v1/assets`                               | GET  | 查询素材列表，支持过滤和分页                                              |

***

<Note>
  Grok Imagine Video 001 仍使用 Grok Imagine 公开入口。可用模型名、时长、比例、分辨率和价格以 `/v1/models` 与控制台配置为准，详见 [Grok Imagine Video 001](/guides/grok-imagine-video-001)。
</Note>

***

## 轮询建议

<Warning>
  不要高频轮询，建议间隔 **5–10 秒**，最短不低于 3 秒。视频生成通常需要 30 秒至数分钟，高频请求不会加快结果返回。
</Warning>

***

## 支持的输入组合

| 输入类型                 | 场景                |
| -------------------- | ----------------- |
| 文本                   | 文生视频              |
| 文本（可选）+ 图片           | 图生视频，支持首帧、首尾帧、参考图 |
| 文本（可选）+ 视频           | 基于参考视频编辑或延长视频     |
| 文本（可选）+ 图片 + 音频      | 基于图片和参考音频生成视频     |
| 文本（可选）+ 图片 + 视频      | 多模态参考生视频          |
| 文本（可选）+ 视频 + 音频      | 基于参考视频和音频生成视频     |
| 文本（可选）+ 图片 + 视频 + 音频 | 多模态全参考生视频         |

<Note>
  音频不建议单独输入，应至少搭配图片或视频。
</Note>