openclaw/docs
openclaw/docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(i18n): refresh zh-CN translations

Browse Source
This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-05 22:08:48 +00:00
parent 791d38a368
commit af8d98f78f
1 changed files with 43 additions and 39 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

82
docs/zh-CN/tools/video-generation.md
View File

@ -3,29 +3,29 @@ read_when:
- 通过智能体生成视频
- 配置视频生成提供商和模型
- 了解 `video_generate` 工具参数
summary: 使用已配置的提供商（如 OpenAI、Google、Qwen 和 MiniMax）生成视频
summary: 使用已配置的提供商（如 Alibaba、OpenAI、Google、Qwen 和 MiniMax）生成视频
title: 视频生成
x-i18n:
generated_at: "2026-04-05T21:08:34Z"
generated_at: "2026-04-05T22:08:48Z"
model: gpt-5.4
provider: openai
source_hash: a9c0304475c7e1ab2aa79cedbdbceb60ff44440459291244a25a73b8001e281d
source_hash: 2e2c4e263bdcf96eab5067c93cee6719890b3e05396fc948854ff4926576ca3a
source_path: tools/video-generation.md
workflow: 15
---
# 视频生成
`video_generate` 工具允许智能体使用你已配置的提供商来创建视频。生成的视频会作为媒体附件自动随智能体的回复一并发送。
`video_generate` 工具可让智能体使用你已配置的提供商创建视频。生成的视频会作为媒体附件自动随智能体的回复一并发送。
<Note>
只有当至少有一个视频生成提供商可用时，此工具才会显示。如果你在智能体的工具中看不到 `video_generate`，请配置 `agents.defaults.videoGenerationModel` 或设置提供商 API 密钥。
只有在至少有一个视频生成提供商可用时，此工具才会出现。如果你在智能体工具中看不到 `video_generate`，请配置 `agents.defaults.videoGenerationModel` 或设置提供商 API 密钥。
</Note>
## 快速开始
1. 为至少一个提供商设置 API 密钥（例如 `OPENAI_API_KEY`、`GEMINI_API_KEY` 或 `QWEN_API_KEY`）。
2. 可选：设置你的首选模型：
1. 为至少一个提供商设置 API 密钥（例如 `OPENAI_API_KEY`、`GEMINI_API_KEY`、`MODELSTUDIO_API_KEY` 或 `QWEN_API_KEY`）。
2. 可选：设置你偏好的模型：
```json5
{
@ -37,21 +37,23 @@ x-i18n:
}
```
3. 向智能体提出请求：_“生成一个 5 秒长的电影感视频，内容是一只友善的龙虾在日落时冲浪。”_
3. 向智能体提问：_“生成一段 5 秒钟的电影感视频，内容是一只友好的龙虾在日落时分冲浪。”_
智能体会自动调用 `video_generate`。无需将此工具加入允许列表——当提供商可用时，它默认启用。
智能体会自动调用 `video_generate`。无需将其加入工具允许列表——当提供商可用时，它默认启用。
## 支持的提供商
| 提供商 | 默认模型 | 参考输入 | API 密钥 |
| ------ | ------------------------------- | ------------------ | ---------------------------------------------------------- |
| BytePlus | `seedance-1-0-lite-t2v-250428` | 1 张图片 | `BYTEPLUS_API_KEY` |
| Alibaba | `wan2.6-t2v` | 是，远程 URL | `MODELSTUDIO_API_KEY`, `DASHSCOPE_API_KEY`, `QWEN_API_KEY` |
| BytePlus（国际版） | `seedance-1-0-lite-t2v-250428` | 1 张图片 | `BYTEPLUS_API_KEY` |
| fal | `fal-ai/minimax/video-01-live` | 1 张图片 | `FAL_KEY` |
| Google | `veo-3.1-fast-generate-preview` | 1 张图片或 1 个视频 | `GEMINI_API_KEY`、`GOOGLE_API_KEY` |
| Google | `veo-3.1-fast-generate-preview` | 1 张图片或 1 个视频 | `GEMINI_API_KEY`, `GOOGLE_API_KEY` |
| MiniMax | `MiniMax-Hailuo-2.3` | 1 张图片 | `MINIMAX_API_KEY` |
| OpenAI | `sora-2` | 1 张图片或 1 个视频 | `OPENAI_API_KEY` |
| Qwen | `wan2.6-t2v` | 是，远程 URL | `QWEN_API_KEY`、`MODELSTUDIO_API_KEY`、`DASHSCOPE_API_KEY` |
| Qwen | `wan2.6-t2v` | 是，远程 URL | `QWEN_API_KEY`, `MODELSTUDIO_API_KEY`, `DASHSCOPE_API_KEY` |
| Together | `Wan-AI/Wan2.2-T2V-A14B` | 1 张图片 | `TOGETHER_API_KEY` |
| xAI | `grok-imagine-video` | 1 张图片或 1 个视频 | `XAI_API_KEY` |
使用 `action: "list"` 可在运行时查看可用的提供商和模型：
@ -61,24 +63,24 @@ x-i18n:
## 工具参数
| 参数 | 类型 | 说明 |
| ----------------- | -------- | ------------------------------------------------------------------------------------- |
| `prompt` | string | 视频生成提示词（`action: "generate"` 时必填） |
| `action` | string | `"generate"`（默认）或 `"list"`，用于查看提供商 |
| `model` | string | 提供商/模型覆盖值，例如 `qwen/wan2.6-t2v` |
| `image` | string | 单个参考图片路径或 URL |
| `images` | string[] | 多个参考图片（最多 5 张） |
| `video` | string | 单个参考视频路径或 URL |
| `videos` | string[] | 多个参考视频（最多 4 个） |
| `size` | string | 当提供商支持时的尺寸提示 |
| `aspectRatio` | string | 宽高比：`1:1`、`2:3`、`3:2`、`3:4`、`4:3`、`4:5`、`5:4`、`9:16`、`16:9`、`21:9` |
| `resolution` | string | 分辨率提示：`480P`、`720P` 或 `1080P` |
| `durationSeconds` | number | 目标时长（秒） |
| `audio` | boolean | 当提供商支持时，启用生成音频 |
| `watermark` | boolean | 当支持时，切换提供商水印 |
| `filename` | string | 输出文件名提示 |
| 参数 | 类型 | 描述 |
| ----------------- | -------- | ----------------------------------------------------------------------------------- |
| `prompt` | string | 视频生成提示词（`action: "generate"` 时必填） |
| `action` | string | `"generate"`（默认）或 `"list"`，用于查看提供商 |
| `model` | string | 提供商/模型覆盖，例如 `qwen/wan2.6-t2v` |
| `image` | string | 单个参考图片路径或 URL |
| `images` | string[] | 多个参考图片（最多 5 张） |
| `video` | string | 单个参考视频路径或 URL |
| `videos` | string[] | 多个参考视频（最多 4 个） |
| `size` | string | 当提供商支持时的尺寸提示 |
| `aspectRatio` | string | 宽高比：`1:1`、`2:3`、`3:2`、`3:4`、`4:3`、`4:5`、`5:4`、`9:16`、`16:9`、`21:9` |
| `resolution` | string | 分辨率提示：`480P`、`720P` 或 `1080P` |
| `durationSeconds` | number | 目标时长（秒） |
| `audio` | boolean | 当提供商支持时，启用生成音频 |
| `watermark` | boolean | 当支持时，切换提供商水印 |
| `filename` | string | 输出文件名提示 |
并非所有提供商都支持全部参数。该工具会在提交请求前验证提供商能力限制。
并非所有提供商都支持所有参数。该工具会在提交请求前验证提供商能力限制。
## 配置
@ -103,27 +105,29 @@ x-i18n:
1. 工具调用中的 **`model` 参数**（如果智能体指定了该参数）
2. 配置中的 **`videoGenerationModel.primary`**
3. 按顺序尝试 **`videoGenerationModel.fallbacks`**
4. **自动检测** —— 仅使用有凭证支持的提供商默认值：
- 当前默认提供商优先
- 其余已注册的视频生成提供商按 provider-id 顺序
3. 按顺序使用 **`videoGenerationModel.fallbacks`**
4. **自动检测** —— 仅使用有凭证支持的默认提供商：
- 先使用当前默认提供商
- 再按提供商 ID 顺序使用其余已注册的视频生成提供商
如果某个提供商失败，会自动尝试下一个候选项。如果全部失败，错误信息会包含每次尝试的详细信息。
## 提供商说明
- Alibaba 使用 DashScope / Model Studio 异步视频端点，目前要求参考资源使用远程 `http(s)` URL。
- Google 使用 Gemini/Veo，支持单个图片或视频参考输入。
- MiniMax、Together、BytePlus（国际版）和 fal 当前支持单个图片参考输入。
- OpenAI 使用原生视频端点，目前默认使用 `sora-2`。
- Google 使用 Gemini/Veo，并支持单个图片或视频参考输入。
- MiniMax、Together、BytePlus 和 fal 目前支持单个图片参考输入。
- Qwen 支持图片/视频参考，但上游 DashScope 视频端点目前要求这些参考输入必须是远程 `http(s)` URL。
- Qwen 支持图片/视频参考，但上游 DashScope 视频端点目前要求这些参考使用远程 `http(s)` URL。
- xAI 使用原生 xAI 视频 API，支持文生视频、图生视频，以及远程视频编辑/扩展流程。
## Qwen 参考输入
内置的 Qwen 提供商支持文生视频以及图片/视频参考模式，但上游 DashScope 视频端点目前要求参考输入必须是**远程 http(s) URL**。本地文件路径和上传的缓冲区会在一开始就被拒绝，而不是被静默忽略。
内置的 Qwen 提供商支持文生视频以及图片/视频参考模式，但上游 DashScope 视频端点目前要求参考输入必须为**远程 http(s) URL**。本地文件路径和上传的缓冲区会在前置检查时直接被拒绝，而不是被静默忽略。
## 相关内容
- [工具概览](/zh-CN/tools) — 所有可用的智能体工具
- [Qwen](/zh-CN/providers/qwen) — Qwen 专属设置和限制
- [Qwen](/zh-CN/providers/qwen) — Qwen 专属设置与限制
- [配置参考](/zh-CN/gateway/configuration-reference#agent-defaults) — `videoGenerationModel` 配置
- [模型](/zh-CN/concepts/models) — 模型配置与故障转移
- [模型](/zh-CN/concepts/models) — 模型配置与故障切换