快速开始
本文带你用最短的路径发出第一次 TTToken 请求。如果你已经熟悉 OpenAI SDK,只需要把 base_url 改成 https://tttoken.xyz/v1,其它代码完全不变。
第一步:注册账号并获取 API Key
- 打开 https://tttoken.xyz/ 注册账号(支持邮箱、GitHub、Google、LinuxDo 登录)。
- 登录后在左侧「令牌」→「添加新的令牌」。
- 填写名称、额度(单位为美元),点击「提交」。
- 在令牌列表行中点击「复制」即可得到形如
sk-xxxxxxxxxxxx的密钥。
⚠️ 安全
API Key 与你的余额直接挂钩,请勿提交到 Git、聊天记录或任何公开场合。
第二步:配置 Base URL
TTToken 的 Base URL 统一为:
BASE
https://tttoken.xyz不同协议在此基础上叠加路径:
| 协议 | 完整 Base |
|---|---|
| OpenAI 兼容 | https://tttoken.xyz/v1 |
| Anthropic 兼容 | https://tttoken.xyz(调用 /v1/messages) |
| Google Gemini 兼容 | https://tttoken.xyz/v1beta |
第三步:发起第一次请求
复制下面任一示例,把 $TTT_KEY 替换为你刚才拿到的令牌即可。
curl https://tttoken.xyz/v1/chat/completions \
-H "Authorization: Bearer $TTT_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o-mini",
"messages": [{"role": "user", "content": "你好,介绍下你自己"}]
}'
from openai import OpenAI
client = OpenAI(
api_key="$TTT_KEY",
base_url="https://tttoken.xyz/v1",
)
resp = client.chat.completions.create(
model="gpt-4o-mini",
messages=[{"role": "user", "content": "你好,介绍下你自己"}],
)
print(resp.choices[0].message.content)
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.TTT_KEY,
baseURL: "https://tttoken.xyz/v1",
});
const resp = await client.chat.completions.create({
model: "gpt-4o-mini",
messages: [{ role: "user", content: "你好,介绍下你自己" }],
});
console.log(resp.choices[0].message.content);
package main
import (
"context"
"fmt"
"github.com/sashabaranov/go-openai"
)
func main() {
cfg := openai.DefaultConfig("$TTT_KEY")
cfg.BaseURL = "https://tttoken.xyz/v1"
cli := openai.NewClientWithConfig(cfg)
resp, _ := cli.CreateChatCompletion(context.TODO(), openai.ChatCompletionRequest{
Model: "gpt-4o-mini",
Messages: []openai.ChatCompletionMessage{
{Role: "user", Content: "你好"},
},
})
fmt.Println(resp.Choices[0].Message.Content)
}
流式调用
只需在请求体中加上 "stream": true,TTToken 会透传官方 SSE 格式:
curl https://tttoken.xyz/v1/chat/completions \
-H "Authorization: Bearer $TTT_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-5",
"stream": true,
"messages": [{"role": "user", "content": "用一句话解释光合作用"}]
}'
下一步
- 身份认证:令牌、分组(Group)、限速
- OpenAI 兼容接口:完整参数与端点
- 模型列表:挑选合适的模型
- 错误码:常见错误与排查