Wan 3.0 Video

Model ID alibaba/wan-3.0-video

概览

一个端点根据请求中的媒体字段自动选择文生视频、关键帧图生视频或参考生视频；关键帧输入与参考输入不可混用。

Alibaba · text-image-reference-to-video

输入模式

请求中实际发送的媒体字段决定运行哪一种能力：

重要: 关键帧模式（image/end_image）与参考模式（images/videos/audios）互斥，同一请求不可混用两组字段。

接口

POST /v1/video/generations

认证

Authorization: Bearer <AIAPIAIAPI_API_KEY>

请求体

model

类型：string · 必填：是 · 可空：否

用于路由请求的模型 ID。

prompt

类型：string · 必填：否 · 可空：否

文本提示词。单独使用时生成文生视频；参考模式下，可按媒体类型分别使用从 1 开始的序号引用，例如 Image 1、Video 1 和 Audio 1。

image

类型：string · 必填：否 · 可空：否

关键帧模式的首帧图片。不可与 images、videos 或 audios 同时使用。

end_image

类型：string · 必填：否 · 可空：否

关键帧模式的尾帧图片。可单独使用或与 image 一起使用，但不可与参考模式字段混用。

images

类型：array · 必填：否 · 可空：否

参考模式图片，最多 10 张；在 prompt 中按 Image 1、Image 2 等方式引用。

videos

类型：array · 必填：否 · 可空：否

参考模式视频，最多 5 个 HTTPS URL；在 prompt 中按 Video 1、Video 2 等方式引用。

audios

类型：array · 必填：否 · 可空：否

参考模式音频，最多 5 个 HTTPS URL；在 prompt 中按 Audio 1、Audio 2 等方式引用。

audio_enable

类型：boolean · 必填：否 · 可空：否

是否同时生成视频音频，默认 true。

duration

类型：integer · 必填：否 · 可空：否

视频时长，支持 2 到 30 秒；设为 -1 时使用智能时长。

resolution

类型：string · 必填：否 · 可空：否

输出分辨率，不区分大小写地支持 480p、720p 或 1080p；默认 1080p。

aspect_ratio

类型：string · 必填：否 · 可空：否

输出宽高比，默认 adaptive；还支持 16:9、4:3、1:1、3:4 和 9:16。

seed

类型：integer · 必填：否 · 可空：否

用于复现结果的随机种子，范围为 0 到 2147483647；省略时随机生成。

请求示例

curl --request POST \
  --url https://aiapiaiapi.com/v1/video/generations \
  --header 'Authorization: Bearer $AIAPIAIAPI_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
      "model": "alibaba/wan-3.0-video",
      "prompt": "A cinematic camera movement through a forest",
      "duration": 5,
      "resolution": "1080p"
    }'

JSON

{
  "model": "alibaba/wan-3.0-video",
  "prompt": "A cinematic camera movement through a forest",
  "duration": 5,
  "resolution": "1080p"
}

响应

{
  "id": "vid_01K2ABC123",
  "object": "video.generation",
  "model": "alibaba/wan-3.0-video",
  "status": "queued",
  "progress": null,
  "outputs": [],
  "created_at": 1786960800,
  "started_at": null,
  "completed_at": null,
  "error": null
}

任务状态

使用创建响应中的 id 作为 task_id：

GET /v1/video/generations/{task_id}

{
  "id": "vid_01K2ABC123",
  "object": "video.generation",
  "model": "alibaba/wan-3.0-video",
  "status": "completed",
  "progress": 100,
  "outputs": [
    { "type": "video", "url": "https://cdn.example.com/videos/vid_01K2ABC123.mp4" }
  ],
  "created_at": 1786960800,
  "started_at": 1786960805,
  "completed_at": 1786960900,
  "error": null
}

错误响应

参数校验错误返回 HTTP 400，并包含稳定的错误代码。

{
  "error": {
    "type": "invalid_request_error",
    "code": "unsupported_value",
    "message": "The parameter value is not supported by this model.",
    "param": "duration"
  }
}