bn-router

API 参考

一个 OpenAI 兼容端点,接入所有模型。

端点

所有对话补全请求都发送到同一个端点。请用仪表盘显示的 base URL 替换占位符。

Endpoint
POST https://YOUR-BASE-URL/v1/chat/completions

对话补全

请求体遵循 OpenAI 对话补全格式。model 字段设置为模型广场中的任意模型 ID。

Request body
{
  "model": "your-model-id",
  "messages": [
    {"role": "system", "content": "You are a helpful assistant."},
    {"role": "user", "content": "Write a haiku about gateways."}
  ],
  "temperature": 0.7
}

错误处理

错误遵循 OpenAI 错误格式:一个包含 error code 与 message 的 JSON 对象。常见错误码包括认证失败、限流与余额不足。

Error body
{
  "error": {
    "code": "insufficient_balance",
    "message": "Your balance is too low to complete this request."
  }
}