Files
agent-desktop/plugins/tool/wan27/README.md
T

91 lines
3.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 万相2.7 Video Generation Plugin
Generate high-quality videos using Alibaba Cloud's Wan 2.7 models via DashScope SDK.
## Tools
### `text_to_video_wan` - 文生视频
Generate videos from text descriptions.
**Parameters:**
- `prompt` (required): Video description (up to 5000 chars, Chinese/English)
- `resolution`: `"720P"` or `"1080P"` (default: `"720P"`)
- `ratio`: `"16:9"` / `"9:16"` / `"1:1"` / `"4:3"` / `"3:4"` (default: `"16:9"`)
- `duration`: 215 seconds (default: 5)
- `negative_prompt`: What to exclude from the video
- `audio_url`: Public HTTP/HTTPS URL for background audio (wav/mp3)
- `prompt_extend`: Enable prompt auto-optimization (default: true)
**Multi-shot example:**
```
第1个镜头[0-3秒] 全景:雨夜的纽约街头,霓虹灯闪烁
第2个镜头[3-6秒] 中景:侦探进入一栋老旧建筑
```
---
### `image_to_video_wan` - 图生视频
Generate videos from images. Supports 4 modes:
| Mode | Required inputs | Description |
|------|----------------|-------------|
| First-frame | `first_frame_url` | Generate video starting from this image |
| First-last-frame | `first_frame_url` + `last_frame_url` | Interpolate between two frames |
| Audio-driven | `first_frame_url` + `driving_audio_url` | Image animated by audio |
| Video-continuation | `first_clip_url` | Extend an existing video clip |
**Parameters:**
- `prompt` (required): Video description
- `first_frame_url`: URL or local image path (.png/.jpg/.jpeg/.webp)
- `last_frame_url`: URL or local image path (optional)
- `driving_audio_url`: Public HTTP/HTTPS URL only (wav/mp3, 2-30s)
- `first_clip_url`: Public HTTP/HTTPS URL only (for continuation)
- `resolution`: `"720P"` or `"1080P"` (default: `"720P"`)
- `duration`: 215 seconds (default: 5)
---
### `reference_to_video_wan` - 参考生视频
Generate videos with character/object reference consistency.
**Parameters:**
- `prompt` (required): Video description. Reference images as "图1", "图2", reference videos as "视频1", "视频2"
- `reference_images` (required): List of image URLs or local file paths
- `reference_videos`: List of public HTTP/HTTPS video URLs (optional)
- `first_frame_url`: URL or local image path for first-frame control (optional)
- `resolution`: `"720P"` or `"1080P"` (default: `"720P"`)
- `ratio`: Aspect ratio (default: `"16:9"`)
- `duration`: 215 seconds (default: 5)
**Prompt example:**
```
图1在图2的花园里散步,视频1走过来打招呼
```
---
## Configuration
Each tool has independent configuration fields:
| Field | Description | Default |
|-------|-------------|---------|
| `api_key` | DashScope API key (required) | — |
| `endpoint` | Regional API endpoint | `https://dashscope.aliyuncs.com/api/v1` |
| `timeout` | Request timeout in seconds | 600 |
**Endpoints:**
- Beijing: `https://dashscope.aliyuncs.com/api/v1`
- Singapore: `https://dashscope-intl.aliyuncs.com/api/v1`
> Note: API key and endpoint must be from the same region.
Get your API key at: https://bailian.console.aliyun.com/
## Output
Generated videos are saved to `{DEFAULT_MEDIA_DIR}/wan27/` as MP4 files. Video URLs from the API are valid for 24 hours.