Quick Start

TT API 是 OpenAI 兼容的统一 AI 网关，endpoint 在 https://api.ttapi.cc/，把 OpenAI SDK 的 base_url 指过来、换上本站 API Key 就能调用 Claude、GPT、Gemini、DeepSeek 等 40+ 模型。本文用 Python / Node.js / cURL 三种语言演示 5 分钟跑通首次调用。

前置准备

第一步：切换 Base URL

我们的接口完全兼容 OpenAI 协议。只需要把 OpenAI SDK 的 base_url 指向我们，并替换为本平台的 API Key，原有业务代码无需改写。

# 通用 base url
https://api.ttapi.cc/v1

第二步：发起首次调用

下面给出三种主流语言的示例。

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.ttapi.cc/v1",
    api_key="sk-...",
)

resp = client.chat.completions.create(
    model="claude-4.7-opus",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from 'openai'

const client = new OpenAI({
  baseURL: 'https://api.ttapi.cc/v1',
  apiKey: 'sk-...',
})

const resp = await client.chat.completions.create({
  model: 'gpt-5.5',
  messages: [{ role: 'user', content: '你好' }],
})
console.log(resp.choices[0].message.content)

cURL

curl https://api.ttapi.cc/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-..." \
  -d '{
    "model": "gemini-2.5-pro",
    "messages": [{"role": "user", "content": "你好"}]
  }'

补充：使用 Anthropic 官方 SDK

如果你已经在用 @anthropic-ai/sdk 或 Python anthropic 包，不用切换到 OpenAI SDK —— 我们也兼容 Anthropic 的 /v1/messages 协议，把 base_url 改成 https://api.ttapi.cc（注意不带 /v1），api_key 用本平台 Key 即可。

from anthropic import Anthropic

client = Anthropic(
    base_url="https://api.ttapi.cc",     # 注意是站点根，不带 /v1
    api_key="sk-...",                # 本平台 API Key
)
msg = client.messages.create(
    model="claude-opus-4-7",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}],
)
print(msg.content[0].text)

import Anthropic from '@anthropic-ai/sdk'

const client = new Anthropic({
  baseURL: 'https://api.ttapi.cc',
  apiKey: 'sk-...',
})

const msg = await client.messages.create({
  model: 'claude-opus-4-7',
  max_tokens: 1024,
  messages: [{ role: 'user', content: '你好' }],
})
console.log(msg.content[0].text)

同一个 API Key 在 OpenAI 协议和 Anthropic 协议下都能用，互相不冲突；用量和扣费照常合并到你的账户余额里。

第三步：切换模型

所有支持的模型都共用同一套接口，只需要修改 model 字段即可：

完整模型列表可以在控制台「模型」页面查看，包含每个模型的实时计费倍率。

第四步：查看计费与日志

调用完成后，可以在控制台的两个页面查看明细：

每次调用结束时会实时扣减额度，余额不足会返回 402 Payment Required，及时充值即可恢复。

常见错误与排查

非 2xx 响应时先按下表初步定位，再去「调用日志」展开行看完整错误堆栈。

状态码 含义 处理
400 请求体不合法 / 模型名不存在 / messages 为空 核对 JSON 结构和 model 字段拼写
401 API Key 错误、被禁用、过期，或不在 IP 白名单 控制台核对 Key 状态；若设过 IP 白名单确认调用方公网 IP
402 余额或单 Key 额度超限 充值或调整 Key 额度上限
429 RPM / RPD 限速触发 等几秒重试；持续高并发可申请提速
5xx 服务临时不可用 网关会自动重试一次；持续报错可切换其他模型规避

字段含义和完整排查思路见 调用日志解读。

下一步

跑通第一次调用之后，建议看这几篇：

接入过程中遇到问题，可以在控制台右下角联系支持。