Skip to content

常见问题 ​

TokenSG 与直接调用 OpenAI/Anthropic/Google 有什么区别? ​

TokenSG 提供统一的 API,让你通过一个端点和一个 API Key 访问多家供应商(OpenAI、Anthropic、Google 等)的模型。优势包括:

  • 一个 API,多种模型 — 无需为每个供应商单独管理账号和密钥
  • 成本优势 — 按量付费,价格有竞争力
  • 高可用 — 多通道自动故障转移
  • OpenAI 兼容 — 使用标准 OpenAI SDK,零代码改动

如何从 OpenAI 迁移到 TokenSG? ​

只需修改一行代码,更新 OpenAI SDK 配置中的 base_url:

python
# 之前(直接调用 OpenAI)
client = OpenAI(api_key="sk-openai-key")

# 之后(使用 TokenSG)
client = OpenAI(
    api_key="sk-your-tokensg-key",
    base_url="https://api.tokensg.ai/v1",
)
javascript
// 之前(直接调用 OpenAI)
const client = new OpenAI({ apiKey: 'sk-openai-key' })

// 之后(使用 TokenSG)
const client = new OpenAI({
  apiKey: 'sk-your-tokensg-key',
  baseURL: 'https://api.tokensg.ai/v1',
})

你现有的所有代码 — 模型参数、消息格式、流式输出 — 完全不变。

使用 Claude Code / OpenCode / Codex 等 CLI?参考 集成指南 查看分步说明。

支持哪些模型? ​

TokenSG 支持来自 OpenAI、Anthropic、Google 等多家供应商的模型。访问 模型页面 查看完整列表和实时定价。

如何查看余额和用量? ​

登录 TokenSG 控制台 可查看:

  • 余额 — 当前账户余额
  • 用量 — 请求历史和费用明细
  • 充值 — 通过信用卡充值(由 Airwallex 提供支付服务)

我的账户有企业协议价,为什么 /v1/models 返回的还是公开价? ​

GET /v1/models 返回的是平台公开价目表,不随调用方账户变化。实际扣费始终按你账户的专属价,请以控制台的用量日志与账单为准。详见 企业专属定价。

登录控制台后,模型列表、价格对比与模型详情展示的都是你的专属价;未登录时以及官网上展示的是公开价。

API Key 丢失怎么办? ​

API Key 仅在创建时显示一次。如果丢失了密钥:

  1. 登录 控制台
  2. 撤销丢失的密钥(防止未授权使用)
  3. 创建新密钥
  4. 在应用中更新为新密钥

请求失败如何排查? ​

  1. 查看错误响应 — type 字段会告诉你出了什么问题。详见 错误码。
  2. 验证 API Key — 确保密钥有效,且已包含在 Authorization: Bearer 请求头中。
  3. 检查余额 — 402 错误表示需要充值。
  4. 检查频率限制 — 429 错误表示请求过于频繁,请实现退避重试。
  5. 尝试其他模型 — 503 错误表示模型暂时不可用,可以尝试其他模型。
  6. 检查请求格式 — 确保请求体符合 API 参考 的格式要求。