平台

密钥限制与规则

按用途限制每个 API 密钥:能花多少、请求多快、可用哪些模型、允许从哪里访问,以及有效期多长。创建密钥时即可设置,也可以随时前往 API 密钥 → 编辑进行调整。

限制规则

规则超出限制后的行为错误
每月预算 (USD)拒绝请求,直到下个月 (UTC)402 key_budget_exceeded
每日预算 (USD)拒绝请求,直到 UTC 午夜402 key_daily_budget_exceeded
速率限制(每分钟请求数)暂时拒绝请求,并返回 retry-after429 rate_limit_exceeded
有效期密钥失效401 expired_api_key
允许的模型拒绝调用其他模型403 model_not_allowed
允许的 IP 地址拒绝来自其他地址的请求403 ip_not_allowed

被拒绝的请求一律不收费。预算会计入该密钥正在执行的请求所预留的费用(见计费),因此,可能导致超出预算的请求会在开始前被拒绝;如果响应过程中达到预算上限,则立即停止并返回对应的预算错误。更改会在 15 秒内全局生效。所有密钥共用工作区余额:余额不足以支付某次请求时,该请求会收到 402 insufficient_quota。

允许的模型

可选择任意文本、图像或视频模型。例如,若某个密钥仅允许使用 gpt-6-sol 和 gemini-3.7-flash,就无法调用其他模型,智能路由也只会从该列表中选择备用模型。允许使用 Zurelay Auto 后,密钥就可以调用 Auto 选中的任意模型。

允许的 IP 地址

支持单个地址和 CIDR 网段,兼容 IPv4 和 IPv6,每个密钥最多可设置 100 项。检查的是请求在互联网上的来源地址(通过代理或 NAT 时,为代理或 NAT 的出口地址)。

示例
203.0.113.7 one address
198.51.100.0/24 a range of 256 addresses
2001:db8::/32 an IPv6 range
Serverless 平台和部分云平台的请求来源地址会变化。可使用服务商公布的出口地址段,或不限制这些密钥的 IP,改用其他规则进行限制。

预算使用建议

  • 为每个应用或环境分配独立的密钥和预算,避免失控循环耗尽余额。
  • 每日预算可在当天限制程序错误造成的消耗;每月预算则控制账单总额。
  • API 密钥页面会在各密钥的预算旁显示当天和当月的支出。

有疑问,或发现内容缺失?联系我们的支持团队,我们会通过邮件回复,通常只需一分钟。