跳到正文

Wan 3.0 API

快速、实惠的文生视频。

价格
分辨率文本、图片或视频
480p文本、图片或视频10 积分/秒 ($0.05/秒)
720p文本、图片或视频19 积分/秒 ($0.095/秒)比 fal 便宜 5% fal 价格 $0.10/秒
1080p文本、图片或视频38 积分/秒 ($0.19/秒)比 fal 便宜 5% fal 价格 $0.20/秒

含视频输入时,输入和输出的秒数都计费。

完整价格 ↓
分辨率
2 到 30 秒。使用参考视频时,输入与输出合计不超过 30 秒。
由模型决定时长,最长 30 秒,按实际时长扣费。
画面比例
自适应会沿用输入素材的画面比例。
生成音轨。
高级设置
相同的种子和设置会得到相近的结果。留空则随机。

正在确认登录状态。

登录后即可生成。这里填写的内容和选择的文件会保留,登录回来后继续。

生成结果会显示在这里

价格

价格自 2026-11-09 起生效

档位价格
480p
10 积分/秒 ($0.05/秒)注 12–30 秒
480p(含视频输入)
480p-video
10 积分/秒 ($0.05/秒)注 2, 32–30 秒
720p
19 积分/秒 ($0.095/秒)注 12–30 秒
720p(含视频输入)
720p-video
19 积分/秒 ($0.095/秒)注 2, 32–30 秒
1080p
38 积分/秒 ($0.19/秒)注 12–30 秒
1080p(含视频输入)
1080p-video
38 积分/秒 ($0.19/秒)注 2, 32–30 秒
  1. 最多冻结 30 秒,按实际时长扣费。
  2. 费率同时适用于输入和输出的秒数。
  3. 最多冻结 30 秒输出加 15 秒输入,按实际时长扣费。

1 积分 ≈ $0.005。按标准充值包计算;较大的充值包含赠送积分,实际单价更低。

720p:fal $0.10/秒,VizoAPI $0.095/秒,低 5%。

交付与计费

成品
成品文件列在任务结果中,每个文件有素材 ID 和类型。
下载
文件保存 7 天,通过短期签名链接下载,可随时删除。
计费
任务受理时冻结积分,交付后扣费。生成失败,或 24 小时内未交付,冻结的积分会全部释放。
通知
按任务 ID 轮询,或使用签名 Webhook,并按 event_id 去重。
如何计费?
按输出秒数计费。

API 参考

任务只创建一次,之后按 ID 查询。 完整脚本(含上传和下载) · API 文档

请求示例
API=https://api.vizoapi.com/v1
AUTH="Authorization: Bearer $VIZO_API_KEY"

# Create the task once and keep its ID.
ID=$(curl -fsS $API/generations -H "$AUTH" -H "Content-Type: application/json" \
  -d '{
  "model": "wan-3-0",
  "input": {
    "prompt": "雨夜霓虹街道的缓慢推镜",
    "parameters": {
      "ratio": "16:9",
      "duration": 5
    }
  },
  "metadata": {
    "client_reference": "my-unique-reference-1"
  }
}' | jq -r .id)

# Poll until the task closes, then read its status and result.
until curl -fsS $API/generations/$ID -H "$AUTH" | jq -e '.closed_at != null' > /dev/null; do sleep 5; done
curl -fsS $API/generations/$ID -H "$AUTH" | jq '{status, result}'
全部字段

在 input 中发送这些字段。表中没有的字段会被拒绝,返回 HTTP 422 invalid_input。

  • Send a prompt, media or both.
  • first_frame and last_frame (at most one each) cannot be combined with reference items, file or link.
  • Reference videos total at most 15 seconds, reference audios at most 15 seconds, and reference video input plus output length at most 30 seconds.
请求参数
字段说明
promptstring

必填:prompt 或 media 至少一个

Up to 20000 characters. Cite media in order, for example image 1 or video 1. Send a prompt, media or both.

最多 20,000 个字符

mediaarray of objects

必填:prompt 或 media 至少一个

first_frame and last_frame (at most 1 each) cannot be combined with reference items, file or link. Up to 10 reference images, 5 reference videos (15 seconds in total) and 5 reference audios; at most one file or one link, not both.

至少 1 项 · 最多 22 项

media[].typestring必填

Media kind.

可选值first_framelast_framereference_imagereference_videoreference_audiofilelink
media[].urlstring必填

An https URL or an uploaded asset id (ast_...). file and link take a public https URL only.

最多 4000 个字符 · 格式^(https://|ast_)

parametersobject必填
parameters.resolutionstring可选

Output resolution. Defaults to 720P.

可选值480P720P1080P

默认值 720P

parameters.ratiostring可选

Output aspect ratio. Defaults to adaptive.

可选值adaptive16:94:31:13:49:16

默认值 adaptive

parameters.durationany必填

Output seconds, 2 to 30, or -1 for automatic length. Holds the maximum; known input reduces it to fit the 30-second total.

2 到 30,或 -1

parameters.audioboolean可选

Adds a soundtrack. Defaults to true.

默认值 true

parameters.seedinteger可选

Random seed.

最小 0 · 最大 2,147,483,647

parameters.watermarkboolean可选

Add a visible watermark. Defaults to false; the tier price is unchanged.

默认值 false

完整请求与响应示例

完整的创建请求、202 响应,以及任务成功后的状态。 此输入选择 480p 档位,每秒 10 积分。5 秒共冻结 50.000 积分。

请求

{
  "model": "wan-3-0",
  "input": {
    "prompt": "A paper boat drifting on a pond at dawn, slow dolly in",
    "parameters": {
      "ratio": "16:9",
      "duration": 5
    }
  },
  "metadata": {
    "client_reference": "my-unique-reference-1"
  }
}

202 已受理

{
  "id": "gen_01JD8Z5QW3XR",
  "model": "wan-3-0",
  "source": "api",
  "created_at": "2026-11-08T09:00:00Z",
  "customer_resolution_deadline": "2026-11-09T09:00:00Z",
  "late_result_available": false,
  "metadata": {
    "client_reference": "my-unique-reference-1"
  },
  "status": "processing",
  "execution_status": "processing",
  "delivery_status": "pending",
  "billing_status": "pending",
  "version": 1,
  "price": {
    "unit": "credit",
    "estimated": "50.000",
    "reserved": "0.000",
    "charged": "0.000",
    "refunded": "0.000"
  },
  "allowed_actions": [],
  "closed_at": null,
  "error": null,
  "result": null
}

200 已成功

{
  "id": "gen_01JD8Z5QW3XR",
  "model": "wan-3-0",
  "source": "api",
  "created_at": "2026-11-08T09:00:00Z",
  "customer_resolution_deadline": "2026-11-09T09:00:00Z",
  "late_result_available": false,
  "metadata": {
    "client_reference": "my-unique-reference-1"
  },
  "status": "succeeded",
  "execution_status": "succeeded",
  "delivery_status": "ready",
  "billing_status": "settled",
  "version": 4,
  "price": {
    "unit": "credit",
    "estimated": "50.000",
    "reserved": "0.000",
    "charged": "50.000",
    "refunded": "0.000"
  },
  "allowed_actions": [],
  "closed_at": "2026-11-08T09:01:31Z",
  "error": null,
  "result": {
    "asset_id": "ast_01JD8Z9M2C4V",
    "outputs": [
      {
        "index": 0,
        "asset_id": "ast_01JD8Z9M2C4V",
        "content_type": "video/mp4"
      }
    ]
  }
}

Wan 3.0 完整 API 参考