百炼 API 跨地域调用失败 + 常见参数限制

地域三绑定

百炼调用 Wan2.2 的三个要素必须同地域：

1. 模型部署地域（控制台模型广场能看到）
2. API Endpoint URL 地域
3. API Key 的地域

任何一个错了都会直接报 400。排查：

# 看 API Key 是哪个地域的
# 看控制台里模型部署在哪个地域
# 确认 Endpoint URL 对得上

Workspace 专属域名格式：

https://{WorkspaceId}.{region}.maas.aliyuncs.com

Region 取值示例：cn-beijing（华北2）、ap-southeast-1（新加坡）。

分辨率限制

不同模型支持的分辨率不同，超出范围会被拒绝：

具体列表以百炼控制台的模型详情页为准。Flash 系列通常比 Plus 系列支持的分辨率少。

时长限制

云端 API 生成的视频时长由模型决定，不能随意指定：

• 常规：默认 5 秒，部分模型支持通过参数调整
• S2V：视频时长自动跟随输入音频
• 超出范围的时长请求会被拒绝或自动截断

水印控制

• 百炼控制台网页体验：强制有水印，右下角"AI 生成"，无法关闭
• DashScope API：watermark 参数默认 false（无水印），显式设 true 可开启
• 要无水印 → 必须走 API，不能走控制台

并发热点

同时提交太多任务会被限流：

限流时返回 429，加指数退避重试即可：等 1s → 2s → 4s → 8s...

素材上传限制

API 输入的图片和音频必须是公开可访问的 URL，不支持直接传二进制。要求：

• 最好和百炼同地域的 OSS（延迟低、不产生外网流量费用）
• 临时公开访问 URL 有过期时间，注意有效期
• 图片格式：jpg / png / webp 等常见格式
• 音频格式：wav / mp3（S2V 接口）

模型名找不到

百炼模型名会变（例如从 wan2.2-t2v 升级到 wan2.2-t2v-plus），如果调用报 "model not found"：

1. 登录百炼控制台
2. 进模型广场搜索 Wan2.2
3. 复制最新的模型名（不要用旧文档里的名字）
4. 确认 Endpoint URL 地域也对

旧模型 vs 新模型

百炼上会同时存在 Wan2.1、Wan2.2、Wan2.3 / Wan2.5 / Wan2.7 等版本。不同版本的 API 路径和参数不完全相同，调用前必须确认你选的模型对应的 API 参考文档，不要跨版本照搬。