快速开始

TokenLink 用一把 API Key 和一个统一端点接入所有主流模型，并自动做格式转换，让任意工具调用任意模型。

选择接入方式复制锚点链接

根据你需要的控制粒度，有三种方式：

基础地址复制锚点链接

下文示例中的 $BASE_API 指代上面的基础地址，运行前先设置：

1. 获取 API Key复制锚点链接

登录 控制台 → Keys → 创建 Key。

所有请求都通过 Authorization: Bearer YOUR_API_KEY 认证（也接受 x-api-key 头）。见 认证方式。

2. 发起第一个请求复制锚点链接

把 YOUR_API_KEY 替换为你的 Key。

curl $BASE_API/openai/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5",
    "messages": [{"role": "user", "content": "你好，请介绍一下你自己"}]
  }'

可以用哪些模型？复制锚点链接

用 "model": "auto" 让 TokenLink 自动选择最优模型，也可以指定具体 slug，例如 gpt-5、claude-sonnet-5、gemini-2.5-flash。列出你账号可用的全部模型：

curl $BASE_API/openai/models \
  -H "Authorization: Bearer YOUR_API_KEY"

完整目录与格式见 模型列表。

流式输出复制锚点链接

加 "stream": true 即可逐 token 接收 Server-Sent Events（SSE）：

curl $BASE_API/openai/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5",
    "stream": true,
    "messages": [{"role": "user", "content": "写一首短诗"}]
  }'

错误处理复制锚点链接

错误信息在 describe 字段，并带一个错误码，例如 4004（额度不足）或 4002（上游错误）。见 错误码表。

3. 接入你的应用复制锚点链接

OpenAI SDK（无缝替换）复制锚点链接

把 baseURL 指向 TokenLink，其余代码保持不变。

import os
from openai import OpenAI

client = OpenAI(
    base_url=f'{os.environ["BASE_API"]}/openai',
    api_key="YOUR_API_KEY",
)
completion = client.chat.completions.create(
    model="gpt-5",
    messages=[{"role": "user", "content": "你好"}],
)
print(completion.choices[0].message.content)

Cursor、Windsurf、Aider、Continue 等 OpenAI 兼容工具同理。见 OpenAI SDK 兼容工具。

直接调用 API（完全控制）复制锚点链接

不想引入依赖、需要完全掌控请求/响应时直接用 HTTP——见 OpenAI 兼容 API，以及 Anthropic 和 Gemini 兼容端点。

Agent 工具复制锚点链接

让 AI 编程工具通过 TokenLink 调用任意模型：

• Claude Code — 设置 ANTHROPIC_BASE_URL。
• Codex — 添加 model_providers.tokenlink。
• Gemini CLI — 指向 Gemini 兼容端点。

格式转换自动完成，原理见 协议适配。

视频生成复制锚点链接

通过异步 /videos 端点，从文本或参考图生成视频。见 视频生成 教程。

下一步复制锚点链接

完整端点列表与在线调试见 API 参考；各协议端点差异见 协议适配。