API 密钥
两种密钥、可选的消费上限,以及密钥泄露时该怎么做。
密钥以 binf_ 开头,后面跟着 40 个字母和数字。每次调用时用以下任一请求头发送它:
Authorization: Bearer binf_...
x-api-key: binf_...两种密钥
| Agent 密钥 | 账户密钥 | |
|---|---|---|
| 花费 | Agent 自己的预算 | 你账户的额度 |
| 来源 | Agent 代币的交易税 | 你支付的 BNB,最低 0.001 BNB |
| 谁能创建 | 发射该 Agent 的钱包 | 任何已登录的钱包 |
| 在哪里 | API 密钥页面的“Agent 密钥” | API 密钥页面的“账户密钥” |
两种密钥调用相同的接口,价格也相同。Agent 的预算只能由该 Agent 的密钥花费,而且没人能购买它:它只来自交易。
创建密钥
- 在 binference.io 用发射你 Agent 的钱包登录;如果是账户密钥,用任何钱包都可以。
- 点击创建密钥,给它起一个你认得出的名字,比如
prod-server或laptop。 - 复制密钥。它只显示一次。 我们只保留它的指纹,所以丢失的密钥无法再次显示:撤销它,再创建一个新的。
每个 Agent 最多可以有 10 个有效密钥,你的账户也最多 10 个。
如果 Agent 连接时用的密钥没有消费上限,它还可以通过 MCP 服务器自己创建、修改和撤销密钥。
npx binference agent-os 会替 Agent 创建密钥,初始上限为每天 $5。这个密钥属于该 Agent 的驾驶舱:在那里点击暂停,会拒绝它以及它创建的每一个密钥的调用;点击停止,会把它们全部撤销。
消费上限
打开限制消费,为单个密钥设置每天、每周或每月最多能花多少,范围从 $0.01 到 $1,000,000。把密钥交给新工具或队友时,这是最安全的做法。
- 上限在 UTC 时间 00:00 重置:每日上限每天重置,每周上限在周一重置,每月上限在每月 1 日重置。
- 达到上限的密钥会被拒绝,返回
402 key_limit,该 Agent 的其他密钥照常工作。 - 一次调用计入它开始时所在的周期,无论它多晚结束。
- 在周期中途设置上限时,会计入该密钥在本周期内已经花掉的金额。
GET /balance 会显示发起调用的密钥的上限、已花费的金额和下次重置时间。参见查询余额。
撤销密钥
点击密钥旁边的撤销。它在下一次调用时就会停止:没有任何缓存。正在运行的调用会继续完成。
如果密钥泄露
立即撤销它,然后创建一个新的。泄露的密钥可以花光它所属 Agent 的全部余额,或用完它自己的上限。永远不要把密钥放进在浏览器或移动应用里运行的代码:请把它留在你的服务器上。
保护好密钥
- 从环境变量读取密钥,不要写在源代码里。
- 每个工具或每台机器各用一个密钥,这样撤销其中一个不会影响其他。
- 为测试用的密钥和正在试用的工具设置消费上限。