DashScope API 计费、限流和地域绑定踩坑汇总

地域绑定：最常见的坑

百炼的模型、Endpoint URL、API Key 三者必须同地域。跨地域调用会直接报 400 错误。

排查清单：

部分模型有阶梯计费——单价取决于单次请求的输入 Token 总量：

阶梯	Token 范围	单价
第一档	0 < Token ≤ 32K	较低
第二档	32K < Token ≤ 128K	较高

该请求的所有 Token 按对应阶梯的单价结算，不是分段计费。比如一次请求输入 100K Token，全部按第二档结算。写程序时注意把长 prompt 拆分成多次调用可能更划算。

不同模型的限流策略不同，以 wan2.2-i2v-plus 为例（参考 2026 年 10 月）：

限流项	阈值
任务提交 RPS 限制	约 1~5 RPS（不同模型不同）
同时处理中任务数量	有限制（通常几个到几十个）

并发超限时 API 会返回 429 或 400 + ErrorCode。程序要加指数退避重试：连续失败后等 1s、2s、4s、8s…再试。

新用户首次开通通常有免费额度，可以在百炼控制台的「资源包管理」里查看剩余量。免费额度用完后自动转按量付费。

注意：免费额度只覆盖部分模型，且有时效性。S2V 人脸图像检测等接口可能没有免费额度。

DashScope SDK 迭代很快，建议保持最新版：

pip install dashscope --upgrade

旧版 SDK 可能缺少 Wan2.2 新模型的支持、或对新的异步协议有兼容性问题。如果调用时报 "model not found" 或协议格式错误，先升级 SDK 再排查。