API 接入文档

从创建密钥到接入客户端和代码

只保留真正需要配置的步骤。一个 API Key,即可按控制台授权访问多种模型与兼容协议。

最后更新:2026-07-26 · 独立文档站
curl200 · ready
curl https://api.btt66.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"Hello!"}]}'

四步完成第一次调用

01

注册并登录控制台

完成注册登录,确认账户可用。

02

确认额度与通道

查看余额/订阅,以及目标分组支持的平台、模型与并发限制。

03

创建 API 密钥

为密钥命名并创建。完整密钥通常只显示一次,请本地保存。

04

配置客户端或代码

复制 Base URL 与 API Key,按下方示例完成测试。

按使用场景查文档

注册与 API 密钥

接入前先准备好控制台账号和 API Key。密钥是调用凭证,请勿公开到前端或公共仓库。

注册 / 登录

  1. 打开 注册页 创建账号,或前往 登录
  2. 登录后进入用户控制台,确认账户状态正常。
  3. 如需管理端能力,请使用管理员分配的后台入口。

创建 API Key

  1. 在控制台找到 API Keys / 令牌管理。
  2. 新建密钥,填写名称,按需设置额度或有效期。
  3. 复制完整密钥并保存。页面刷新后通常无法再次查看完整值。
安全建议

使用环境变量保存密钥,例如 API_KEY。不要把密钥写进前端页面、截图或公开 Issue。

API 接入基础

统一网关地址后,按厂商协议选择对应端点。创建密钥后,以控制台展示的可用渠道为准。

Base URL

用途地址
OpenAI 兼容 / 通用https://api.btt66.com/v1
Anthropic SDK base_urlhttps://api.btt66.com
站点控制台https://btt66.com

兼容协议一览

方法路径说明
POST/v1/chat/completionsOpenAI Chat Completions
POST/v1/responsesOpenAI Responses / Codex
POST/v1/messagesAnthropic Messages
POST/v1beta/models/{model}:generateContentGemini 原生协议
GET/v1/models模型列表(需鉴权)

鉴权

  • OpenAI / Gemini:请求头 Authorization: Bearer YOUR_API_KEY
  • Anthropic:请求头 x-api-key: YOUR_API_KEY,并附带 anthropic-version: 2023-06-01

可用模型

以下为文档示例中的常用模型名。实际上线以控制台实时通道与授权范围为准。

厂商示例模型协议
OpenAIgpt-5.6-solChat Completions / Responses
Anthropicclaude-fable-5Messages
Googlegemini-3.5-flashgenerateContent
xAIgrok 系列OpenAI 兼容(视通道开放)
注意

不同分组可能开放不同模型与倍率。调用失败时先核对模型名是否在控制台可用列表中。

语言与 SDK

优先使用官方 SDK,只改 Base URL / base_url 与 API Key。首页也提供可复制示例:请求对照

OpenAI Python

from openai import OpenAI

client = OpenAI(
  api_key="YOUR_API_KEY",
  base_url="https://api.btt66.com/v1"  # <- Change only this
)

response = client.chat.completions.create(
  model="gpt-5.6-sol",
  messages=[{"role": "user", "content": "Hello!"}],
)

Anthropic Python

from anthropic import Anthropic

client = Anthropic(
  api_key="YOUR_API_KEY",
  base_url="https://api.btt66.com"  # <- Change only this
)

message = client.messages.create(
  model="claude-fable-5",
  max_tokens=1024,
  messages=[{"role": "user", "content": "Hello!"}],
)

cURL(Chat Completions)

curl https://api.btt66.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [
      { "role": "user", "content": "Hello!" }
    ]
  }'

客户端接入

大多数兼容 OpenAI / Anthropic 的客户端,只需填写自定义 API 地址和密钥。

通用配置

API Base:https://api.btt66.com/v1
API Key:控制台生成的密钥

Anthropic 客户端

Base URL 填 https://api.btt66.com
Key 填你的 API Key

排错顺序

先测 cURL → 再测 SDK → 最后测客户端,可快速定位是配置还是客户端问题。

Codex / CLI

ChatGPT Codex 桌面端或 CLI 使用 OpenAI 兼容协议时,将自定义服务指向本站网关。

  • Base URL:https://api.btt66.com/v1
  • API Key:你的 API Key
  • Model:使用控制台可用的模型名,例如 gpt-5.6-sol
提示

若客户端要求 Responses API,可尝试端点 /v1/responses(以实际通道支持为准)。

Claude Code

在 Claude Code / Claude 兼容工具中配置自定义 Anthropic 兼容网关。

  • Base URL:https://api.btt66.com
  • API Key:你的 API Key
  • Model:例如 claude-fable-5
# 环境变量示例(按客户端实际变量名调整)
export ANTHROPIC_BASE_URL="https://api.btt66.com"
export ANTHROPIC_API_KEY="YOUR_API_KEY"

常见问题

401 / 鉴权失败?

检查 API Key 是否完整、是否带有多余空格,以及请求头字段是否匹配协议(Bearer 或 x-api-key)。

模型不存在或无可用通道?

到控制台确认该模型已对你的分组开放,并核对模型名拼写(如 claude-fable-5)。

超时或中断?

长输出任务请提高客户端超时时间;也可稍后重试。网关侧会在条件允许时尝试切换上游。

Base URL 要不要带 /v1?

OpenAI 兼容通常带 /v1。Anthropic 官方 SDK 的 base_url 一般不带 /v1,填 https://api.btt66.com

技术支持

接入遇到问题,可先对照本文档与首页请求示例;仍无法解决时联系支持。

已复制