跳到主要内容

Base URL 与身份验证

调用 Bita API 时，需要同时配置正确的请求地址和 API 密钥。本页先说明不同工具中 Base URL 的填写方式，再介绍各类兼容接口使用的鉴权请求头。

认识不同地址​

https://www.bita-api.com 是 Bita API 的站点根地址。OpenAI、Anthropic 和 Gemini 兼容接口都使用这个域名，但接口路径和鉴权方式不同：

接口格式常用 Base URL完整接口地址示例主要鉴权方式
OpenAI 兼容https://www.bita-api.com/v1https://www.bita-api.com/v1/chat/completionsAuthorization: Bearer ...
Anthropic 兼容https://www.bita-api.comhttps://www.bita-api.com/v1/messagesx-api-key: ...，并携带 anthropic-version
Gemini 兼容https://www.bita-api.comhttps://www.bita-api.com/v1beta/models/MODEL_ID:generateContentx-goog-api-key: ...

三类地址可以这样理解：

  • 站点根地址：https://www.bita-api.com，用于访问站点，也是各协议请求地址共同的域名。
  • 版本化 API 地址：OpenAI 和 Anthropic 接口路径使用 /v1；Gemini 原生接口路径使用 /v1beta。
  • 完整接口地址：由站点根地址、版本路径和具体接口路径组成，适用于 cURL、PowerShell 等原始 HTTP 请求。

不同 SDK 和第三方工具对“Base URL”的定义可能不同。例如，OpenAI SDK 通常填写包含 /v1 的地址；Anthropic SDK、Claude Code 和 Gemini 客户端通常填写站点根地址，再由工具追加协议路径。应以对应工具的接入文档为准。

不要重复或遗漏 /v1

如果工具会自动追加 /v1/messages 或 /v1beta/...，应填写站点根地址。如果工具只会追加 /chat/completions，则 OpenAI API Base URL 应包含 /v1。

配置错误时，请求可能会出现 /v1/v1/...、/v1beta/v1beta/...，或完全缺少版本路径，通常会返回 404。

OpenAI 兼容接口​

Bita API 的 OpenAI 兼容接口使用 Bearer 鉴权。在请求头中传递控制台创建的 API 密钥：

Authorization: Bearer YOUR_BITA_API_KEY

发送 JSON 请求时，还需要声明内容类型：

Content-Type: application/json

完整请求头示例：

curl "https://www.bita-api.com/v1/models" \
  -H "Authorization: Bearer $BITA_API_KEY"

OpenAI SDK 通常按下面的方式配置：

Base URL: https://www.bita-api.com/v1
API Key:  你的 Bita API 密钥
API 密钥不是登录密码

API 请求只能使用控制台中创建的 API 密钥，不能使用 Bita API 的登录密码。密钥所属分组还会影响可调用的模型和计费倍率。

Anthropic 兼容接口​

使用 Anthropic 原生 Messages 格式时，完整接口地址为：

https://www.bita-api.com/v1/messages

请求需要携带 API 密钥和 Anthropic 协议版本：

x-api-key: YOUR_BITA_API_KEY
anthropic-version: 2023-06-01
Content-Type: application/json

Bita API 也支持使用 Bearer 方式传递密钥：

Authorization: Bearer YOUR_BITA_API_KEY
anthropic-version: 2023-06-01

使用 Claude Code 等工具时，请以对应接入文档给出的环境变量和 Base URL 为准，工具会负责拼接具体接口路径。

Gemini 兼容接口​

使用 Gemini 原生格式时，请求路径以 /v1beta 开头。例如：

https://www.bita-api.com/v1beta/models
https://www.bita-api.com/v1beta/models/MODEL_ID:generateContent

推荐通过请求头传递 API 密钥：

x-goog-api-key: YOUR_BITA_API_KEY

部分 Gemini 客户端也会使用 ?key=YOUR_BITA_API_KEY 查询参数。仅在客户端无法配置请求头时使用这种方式，因为 URL 可能被浏览器历史、代理或访问日志记录。

保护 API 密钥​

  • 不要把 API 密钥写入网页前端、移动应用安装包或公开代码仓库。
  • 不要在截图、聊天记录、报错日志中暴露完整密钥。
  • 服务端项目应通过环境变量或密钥管理服务读取密钥。
  • 怀疑密钥泄露时，立即在控制台禁用旧密钥并创建新密钥。
  • 不同设备、应用或成员建议使用不同密钥，方便单独限制额度和排查用量。

鉴权问题排查​

现象常见原因建议检查
返回 401未携带密钥、密钥不完整或请求头格式错误确认使用完整 API 密钥；Bearer 后需要有一个空格
返回 403密钥已禁用、已过期，或没有当前模型的调用权限检查密钥状态、有效期、分组、模型限制和额度
返回 404Base URL 或接口路径错误检查是否重复或遗漏 /v1，以及当前协议应使用 /v1 还是 /v1beta
模型列表为空或缺少目标模型密钥分组与模型分组不匹配查看密钥所属分组，并在模型广场确认模型支持的分组

配置完成后，可以先请求 /v1/models 验证地址和密钥，再发送正式的模型请求。完整操作参见发送第一个 API 请求。

下一步：查询可用模型。