API 参考

API 鉴权与限流

除 GET /models 外,所有请求都需要 API 密钥。密钥属于你的账号,消耗的是账号积分。

获取 API 密钥Wan 3 API 团队 ·

保管好密钥

  • 从服务器调用 API,不要在浏览器或移动应用里调用,那里任何人都能看到密钥。
  • 把密钥放在环境变量或密钥管理服务中,不要提交到代码仓库。
  • 每个应用或环境用一个密钥,吊销一个不会影响其他。
  • 一旦怀疑泄露立即吊销,使用该密钥的请求会马上失败。

限流

每个密钥每分钟最多 60 次请求,超出返回 429 rate_limited 并带 Retry-After 头。另外,每个账号同时最多 3 个生成中的任务,超出返回 429 too_many_running_tasks。

鉴权错误

缺少密钥、格式错误或已吊销返回 401 invalid_api_key;账号被停用返回 403 account_disabled。