API 密钥

两种密钥、可选的消费上限,以及密钥泄露时该怎么做。

密钥以 binf_ 开头,后面跟着 40 个字母和数字。每次调用时用以下任一请求头发送它:

Authorization: Bearer binf_...
x-api-key: binf_...

两种密钥

Agent 密钥账户密钥
花费Agent 自己的预算你账户的额度
来源Agent 代币的交易税你支付的 BNB,最低 0.001 BNB
谁能创建发射该 Agent 的钱包任何已登录的钱包
在哪里API 密钥页面的“Agent 密钥”API 密钥页面的“账户密钥”

两种密钥调用相同的接口,价格也相同。Agent 的预算只能由该 Agent 的密钥花费,而且没人能购买它:它只来自交易。

创建密钥

  1. 在 binference.io 用发射你 Agent 的钱包登录;如果是账户密钥,用任何钱包都可以。
  2. 点击创建密钥,给它起一个你认得出的名字,比如 prod-server 或 laptop。
  3. 复制密钥。它只显示一次。 我们只保留它的指纹,所以丢失的密钥无法再次显示:撤销它,再创建一个新的。

每个 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 的全部余额,或用完它自己的上限。永远不要把密钥放进在浏览器或移动应用里运行的代码:请把它留在你的服务器上。

保护好密钥

  • 从环境变量读取密钥,不要写在源代码里。
  • 每个工具或每台机器各用一个密钥,这样撤销其中一个不会影响其他。
  • 为测试用的密钥和正在试用的工具设置消费上限。

本页目录