TommyAPI 文档中心

OpenAI 兼容 API · 统一接入 Claude、GPT、Gemini、国产模型

快速开始

Base URL

https://tommyapi.com/v1

第一个请求

# cURL
curl https://tommyapi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "你好，介绍一下 TommyAPI"}]
  }'

OpenAI SDK 接入

# Python
from openai import OpenAI

client = OpenAI(
    base_url="https://tommyapi.com/v1",
    api_key="sk-YOUR_KEY"
)

response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)
完全兼容 OpenAI SDK。 把 base_url 换成 TommyAPI 即可接入所有模型，无需改代码。

模型目录

claude max官 Claude 全系 · 4 模型

模型 ID说明
claude-haiku-4-5-20251001Claude Haiku 4.5 — 轻量快速
claude-opus-4-6Claude Opus 4.6 — 最高质量
claude-opus-4-7Claude Opus 4.7 — 最新旗舰
claude-sonnet-4-6Claude Sonnet 4.6 — 主力平衡

codex max官 GPT/Codex 全系 · 10 模型

模型 ID说明
gpt-5.2GPT 5.2
gpt-5.3-codexGPT 5.3 Codex — 代码优化
gpt-5.3-codex-sparkGPT 5.3 Codex Spark — 极速代码
gpt-5.4GPT 5.4
gpt-5.4-miniGPT 5.4 Mini — 轻量低延迟
gpt-5.5GPT 5.5 — 最新
+ compact 经济版本：gpt-5.2-compact / gpt-5.3-codex-compact / gpt-5.4-compact / gpt-5.5-compact

gemini pro官 Gemini 全系 · 2 模型

模型 ID说明
gemini-3-flash-previewGemini 3 Flash — 快速响应
gemini-3.1-pro-previewGemini 3.1 Pro — 深度推理

国产崛起 国产模型全系 · 12 模型

模型 ID厂商说明
deepseek-chatDeepSeekDeepSeek Chat V3
deepseek-reasonerDeepSeekDeepSeek Reasoner R1
deepseek-v4-flashDeepSeekDeepSeek V4 Flash — 1M 上下文
deepseek-v4-proDeepSeekDeepSeek V4 Pro — 1M 上下文
deepseek-v3百炼DeepSeek V3 (百炼)
deepseek-r1百炼DeepSeek R1 (百炼)
kimi-k2.6MoonshotKimi K2.6
kimi-kh2.6百炼Kimi KH2.6
qwen3.5-plus阿里Qwen 3.5 Plus
qwen3.6-plus阿里Qwen 3.6 Plus
qwen3.6-max-preview阿里Qwen 3.6 Max
glm-5.1智谱GLM 5.1

计费说明

TommyAPI 使用 分组倍率 计费模式。每个 Token 消耗 = 模型倍率 × 分组倍率。

分组倍率

分组分组倍率
claude max官1.5×
codex max官1.5×
gemini pro官1.5×
国产崛起1.5×
计费公式：消耗额度 = 模型倍率 × 分组倍率 × Token 数
例如：claude-sonnet-4-6，模型倍率 66.67，分组倍率 1.5，1000 Token = 66.67 × 1.5 × 1000 = 100,005 额度

获取 API Key 与充值

访问 TommyAPI 首页 注册并获取 Key。充值后在 控制台 查看余额与用量。

认证方式

所有 API 请求需要 Authorization: Bearer 头：

Authorization: Bearer sk-YOUR_API_KEY

API Key 在 TommyAPI 控制台生成。每个 Key 关联一个分组，决定可用的模型范围。

错误码

HTTP 状态码含义处理建议
200成功—
400请求参数错误检查 model 名称、messages 格式
401认证失败检查 API Key 是否正确、是否过期
402余额不足充值后重试
429速率限制降低请求频率，稍后重试
500服务端错误等待重试，或联系支持
503服务不可用上游模型暂时不可用，稍后重试

速率限制

TommyAPI 根据用户等级和分组实施速率限制：