API 概览
一个基础 URL，一个密钥，支持所有格式。发起第一次调用前需要了解的一切。
基础 URL
https://binference.io/api/v1Anthropic SDK 和 Claude Code 请使用 https://binference.io/api：它们会自己加上 /v1。
接口
| 方法 | 路径 | 格式 | 密钥 |
|---|---|---|---|
POST | /chat/completions | OpenAI Chat Completions | 需要 |
POST | /responses | OpenAI Responses | 需要 |
POST | /messages | Anthropic Messages | 需要 |
POST | /images | 图像生成 | 需要 |
POST | /uploads | 上传图像供模型读取 | 需要 |
GET | /models | 所有模型及其价格 | 不需要 |
GET | /images/models | 所有图像模型及其价格 | 不需要 |
GET | /balance | 密钥能花多少 | 需要 |
/api/v1 下的其他路径（比如 embeddings）都会以 JSON 返回 404 not_found。
DEX 市场数据
DEX 的市场、订单簿、成交和 K 线，使用同一个基础 URL。这些数据是公开的：无需密钥。
| 方法 | 路径 | 内容 |
|---|---|---|
GET | /dex/markets | 所有开放中的市场 |
GET | /dex/markets/{id}/book | 某个市场的订单簿 |
GET | /dex/markets/{id}/trades | 它的最新成交 |
GET | /dex/markets/{id}/candles | 它的价格 K 线 |
- 数字都是十进制字符串。 价格是每 $1 额度的 USDT，数量以额度美元计，USDT 金额以 USDT 计。时间是 Unix 毫秒。
- 缓存 1 秒。 每秒最多请求一次。
- 每个 IP 地址每分钟 1,200 权重。 每次调用计 1 到 5 权重。超出时返回
429 rate_limited，需要等待的秒数在Retry-After中。 - 只接受每个端点列出的查询参数， 每个一次。其他参数返回
400 unknown_parameter。 - 错误以 JSON 返回：
{ "error": { "code": "unknown_market", "message": "..." } }。404 not_found表示 DEX 尚未开放。 - 钱包和账户永远不会出现。
MCP 服务器
Agent 也可以通过 MCP 读取自己的额度、用量和上限，并管理自己的密钥。地址是 https://binference.io/api/mcp，使用同一个密钥。连接方法见 MCP 服务器，所有工具见 MCP 工具。
认证
把你的 binf_ 密钥作为 Bearer Token 发送，或者放在 x-api-key 中：
Authorization: Bearer binf_...密钥缺失、错误或已撤销时，返回 401 invalid_api_key。参见 API 密钥。
请求
- JSON 请求体，最大 4 MB。图像和文件请以 URL 发送，不要内联数据：先上传大图，再发送它的链接。
- 请求体按原样转发。每种格式的所有字段都可以用，不限于这些页面列出的字段。
- 无状态。调用之间不保存任何内容。每次都要发送完整的对话。
- 可以从任何地方调用。API 接受来自任何来源（origin）的调用，所以浏览器工具也能用。网页中的密钥会被访问者看到：请把密钥放在服务器上。
返回
返回内容遵循各格式自己的结构，另外多了三项：
| 字段或响应头 | 含义 |
|---|---|
usage.cost | 本次调用的扣费金额，单位为美元。除 Messages 外的所有格式都有。 |
x-binference-call-id | 这次调用在你调用记录页面上的 ID。联系我们时请提供它。 |
x-generation-id | 服务商为这次回答生成的 ID。 |
错误
错误使用各格式自己的结构，并带有一个稳定的 code，你可以根据它分支处理：
{
"error": {
"message": "This agent is starting calls faster than 600 a minute. Retry in 1 second.",
"type": "rate_limit_error",
"code": "rate_limited",
"param": null
}
}