通过 Rivya Public API v1 调用 Wan 2.2 A14B Turbo，包含模型 ID wan-2-2-a14b-turbo、输入类型、参数、Files API 规则、积分和响应示例。

API 可调用文本或 URL 可用；参考模式使用 Files API视频

API 模型 ID

wan-2-2-a14b-turbo

输入类型

text, file

Files API

参考素材模式需要

基础积分

能力类型

视频

计费方式

FIXED

提示词上限

5000 字符

请求字段

模型 ID 放在顶层字段。模型专属控制项放入 params。

Key	类型	必填	默认值	说明
model	string	是	wan-2-2-a14b-turbo	使用 wan-2-2-a14b-turbo 作为 API 模型 ID。
prompt	string	是	-	这个模型最多 5000 个字符。
params	object	否	-	模型专属参数对象。可用 key 见下方参数表。
client_request_id	string	否	-	可选客户端请求 ID，便于你在自己的系统中追踪请求。

模型参数

Key	类型	必填	默认值	范围	枚举值	说明
resolution	select	否	720p	-	480p, 580p, 720p	文生/图生当前使用 `480p / 720p`；图片+音频驱动视频额外开放 `580p`。Rivya 会按当前模式自动过滤不可用档位。
aspect_ratio	select	否	16:9	-	16:9, 9:16	当前只在文生视频模式下开放，因为公开图生和图片+音频驱动视频文档没有稳定暴露这个字段。
enable_prompt_expansion	select	否	false	-	false, true	开启后会让上游先扩写提示词再生成，通常更适合文生/图生视频的粗粒度描述。
seed	number	否	-	min 0 / max 2147483647	-	留空时每次会随机生成不同结果；重复使用同一个整数，更适合复现或微调上一条结果。只有在提示词和其它关键参数也尽量一致时，结果才更容易接近，但不保证完全一致。
acceleration	select	否	none	-	none, regular	当前只在文生/图生模式下开放，用来决定是否启用公开文档里的轻量加速选项。
num_frames	number	否	80	min 40 / max 120 / step 1	-	图片+音频驱动视频专用参数。范围为 40 到 120，且必须是 4 的倍数。典型值 80 约对应一条较稳妥的短视频长度。
frames_per_second	number	否	16	min 4 / max 60 / step 1	-	图片+音频驱动视频专用参数。范围为 4 到 60。数值越高，动作更顺滑，但同样会拉高整体生成压力。
negative_prompt	text	否	-	-	-	图片+音频驱动视频专用参数。可填写你希望尽量规避的失败画面、错误动作或不想出现的内容。
num_inference_steps	number	否	27	min 2 / max 40 / step 1	-	图片+音频驱动视频专用参数。范围为 2 到 40。更高的步数通常有助于质量，但会增加耗时。
guidance_scale	number	否	3.5	min 1 / max 10 / step 0.1	-	图片+音频驱动视频专用参数。范围为 1 到 10。数值越高越贴近提示词，但过高时也可能让画面变得更僵硬。
shift	number	否	5	min 1 / max 10 / step 0.1	-	图片+音频驱动视频专用参数。范围为 1 到 10。它会影响视频生成时的时间偏移感，建议先从默认值附近开始尝试。
enable_safety_checker	select	否	true	-	true, false	图片+音频驱动视频专用参数。开启后会在处理前做安全校验；关闭后更接近原始输入，但也意味着过滤更弱。

上传策略

先上传参考文件，再把返回的 URL 和 durationToken 放入 params.referenceMediaItems。

参考素材规则

参考素材: 最多上传 2 个参考素材：文生视频不需要素材；图生视频使用 1 张图片；图片+音频驱动视频使用 1 张图片加 1 段音频。

最大文件数

支持文件类型

image, audio

Duration token

视频和音频参考素材需要时长校验时，应携带 /api/v1/files 返回的 durationToken。

kind	大小上限	MIME 类型
image	10 MB	image/jpeg, image/png, image/webp
audio	10 MB	audio/mpeg, audio/mp4, audio/wav, audio/x-wav, audio/aac, audio/ogg, audio/flac, audio/x-ms-wma

最小请求

{
  "model": "wan-2-2-a14b-turbo",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "acceleration": "none",
    "num_frames": 80,
    "frames_per_second": 16,
    "negative_prompt": "可选的排除内容或失败画面描述。",
    "num_inference_steps": 27,
    "guidance_scale": 3.5,
    "shift": 5,
    "enable_safety_checker": "true"
  }
}

参考文件请求

{
  "model": "wan-2-2-a14b-turbo",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "acceleration": "none",
    "num_frames": 80,
    "frames_per_second": 16,
    "negative_prompt": "可选的排除内容或失败画面描述。",
    "num_inference_steps": 27,
    "guidance_scale": 3.5,
    "shift": 5,
    "enable_safety_checker": "true",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

创建响应

创建接口会返回公开任务 ID。继续轮询状态接口，直到任务成功或失败。

{
  "id": "task_wan_2_2_a14b_turbo_example",
  "status": "queued",
  "model": "wan-2-2-a14b-turbo",
  "reserved_credits": 12,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

常见错误

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

部分模式需要通过 Files API 上传参考素材。

Wan 2.2 A14B Turbo API 接入文档