跳转到主要内容
POST
/
wan
/
api
/
v1
/
services
/
aigc
/
video-generation
/
video-synthesis
文生视频：根据文本提示词创建视频生成任务
curl --request POST \
  --url https://api.apiyi.com/wan/api/v1/services/aigc/video-generation/video-synthesis \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-DashScope-Async: <x-dashscope-async>' \
  --data '
{
  "model": "wan2.7-t2v",
  "input": {
    "prompt": "黄昏海边的灯塔，镜头缓慢推进，海浪轻拍礁石，海鸟叫声，电影级光影，稳定运镜"
  }
}
'
{
  "output": {
    "task_id": "c2e7570c-0af2-4eba-919f-3af3d1164a38",
    "task_status": "PENDING"
  },
  "request_id": "a23b81b0-0c05-9972-a6c9-ee757400afdb"
}

Documentation Index

Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt

Use this file to discover all available pages before exploring further.

右侧 Playground 可直接调试：在 Authorization 填 Bearer sk-your-api-key，填好 model / input / parameters 后发起请求。提交成功会返回 task_id，后续轮询与下载见下方说明。
本页是 wan2.7-t2v（文生视频）的创建接口。只需一段文本 prompt，无需 media。需要让图片动起来或保持主体特征，请改用 图生视频 / 参考图生视频。完整异步流程、状态表、Python 客户端见 Wan 概览。
  • 创建请求必须走 /wan/api/v1/services/aigc/video-generation/video-synthesis 并带请求头 X-DashScope-Async: enable，不要用 /v1/videos。
  • duration 必须是 整数（5 不是 "5"）；resolution 写 大写 720P。

​
代码示例

curl -X POST "https://api.apiyi.com/wan/api/v1/services/aigc/video-generation/video-synthesis" \
  -H "X-DashScope-Async: enable" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-t2v",
    "input": {
      "prompt": "黄昏海边的灯塔，镜头缓慢推进，海浪轻拍礁石，海鸟叫声，电影级光影，稳定运镜"
    },
    "parameters": {
      "resolution": "720P",
      "duration": 5,
      "prompt_extend": true,
      "watermark": true
    }
  }'

​
参数说明速查

参数类型必填默认说明
modelstring✓—固定 wan2.7-t2v
input.promptstring✓—文本提示词，建议描述场景、镜头运动、光线、风格
input.negative_promptstring—反向提示词，≤500 字符
parameters.resolutionstring720P720P / 1080P（大写）
parameters.ratiostring16:916:9 / 9:16 / 1:1 / 4:3 / 3:4
parameters.durationint52–15 秒整数
parameters.prompt_extendbooltrue智能改写，推荐开启
parameters.watermarkboolfalse右下角「AI 生成」水印
parameters.seedint随机0–2147483647，固定可复现

​
响应格式

创建成功返回 task_id（不是视频本身）： 
{
  "output": { "task_id": "c2e7570c-0af2-4eba-919f-3af3d1164a38", "task_status": "PENDING" },
  "request_id": "a23b81b0-0c05-9972-a6c9-ee757400afdb"
}
提交后需 轮询 GET /v1/tasks/{task_id} 直到 status: "completed"，再从响应的 result_url 下载 mp4。下载时 不要带 Authorization 头（OSS 签名直链），result_url 默认 24 小时过期。完整轮询循环与 Python 客户端见 Wan 概览 · 异步调用流程。

授权

​
Authorization
string
header
必填

在 API易控制台获取的 API Key

请求头

​
X-DashScope-Async
enum<string>
默认值:enable
必填

异步处理开关，必须设置为 enable，否则报 current user api does not support synchronous calls

可用选项:
enable

请求体

application/json
​
model
enum<string>
默认值:wan2.7-t2v
必填

模型 ID，文生视频固定 wan2.7-t2v（历史版本可填 wan2.6-t2v）

可用选项:
wan2.7-t2v,
wan2.6-t2v
​
input
object
必填
​
parameters
object

响应

任务已提交，返回 task_id 与 PENDING 状态

​
output
object
​
request_id
string

请求唯一标识，排查问题时提供给客服

示例:

"a23b81b0-0c05-9972-a6c9-ee757400afdb"