官网Dashboard
API 接入文档

API Key 管理

API Key 是你调用 Token4AI Cloud 网关的凭证。接入前先创建一个 Key，再把它配置到 Agent、SDK、命令行工具或服务端应用中。

创建 API Key

  1. 登录 Dashboard。
  2. 打开 /dashboard/api-keys。
  3. 选择 Provider，例如 OpenAI、Anthropic、Gemini 或 MiniMax。
  4. 查看页面展示的支持模型和可选分组。
  5. 选择一个或多个渠道分组。
  6. 点击创建 API Key。
  7. 立即复制完整 Key，并保存到本地密钥管理器或服务端环境变量。

完整 Key 只应该保存在你信任的本地环境、服务器密钥管理系统或 CI Secret 中。不要把完整 Key 放到前端代码、公开仓库、截图、Issue 或聊天窗口里。

选择正确的 Provider

Provider 决定你应该使用哪类协议和 Base URL：

| 使用场景 | 推荐 Provider | Base URL | | --- | --- | --- | | Codex、OpenAI SDK、OpenAI-compatible 客户端 | OpenAI | https://api.token4ai.cloud/v1 | | Claude Code、Anthropic-compatible 客户端 | Anthropic | https://api.token4ai.cloud | | Gemini CLI、Gemini-compatible 客户端 | Gemini | https://api.token4ai.cloud | | 兼容 OpenAI 协议的其他模型 | 页面展示为准 | 通常为 https://api.token4ai.cloud/v1 |

如果 API Key 页面展示了特定接入地址，优先使用页面展示的地址。

分组如何选择

分组代表这个 Key 可以走的调用通道。一般建议：

  • 第一次测试：选择页面默认或推荐分组。
  • 生产服务：为生产单独创建 Key，不要和本地测试共用。
  • 多项目团队：按项目、环境或负责人拆分 Key。
  • 需要更高可用性：选择多个分组，让系统按配置顺序处理。

分组名称、说明、倍率和可用性以 Dashboard 当前展示为准。

在本地保存 Key

推荐用环境变量保存：

export TOKEN4AI_API_KEY="你的 API Key"

OpenAI-compatible 客户端通常也支持：

export OPENAI_API_KEY="$TOKEN4AI_API_KEY"

Anthropic-compatible 客户端通常使用：

export ANTHROPIC_API_KEY="$TOKEN4AI_API_KEY"

Gemini-compatible 客户端通常使用：

export GEMINI_API_KEY="$TOKEN4AI_API_KEY"

Key 泄露或丢失怎么办

如果完整 Key 丢失：

  1. 创建一个新 API Key。
  2. 更新本地、服务器或 CI 中的环境变量。
  3. 验证新 Key 可以正常调用。
  4. 删除旧 Key。

如果怀疑 Key 泄露，应立即删除该 Key，并检查使用历史中是否有异常调用。

接入失败时先检查

  1. API Key 是否来自当前账号。
  2. Provider 和客户端协议是否匹配。
  3. Base URL 是否正确。
  4. 模型名是否属于当前 Provider。
  5. 账号余额是否足够。
  6. Key 是否选中了可用分组。
  7. 使用历史中是否出现对应请求和错误信息。

下一步