Wan 3.0 Video Prime API：价格、模式与 Python 设置

Wan 3.0 Video Prime 是 reAPI 上的高速 Wan 3.0 路由。 它可以从文本、首帧和末帧、混合参考媒体、文档或公开网页生成 2–30 秒的视频。wire model id 为 wan3.0-video-prime，任务通过 reAPI 标准视频端点异步运行。^[1]

Prime 比标准 Wan 3.0 费用更高，因此只有在等待时间对产品至关重要时才有意义，而不仅仅是因为"Prime"听起来更好。没有公开的固定延迟保证，实际完成时间仍取决于时长、分辨率、输入和服务负载。

TL;DR

端点： POST https://reapi.ai/api/v1/videos/generations
模型： wan3.0-video-prime
输出： 2–30 秒，支持 480P、720P 或 1080P
输入： 文本、一张或两张帧、参考图像/视频/音频、一个文档或一个公开网页
音频： 默认包含；关闭音频不会降低费率
当前 reAPI 费率： 480P 为 $0.068/秒，720P 为 $0.139/秒，1080P 为 $0.278/秒
成本陷阱： 省略分辨率会默认为 1080P，而 duration: -1 会预留 30 秒的上限

Wan 3.0 Video Prime API 价格

reAPI 按输出时长和分辨率对 Prime 计费。输入类型不会改变单位秒价格，因此十秒的文档驱动视频与同一分辨率的十秒文本转视频任务成本相同。^[1]

分辨率	当前费率	5 秒	10 秒	30 秒
480P	$0.068/秒	$0.34	$0.68	$2.04
720P	$0.139/秒	$0.70	$1.39	$4.17
1080P	$0.278/秒	$1.39	$2.78	$8.34

这些是 2026 年 8 月 26 日的 reAPI 网关价格，不是阿里巴巴降低自身价格的公告。在将费率放入面向客户的计算器之前，请查看实时的 Wan 3.0 Video Prime 模型页。

对于探索阶段，480P 可以使重试成本保持低廉。只在运动、时序和参考行为令人接受后，再将提示词移到 720P 或 1080P。更高的分辨率无法修复拙劣的摄像机移动或超负荷的简介。

Wan 3.0 Video Prime API 模式：文本、帧、参考、文档和网页

五种模式共享一个 model id

Prime 没有 mode 参数。请求中的字段决定运行哪个工作流。

工作流	发送的字段	主要约束
文本转视频	`prompt`	需要 prompt
首帧	`first_frame_url`	公开图像 URL
首帧+末帧	`first_frame_url`、`last_frame_url`	帧按顺序显式排列
参考转视频	`reference_image_urls`、`reference_video_urls` 和/或 `reference_audio_urls`	至少一个参考加一个 prompt
文档或网页	`reference_file_urls` 或 `reference_link_urls`	选择其一；不要结合使用

帧字段不能与 reference_*_urls 混合。包含首帧和参考图像的请求是歧义的，将被拒绝。每个资产也必须通过公开 HTTP(S) URL 可达；不接受 base64 和 data: URI。^[1]

参考限制很宽松但有限：最多十张图像、五个视频剪辑和五个音频剪辑。参考视频总时长不超过 15 秒，其总长度加请求的输出必须保持在 30 秒内。因此，12 秒的参考视频最多只留 18 秒给生成的剪辑。

一个有效的 Python 请求

最安全的首次调用明确设置 duration、分辨率、宽高比和音频。这样可以使账单可预测，并使请求易于重现。

import time

import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://reapi.ai/api/v1"
HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
}

payload = {
    "model": "wan3.0-video-prime",
    "prompt": (
        "One continuous shot of a lighthouse keeper climbing a spiral "
        "staircase at dawn. The camera follows two steps behind. Warm "
        "window light crosses the walls; distant gulls and quiet surf."
    ),
    "resolution": "720P",
    "aspect_ratio": "16:9",
    "duration": 10,
    "audio": True,
}

response = requests.post(
    f"{BASE_URL}/videos/generations",
    headers=HEADERS,
    json=payload,
    timeout=30,
)
response.raise_for_status()
task_id = response.json()["id"]

deadline = time.time() + 600
while time.time() < deadline:
    status_response = requests.get(
        f"{BASE_URL}/tasks/{task_id}",
        headers=HEADERS,
        timeout=30,
    )
    status_response.raise_for_status()
    task = status_response.json()

    if task["status"] == "completed":
        print(task["output"]["video_urls"][0])
        print("credits used:", task["usage"]["credits"])
        break

    if task["status"] == "failed":
        raise RuntimeError(task.get("error") or "Generation failed")

    time.sleep(6)
else:
    raise TimeoutError(f"Task {task_id} is still processing")

在轮询前保存任务 id。如果客户端进程重启，该 id 足以恢复状态检查而无需为另一次生成付费。失败的任务会自动退款，但急躁的重复提交会在两个都成功时产生第二个可计费的任务。^[1]

首末帧对比参考图像

当开场或结尾构图是不可协商的时，使用帧模式。一张图像固定首帧；两张图像按顺序定义首帧和末帧。prompt 应该描述它们之间的运动，而不是重申每个可见对象。

当图像提供身份、衣柜、产品形状或视觉语言而不是作为精确边界帧时，使用参考模式。按数组内的位置命名资产：

{
  "model": "wan3.0-video-prime",
  "prompt": "Keep Image1 as the performer and Image2 as the coat. Use the walking pace from Video1 and the room tone from Audio1.",
  "reference_image_urls": [
    "https://cdn.example.com/performer.jpg",
    "https://cdn.example.com/coat.jpg"
  ],
  "reference_video_urls": [
    "https://cdn.example.com/walk.mov"
  ],
  "reference_audio_urls": [
    "https://cdn.example.com/room-tone.wav"
  ],
  "resolution": "720P",
  "aspect_ratio": "16:9",
  "duration": 12
}