接入文档

三分钟接入全部顶级模型。只讲你用得到的，不讲废话。

快速开始

Python（OpenAI SDK）

from openai import OpenAI
client = OpenAI(base_url="https://tommyapi.com/v1", api_key="sk-你的密钥")
resp = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

curl

curl https://tommyapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.5","messages":[{"role":"user","content":"你好"}]}'

客户端软件（Cherry Studio / Cline / opencode 等）

供应商选 OpenAI 兼容，填 Base URL 和 Key 即可。模型列表可自动拉取（我们的 /v1/models 带价格与上下文长度元数据）。

选模型

全部模型与实时价格见模型广场。不知道选什么？记住这四个：

功能特性

联网搜索 —— 模型名加 :online

任何对话模型都能联网。两种开启方式，效果一样：

# 方式一：模型名后缀
{"model": "gpt-5.5:online", ...}
# 方式二：标准参数
{"model": "claude-sonnet-4-6", "web_search_options": {}, ...}

回答会带来源链接；搜索失败不影响正常回答。

读 PDF —— 任何模型

消息里加 file 内容块（base64 或 URL 都行），网关自动解析成文本给模型，上游支不支持都能用：

{"role": "user", "content": [
  {"type": "text", "text": "总结这份文件"},
  {"type": "file", "file": {
    "filename": "report.pdf",
    "file_data": "data:application/pdf;base64,..."  # 或 "file_url": "https://..."
  }}
]}

单文件最大 30MB。Anthropic 原生 /v1/messages 的 document 块同样支持。

自动兜底 —— models 备选数组

主模型限流或故障时，按你给的顺序自动切换，请求不失败：

{"model": "claude-sonnet-4-6",
 "models": ["claude-sonnet-4-6", "gpt-5.5", "gemini-3-flash"], ...}

实际使用的模型看响应的 model 字段；按实际使用的模型计费。

视觉（看图）

标准 image_url 内容块，URL 或 base64 都行——网关自动归一化，不用管上游偏好：

{"type": "image_url", "image_url": {"url": "https://…/photo.jpg"}}

结构化输出（JSON Schema）

标准 response_format 参数四家全通。GPT 走原生 strict 模式，其他模型自动降级注入，都返回可直接 json.loads 的裸 JSON。

计费与充值

• 充值汇率：¥1 = $1 账面余额，余额永不过期，无月费无门槛。
• 海外模型标价即实付：Claude / GPT / Gemini 标价与官方美元牌价完全一致，已含全部费用——用官方的价，走人民币充值。
• 国产模型：标价为官方人民币牌价（美元计），实际扣费 = 标价 × 2 服务倍率（含直连线路与联网 / PDF / 兜底等增强能力）。
• 充值方式：控制台 → 钱包 → 兑换码即充即到；大额或对公请联系客服。
• 长任务建议开 stream=true，避免网关超时。

常见问题