User Guide
TokenFlow 接入文档
TokenFlow 使用 OpenAI 兼容接口。大多数客户端只需要填写服务地址、API Key 和模型名称。
最快接入
- 注册并登录 TokenFlow 账号。
- 在控制台的令牌管理中创建 API Key。
- 进入充值页，付款后使用兑换码充值额度。
- 在客户端中选择 OpenAI Compatible，并填入下方三项。
常用客户端
新增 OpenAI 兼容服务，填入 Base URL、API Key 和模型名。模型列表不显示时，可以手动添加模型名。
Provider 选择 OpenAI，Base URL 填 TokenFlow 地址，API Key 填自己的令牌。
Provider 选择 OpenAI Compatible，模型填模型广场中的精确名称，例如 gpt-5.5。
打开配置生成器，选择模型后使用 CCSwitch TOML。GPT 和 Claude 系列都可以用 OpenAI 兼容地址，Claude Code 另用 Claude Code 标签页。
在配置生成器选择 Claude 模型，使用 Claude Code 标签页；ANTHROPIC_BASE_URL 使用不带 /v1 的地址。
使用 OpenAI SDK 时设置 base_url 或 baseURL，其他调用方式保持 OpenAI 格式。
调用示例
$base = "https://api.zhehentiaohe.cn/v1"
$key = "sk-你的令牌"
$body = @{
model = "gpt-5.5"
messages = @(
@{ role = "user"; content = "你好，只回复 OK" }
)
stream = $false
} | ConvertTo-Json -Depth 8 -Compress
$bytes = [System.Text.Encoding]::UTF8.GetBytes($body)
Invoke-RestMethod `
-Uri "$base/chat/completions" `
-Method Post `
-Headers @{ Authorization = "Bearer $key" } `
-ContentType "application/json; charset=utf-8" `
-Body $bytesfrom openai import OpenAI
client = OpenAI(
api_key="sk-你的令牌",
base_url="https://api.zhehentiaohe.cn/v1",
)
resp = client.chat.completions.create(
model="gpt-5.5",
messages=[{"role": "user", "content": "你好，只回复 OK"}],
)
print(resp.choices[0].message.content)模型和计费
模型、可用状态和价格以模型广场为准。用户实付 1 CNY 对应站内 $1 余额；下表按当前用户侧模型广场计费估算，单位为 1M tokens。
常见问题
检查 API Key 是否完整复制，是否带有多余空格，令牌是否被禁用或余额不足。
Windows PowerShell 请求时请把 JSON 转成 UTF-8 bytes，并设置 application/json; charset=utf-8。
通常和超大上下文、推理强度、缓存命中有关。减少历史上下文或使用更轻量模型会更快。
gpt-image-2 当前按低质量单图开放，约扣 0.05 余额/张；服务端会限制为单图低质量输出，返回通常为 b64_json，需要客户端把 base64 内容保存为图片。