全场景 API 接入指南
本文档用于帮助你购买套餐、创建 API Key,并在 Claude Code、Codex CLI、ChatBox、Cherry Studio、NextChat、LobeChat 以及代码项目中接入天宝 AI。
API 站点:https://api.tianbaozy.top,OpenAI 兼容地址:https://api.tianbaozy.top/v1。所有示例里的 sk-你的APIKey 请替换为你在本站创建的密钥。
快速开始
- 登录 天宝 AI。
- 进入 充值订阅 页面,选择日卡、周卡或轻享月卡并完成支付。
- 进入 API 密钥 页面,创建一个新的 API Key。
- 在你的工具或代码里配置接口地址和 API Key。
- 先用
/v1/models或一个简单对话测试是否可用。
API Key 等同于你的调用凭证。不要把它发到群聊、截图、公开仓库或共享文档里。如果怀疑泄露,请立刻删除旧 Key 并重新创建。
接口地址
| 用途 | 地址 | 说明 |
|---|---|---|
| 站点首页 | https://api.tianbaozy.top |
登录、购买套餐、创建 API Key。 |
| OpenAI 兼容 Base URL | https://api.tianbaozy.top/v1 |
适合 ChatBox、Cherry Studio、NextChat、LobeChat、OpenAI SDK。 |
| Claude Code Base URL | https://api.tianbaozy.top |
Claude Code 使用 ANTHROPIC_BASE_URL,不要手动加 /v1。 |
| 模型列表 | https://api.tianbaozy.top/v1/models |
用于测试 Key 是否可用,并查看当前可用模型。 |
套餐与额度
额度按站内计费口径扣减,不同模型、输入输出 token、缓存命中情况都会影响消耗。建议先用小请求测试,再接入正式工作流。
Claude Code 配置
Claude Code 走 Anthropic Messages 协议。配置时 Base URL 使用根地址,Key 使用你在本站创建的 API Key。
macOS / Linux
export ANTHROPIC_BASE_URL="https://api.tianbaozy.top"
export ANTHROPIC_AUTH_TOKEN="sk-你的APIKey"
export ANTHROPIC_MODEL="gpt-5.4"
export ANTHROPIC_DEFAULT_OPUS_MODEL="gpt-5.4"
export ANTHROPIC_DEFAULT_SONNET_MODEL="gpt-5.4"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="gpt-5.4"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
claude
Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://api.tianbaozy.top"
$env:ANTHROPIC_AUTH_TOKEN="sk-你的APIKey"
$env:ANTHROPIC_MODEL="gpt-5.4"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="gpt-5.4"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="gpt-5.4"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="gpt-5.4"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
claude
快速测试
claude -p "只回复 OK" --model gpt-5.4
Codex CLI 配置
Codex CLI 通常使用 OpenAI 兼容接口。推荐配置 Base URL 为 https://api.tianbaozy.top/v1。
环境变量方式
export OPENAI_BASE_URL="https://api.tianbaozy.top/v1"
export OPENAI_API_KEY="sk-你的APIKey"
codex
配置文件方式
如果你的 Codex CLI 支持配置文件,可把 provider 指向 OpenAI 兼容地址:
model = "gpt-5.4"
[model_providers.openai]
name = "OpenAI Compatible"
base_url = "https://api.tianbaozy.top/v1"
env_key = "OPENAI_API_KEY"
常用客户端配置
ChatBox / Cherry Studio
| 字段 | 填写内容 |
|---|---|
| 供应商 | OpenAI Compatible / 自定义 OpenAI |
| API Key | sk-你的APIKey |
| API Host / Base URL | https://api.tianbaozy.top/v1 |
| 模型 | gpt-5.4 或 GPT-5.4-Mini |
NextChat / LobeChat
OPENAI_API_KEY=sk-你的APIKey
BASE_URL=https://api.tianbaozy.top
OPENAI_API_BASE_URL=https://api.tianbaozy.top/v1
不同项目的环境变量名称略有差异。如果页面里有 “OpenAI API Base URL”,优先填写 https://api.tianbaozy.top/v1。
沉浸式翻译 / 浏览器插件
- 服务类型选择 OpenAI 或 OpenAI Compatible。
- API Key 填写本站创建的 Key。
- API URL 填写
https://api.tianbaozy.top/v1/chat/completions或 Base URL 填写https://api.tianbaozy.top/v1。 - 模型可先选
GPT-5.4-Mini,稳定后再按需要切换。
代码调用示例
curl 测试模型列表
curl https://api.tianbaozy.top/v1/models \
-H "Authorization: Bearer sk-你的APIKey"
curl 对话测试
curl https://api.tianbaozy.top/v1/chat/completions \
-H "Authorization: Bearer sk-你的APIKey" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.4",
"messages": [
{"role": "user", "content": "只回复 OK"}
],
"max_tokens": 20
}'
Python
from openai import OpenAI
client = OpenAI(
api_key="sk-你的APIKey",
base_url="https://api.tianbaozy.top/v1",
)
resp = client.chat.completions.create(
model="gpt-5.4",
messages=[{"role": "user", "content": "只回复 OK"}],
max_tokens=20,
)
print(resp.choices[0].message.content)
Node.js
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "sk-你的APIKey",
baseURL: "https://api.tianbaozy.top/v1",
});
const resp = await client.chat.completions.create({
model: "gpt-5.4",
messages: [{ role: "user", content: "只回复 OK" }],
max_tokens: 20,
});
console.log(resp.choices[0].message.content);
模型选择建议
| 场景 | 推荐模型 | 说明 |
|---|---|---|
| 日常问答、轻量翻译 | GPT-5.4-Mini |
速度快、消耗低,适合普通任务。 |
| 代码、复杂分析、Claude Code | gpt-5.4 |
综合能力更强,适合开发和复杂推理。 |
| 查看完整模型 | /v1/models |
模型可用情况会随上游变化,以接口返回为准。 |
常见问题
为什么提示 401 或 invalid api key?
检查 API Key 是否完整复制,前后不要有空格。本站 API Key 一般以 sk- 开头。
为什么提示额度不足或无可用分组?
请确认套餐仍在有效期内,并且 API Key 绑定的是已购买套餐对应的分组。
Claude Code 为什么连不上?
确认 ANTHROPIC_BASE_URL 是 https://api.tianbaozy.top,不要写成 /v1;同时确认 ANTHROPIC_AUTH_TOKEN 使用的是本站 API Key。
OpenAI 客户端为什么失败?
OpenAI 兼容客户端通常需要 Base URL 带 /v1,也就是 https://api.tianbaozy.top/v1。
额度消耗为什么和 token 数不完全等比例?
不同模型、输入、输出、缓存、工具调用都会影响计费。本站以后台实际记录的用量为准。
联系支持
遇到无法解决的问题,请把以下信息发给客服,便于快速定位:
- 你的注册邮箱。
- 使用的客户端,例如 Claude Code、ChatBox、Cherry Studio。
- 报错截图或完整错误文本。
- 大概发生时间和使用的模型。
QQ:2458845424