全场景 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 请替换为你在本站创建的密钥。

快速开始

  1. 登录 天宝 AI
  2. 进入 充值订阅 页面,选择日卡、周卡或轻享月卡并完成支付。
  3. 进入 API 密钥 页面,创建一个新的 API Key。
  4. 在你的工具或代码里配置接口地址和 API Key。
  5. 先用 /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 是否可用,并查看当前可用模型。

套餐与额度

日卡 4.90 元,有效期 1 天,每日额度 20,适合临时体验。
周卡 16.90 元,有效期 7 天,每周额度 100,适合中度使用。
轻享月卡 39.90 元,有效期 30 天,每月额度 300,适合轻量长期使用。

额度按站内计费口径扣减,不同模型、输入输出 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 Keysk-你的APIKey
API Host / Base URLhttps://api.tianbaozy.top/v1
模型gpt-5.4GPT-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_URLhttps://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