天宝 AI 全场景接入指南

这份文档按新手流程编写：先买套餐，再创建 API Key，然后按你的电脑系统下载专属脚本，最后在 Codex、Claude Code、VS Code、Cursor 或常用客户端里使用。

先记住这两个地址

OpenAI 兼容地址填 https://api.tianbaozy.top/v1。Claude Code 的 ANTHROPIC_BASE_URL 填 https://api.tianbaozy.top，不要加 /v1。

新手 6 步

注册登录打开 api.tianbaozy.top，用邮箱注册或登录。
购买套餐进入充值订阅，选择日卡、周卡或轻享月卡，支付成功后等待页面显示已开通。
创建 API Key进入 API 密钥，创建新密钥。这个 Key 就是你后续接入工具时要填的凭证。
选择系统苹果电脑看 macOS，Windows 电脑看 Windows，不需要两边都配置。
下载专属脚本在 API 密钥页面点击使用密钥，切到 Codex CLI，下载一键配置脚本。
运行并测试按下方命令运行脚本，再执行 codex -p "只回复 OK" 测试。
API Key 不要发给别人

API Key 等同于你的账号调用凭证。不要截图公开、不要发到群聊、不要提交到 GitHub。怀疑泄露时，立刻删除旧 Key 并创建新 Key。

地址怎么填

使用场景填写内容说明
登录、购买、创建 Keyhttps://api.tianbaozy.top这是本站主入口。
OpenAI 兼容客户端https://api.tianbaozy.top/v1Codex CLI、ChatBox、Cherry Studio、OpenAI SDK 通常填这个。
Claude Codehttps://api.tianbaozy.topClaude Code 使用 Anthropic 协议，Base URL 不加 /v1。
模型列表测试https://api.tianbaozy.top/v1/models用于检查 Key 是否可用、当前模型是否可见。
备用站点https://sub2api.tianbaozy.top主域名异常时可临时访问。

套餐与额度

日卡4.90 元，有效期 1 天，每日额度 20，适合短期体验。
周卡16.90 元，有效期 7 天，每周额度 100，适合连续几天使用。
轻享月卡39.90 元，有效期 30 天，每月额度 300，适合轻量长期使用。

额度按站内后台记录扣减。不同模型、输入输出长度、缓存、工具调用都会影响消耗。第一次使用建议先发短问题测试。

一键脚本

一键脚本是给 Codex CLI 用的。每个用户下载到的脚本都带着自己当前选择的 API Key，会自动备份旧配置，再写入天宝 AI 的地址、模型和 Key。

macOS / Linux 使用步骤

  1. 打开 API 密钥 页面。
  2. 找到要使用的 Key，点击 使用密钥。
  3. 选择 Codex CLI，保持 macOS / Linux 标签。
  4. 点击 下载一键脚本，文件名通常是 setup-tianbao-ai-codex-mac.sh。
  5. 打开系统自带的终端 Terminal，运行：
cd ~/Downloads
bash setup-tianbao-ai-codex-mac.sh
codex -p "只回复 OK"

不要双击 .sh 文件。双击通常只会打开文本编辑器，正确方式是在终端里运行。

如果提示没有权限

cd ~/Downloads
chmod +x setup-tianbao-ai-codex-mac.sh
./setup-tianbao-ai-codex-mac.sh

如果 macOS 提示来自互联网

xattr -d com.apple.quarantine ~/Downloads/setup-tianbao-ai-codex-mac.sh
bash ~/Downloads/setup-tianbao-ai-codex-mac.sh

Windows 使用步骤

  1. 打开 API 密钥 页面。
  2. 找到要使用的 Key，点击 使用密钥。
  3. 选择 Codex CLI，再切到 Windows 标签。
  4. 点击 下载一键脚本，文件名通常是 setup-tianbao-ai-codex-windows.ps1。
  5. 右键开始菜单，打开 Windows PowerShell，运行：
cd $env:USERPROFILE\Downloads
powershell -ExecutionPolicy Bypass -File .\setup-tianbao-ai-codex-windows.ps1
codex -p "只回复 OK"

不建议双击 .ps1 文件。Windows 默认可能禁止脚本直接运行，用上面的 PowerShell 命令更稳。

如果提示无法加载脚本

cd $env:USERPROFILE\Downloads
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\setup-tianbao-ai-codex-windows.ps1

脚本会修改哪些文件

系统文件作用
macOS / Linux~/.codex/config.toml 和 ~/.codex/auth.json写入模型、接口地址和 API Key。
Windows%USERPROFILE%\.codex\config.toml 和 %USERPROFILE%\.codex\auth.json写入模型、接口地址和 API Key。

旧文件会先备份，备份名类似 config.toml.backup-20260605-120000。换 Key 或换套餐后，重新下载脚本运行一次即可。

Codex CLI 手动配置

如果你不想用脚本，也可以手动配置。Codex CLI 使用 OpenAI 兼容地址，Base URL 填 https://api.tianbaozy.top/v1。

model_provider = "tianbao_ai"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "high"
disable_response_storage = true
network_access = "enabled"

[model_providers.tianbao_ai]
name = "天宝 AI"
base_url = "https://api.tianbaozy.top/v1"
wire_api = "responses"
requires_openai_auth = true

API Key 保存到 auth.json：

{
  "OPENAI_API_KEY": "sk-你的APIKey"
}

Claude Code 配置

Claude Code 不是 OpenAI 兼容配置，它使用 Anthropic 环境变量。这里最容易填错的是 Base URL：不要加 /v1。

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 -p "只回复 OK" --model gpt-5.4
$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 -p "只回复 OK" --model gpt-5.4

VS Code / Cursor / IDE

  1. 先按 一键脚本 完成 Codex CLI 配置。
  2. 在系统终端运行 codex -p "只回复 OK"，确认能返回 OK。
  3. 打开 VS Code、Cursor 或 Trae。
  4. 进入扩展市场，搜索并安装 OpenAI Codex 插件。
  5. 完全退出并重新打开 IDE，再打开一个项目目录使用 Codex。
Cursor 自带 AI 和 Codex 插件不是一回事

如果你想在 Cursor 里用 Codex，建议安装 OpenAI Codex 插件，或者在 Cursor 内置终端直接运行 codex。Cursor 自带模型设置通常不会自动读取 ~/.codex。

如果 IDE 插件提示找不到配置，先确认本机已有 ~/.codex/config.toml 和 ~/.codex/auth.json，然后重启 IDE。

常用软件

软件服务商Base URL / API HostAPI Key模型
ChatBoxOpenAI Compatiblehttps://api.tianbaozy.top/v1sk-你的APIKeygpt-5.4
Cherry StudioOpenAI Compatiblehttps://api.tianbaozy.top/v1sk-你的APIKeygpt-5.4
NextChat / LobeChatOpenAIhttps://api.tianbaozy.top/v1sk-你的APIKeygpt-5.4
沉浸式翻译OpenAI 或自定义 OpenAIhttps://api.tianbaozy.top/v1/chat/completionssk-你的APIKeyGPT-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)

常见报错

401 / invalid api key

Key 没复制完整、前后有空格、用了别的平台 Key，或这个 Key 已删除。重新到 API 密钥页面复制本站 Key。

额度不足 / no available account

套餐过期、额度用完、Key 没绑定正确分组，或上游临时不可用。先看站内用量，再联系客服排查。

model not found

模型名写错或当前套餐分组没有该模型。先请求 /v1/models 看可用模型，再复制模型名。

支付成功但套餐没开通

先刷新充值订阅页面。如果 1 到 3 分钟仍未到账，把注册邮箱、支付时间、套餐名发给客服。

Claude Code 连不上

ANTHROPIC_BASE_URL 应为 https://api.tianbaozy.top，不要写 /v1。

OpenAI 客户端请求失败

ChatBox、Cherry Studio、OpenAI SDK 通常要填 https://api.tianbaozy.top/v1，不要只填根域名。

Windows 无法运行 ps1

用 PowerShell 执行 powershell -ExecutionPolicy Bypass -File .\setup-tianbao-ai-codex-windows.ps1。

IDE 插件找不到配置

先在系统终端确认 codex -p "只回复 OK" 可用，然后完全退出并重开 VS Code / Cursor。

联系客服

遇到无法解决的问题，请把这些信息发给客服，定位会快很多：

  • 注册邮箱。
  • 使用的软件，例如 Codex CLI、Claude Code、ChatBox、Cherry Studio。
  • 报错截图或完整错误文本。
  • 大概发生时间、套餐名称、模型名称。
联系方式

QQ：2458845424

本文档为天宝 AI 接入说明。请合理使用 API，不要用于违法违规、恶意攻击、批量注册、垃圾内容生成等场景。