API 参考
API 鉴权与限流
除 GET /models 外,所有请求都需要 API 密钥。密钥属于你的账号,消耗的是账号积分。
获取 API 密钥Wan 3 API 团队 ·
发送密钥
把密钥以 Bearer 方式放在 Authorization 请求头里。密钥以 sk- 开头,共 43 个字符。
http
Authorization: Bearer sk-...curl "https://api.wan3api.org/v1/balance" \
-H "Authorization: Bearer $API_KEY"保管好密钥
- 从服务器调用 API,不要在浏览器或移动应用里调用,那里任何人都能看到密钥。
- 把密钥放在环境变量或密钥管理服务中,不要提交到代码仓库。
- 每个应用或环境用一个密钥,吊销一个不会影响其他。
- 一旦怀疑泄露立即吊销,使用该密钥的请求会马上失败。
限流
每个密钥每分钟最多 60 次请求,超出返回 429 rate_limited 并带 Retry-After 头。另外,每个账号同时最多 3 个生成中的任务,超出返回 429 too_many_running_tasks。
鉴权错误
缺少密钥、格式错误或已吊销返回 401 invalid_api_key;账号被停用返回 403 account_disabled。