API 密钥

创建密钥

1. 1

   打开账户 → API

   登录状态下打开账户 → API。
2. 2

   为它命名

   按使用场景命名：“生产环境机器人”“合规检查”。然后点击创建密钥。
3. 3

   立即复制

   密钥只显示一次。Iris 只保存它的指纹，无法再次显示。

密钥的格式为 iris_live_ 加 48 个字符。列表中只显示开头部分。

使用密钥

以 Authorization: Bearer iris_live_… 或 x-api-key: iris_live_… 的形式发送。见认证。没有账户的智能体可以不用密钥，改为通过x402 按次付费。

管理密钥

• 每个账户最多 10 个有效密钥：每个应用或服务器一个。
• 每个密钥都显示创建时间和最近使用时间；用量页显示每个密钥的花费。
• 撤销会立即停用密钥。使用它的程序会收到 401 invalid_key。已撤销的密钥会在列表中保留 30 天。
• 密钥会消耗你账户的额度，但不能创建密钥、付款或修改你的账户。

限额

使用密钥对 API 和 MCP 的调用会被计数：免费版每天（UTC）10 次，套餐按每 10 分钟计，从 Individual 的 50 次到 API Scale 的 2,500 次（见套餐）。超出后调用会收到 429 quota_exceeded 和 Retry-After 响应头，且不扣费。网站本身从不受此限制，通过 x402 付费的调用也不计入。见错误和限额。