万相 2.7 视频生成

万相（Wanx）2.7 是阿里巴巴通义系列下的视频生成模型，擅长生成风格多样、运动自然的视频内容，支持文生视频和图生视频两种模式，适合广告创意、短视频制作等场景。

在线体验

在 Playground 中测试 ↗ · 查看模型列表 ↗

快速开始

curl -X POST https://open.dieyuyun.com/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wanx2.1-t2v-turbo",
    "prompt": "古风少女在竹林中舞剑，慢动作，水墨画风格",
    "size": "1280x720",
    "duration": 5
  }'

请求端点

项目	值
方法	POST
路径	/v1/video/generations
Base URL	https://open.dieyuyun.com
兼容协议	OpenAI-compatible

认证

所有请求均需在请求头中携带 API Key：

Authorization: Bearer YOUR_API_KEY

标准请求字段

字段	类型	必填	默认值	说明
model	string	是	—	模型标识，如 wanx2.1-t2v-turbo
prompt	string	是	—	视频内容描述
size	string	否	1280x720	视频分辨率，支持 1280x720、720x1280、960x960、1920x1080
duration	integer	否	5	视频时长（秒），支持 5 或 10
image	string	否	—	参考图片 URL，用于图生视频模式
seed	integer	否	—	随机种子，用于结果复现

请求示例

cURL

curl -X POST https://open.dieyuyun.com/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wanx2.1-t2v-turbo",
    "prompt": "一杯咖啡从上方倒入白色瓷杯，慢动作特写，蒸汽袅袅升起",
    "size": "1280x720",
    "duration": 5,
    "seed": 42
  }'

Python

import requests

response = requests.post(
    "https://open.dieyuyun.com/v1/video/generations",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "model": "wanx2.1-t2v-turbo",
        "prompt": "一杯咖啡从上方倒入白色瓷杯，慢动作特写，蒸汽袅袅升起",
        "size": "1280x720",
        "duration": 5,
        "seed": 42
    }
)

task = response.json()
task_id = task["task_id"]
print(f"任务已创建: {task_id}")

Node.js

const response = await fetch('https://open.dieyuyun.com/v1/video/generations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'wanx2.1-t2v-turbo',
    prompt: '一杯咖啡从上方倒入白色瓷杯，慢动作特写，蒸汽袅袅升起',
    size: '1280x720',
    duration: 5,
    seed: 42,
  }),
})

const task = await response.json()
console.log('任务已创建:', task.task_id)

响应格式

视频生成为异步任务，提交后返回任务 ID，需轮询获取结果。

任务创建响应

{
  "task_id": "task_wx789",
  "status": "queued",
  "progress": 0,
  "created_at": "2025-01-15T10:30:00Z"
}

轮询任务状态

curl https://open.dieyuyun.com/v1/video/generations/task_wx789 \
  -H "Authorization: Bearer YOUR_API_KEY"

任务完成响应

{
  "task_id": "task_wx789",
  "status": "completed",
  "progress": 100,
  "metadata": {
    "url": "https://cdn.dieyuyun.com/videos/task_wx789.mp4",
    "duration": 5,
    "size": "1280x720",
    "seed": 42
  },
  "completed_at": "2025-01-15T10:33:00Z"
}

轮询示例

import time
import requests

# 提交任务
resp = requests.post(
    "https://open.dieyuyun.com/v1/video/generations",
    headers={"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"},
    json={"model": "wanx2.1-t2v-turbo", "prompt": "水墨画风格的山水动画", "duration": 5}
)
task_id = resp.json()["task_id"]

# 轮询结果
while True:
    status = requests.get(
        f"https://open.dieyuyun.com/v1/video/generations/{task_id}",
        headers={"Authorization": "Bearer YOUR_API_KEY"}
    ).json()

    if status["status"] == "completed":
        print(f"视频地址: {status['metadata']['url']}")
        break
    elif status["status"] == "failed":
        print("生成失败")
        break

    time.sleep(5)

异步任务

视频生成为异步任务。完整的任务轮询流程、状态说明和最佳实践，请参阅 异步任务。

最佳实践

1. 中英文 Prompt 均可：万相对中文理解优秀，也支持英文提示词
2. 风格关键词：加入风格描述如"水墨画风格"、"赛博朋克"、"电影质感"可显著提升画面风格化
3. 镜头描述：明确镜头运动（如"航拍"、"推镜头"、"慢动作"）有助于生成更符合预期的视频
4. 种子复现：使用 seed 参数可复现相同结果，便于微调和对比
5. 图生视频：提供首帧参考图片可精确控制视频的起始画面

速率限制

限制项	值
每分钟请求数	10 RPM
每日请求数	200 次/天
并发任务数	3

如需更高限额，请在 控制台 提交工单申请。