BetterCall

User Guide

BetterCall

Manage multiple AI model providers through a unified API interface

High Availability
Load Balancing
Auto-Repair

核心概念

理解 BetterCall 的核心组件

Channel(通道)

连接到上游 AI 服务提供商的桥梁

什么是通道?

通道是到上游 AI 服务提供商的连接。每个通道代表一个 AI 提供商的一个特定模型,包含认证凭据和连接端点。

关键特性

  • 一对一映射:一个通道 = 一个提供商的一个模型
  • 网关功能:作为代理转发请求
  • 状态跟踪:监控通道健康状态
  • 速率限制:跟踪每分钟请求数(RPM)

重要提示

仅支持 OpenAI 格式 API

提供商必须兼容 OpenAI API 格式才能正常工作

推荐:SiliconFlow

国内可直接访问,兼容 OpenAI 格式

代码示例

集成到您的应用程序

main.py
python
import openai

client = openai.OpenAI(
    base_url="https://bettercall.cn/v1",
    api_key="your-gateway-api-key"
)

response = client.chat.completions.create(
    model="your-model-group-name",
    messages=[
        {"role": "user", "content": "你好!"}
    ]
)

print(response.choices[0].message.content)

常见问题

快速解决常见问题

无法验证连接

检查 API 密钥是否正确,Base URL 格式是否正确(应以 /v1 结尾),确认提供商是否兼容 OpenAI 格式。推荐使用 SiliconFlow。

通道处于错误状态

使用"Test Connection"按钮测试通道,检查 API 密钥是否仍然有效,验证是否超过提供商的速率限制。

无法从中国连接到国际提供商

推荐方案:使用 SiliconFlow(国内可直接访问)。或为网关服务器配置代理/VPN,或选择国内兼容 OpenAI 格式的提供商。

Provider API format not compatible

该提供商不支持 OpenAI 格式的 API。推荐切换到 SiliconFlow 或其他兼容提供商,或通过兼容 OpenAI 格式的中转服务访问。

准备开始了吗?

注册账号,开始使用 BetterCall 管理您的 AI 模型调用