官网Dashboard
Agent 使用文档

Agent 与开发接入

本页帮助你最快把 Token4AI Cloud 接入到 Agent 工具或自己的服务端应用。核心步骤只有三步：创建 API Key、选择正确 Base URL、发起测试请求。

5 分钟快速开始

  1. 打开 Dashboard 的 /dashboard/api-keys。
  2. 选择 Provider 并创建 API Key。
  3. 根据客户端类型设置 Base URL。
  4. 把 API Key 写入环境变量。
  5. 发起一次测试请求。
  6. 到 /dashboard/usage 查看请求记录和费用。

常用地址：

OpenAI-compatible: https://api.token4ai.cloud/v1
Anthropic-compatible: https://api.token4ai.cloud
Gemini-compatible: https://api.token4ai.cloud

OpenAI-compatible API

适用于 OpenAI SDK、Codex、Cursor、VS Code、Opencode、Continue、Openclaw，以及大多数支持自定义 OpenAI Base URL 的客户端。

export TOKEN4AI_API_KEY="你的 API Key"

curl https://api.token4ai.cloud/v1/chat/completions \
  -H "Authorization: Bearer $TOKEN4AI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5","messages":[{"role":"user","content":"Hello from Token4AI Cloud"}]}'

如果你的 SDK 需要配置项：

  • API Key：Dashboard 创建的 API Key。
  • Base URL：https://api.token4ai.cloud/v1
  • Model：以 Dashboard API Key 页面或模型定价页面展示为准。

Codex

Codex 通常使用 OpenAI-compatible 接入。

推荐配置要点：

  • Provider 选择 OpenAI。
  • Base URL 使用 https://api.token4ai.cloud/v1。
  • API Key 使用 Dashboard 创建的 Key。
  • 模型名以当前支持列表为准。

示例配置：

model_provider = "token4aicloud"
model = "gpt-5.4"
model_reasoning_effort = "high"
preferred_auth_method = "apikey"

[model_providers.token4aicloud]
name = "token4aicloud"
base_url = "https://api.token4ai.cloud/v1"
wire_api = "responses"

同时在本地环境中保存：

export OPENAI_API_KEY="你的 API Key"

Claude Code

Claude Code 使用 Anthropic-compatible 接入。

export ANTHROPIC_BASE_URL="https://api.token4ai.cloud"
export ANTHROPIC_API_KEY="你的 API Key"

配置后在项目目录运行 Claude Code，并确认请求能在 Dashboard 使用历史中看到。

Gemini CLI

Gemini CLI 使用 Gemini-compatible 接入。

export GOOGLE_GEMINI_BASE_URL="https://api.token4ai.cloud"
export GEMINI_API_KEY="你的 API Key"

配置后运行一次简单请求，再到使用历史确认记录。

Cursor / VS Code / Opencode / Openclaw

这些工具的配置方式不同，但判断逻辑一致：

  1. 如果工具支持 OpenAI-compatible Provider，使用 https://api.token4ai.cloud/v1。
  2. 如果工具支持 Anthropic-compatible Provider，使用 https://api.token4ai.cloud。
  3. API Key 填 Dashboard 创建的 Key。
  4. 模型名不要凭空填写，以 Dashboard 展示为准。

建议为不同工具或项目创建不同 API Key，方便后续按 Key 查看用量和排查成本。

服务端应用接入建议

生产环境不要把 API Key 放到浏览器端。推荐：

  • 后端服务通过环境变量读取 API Key。
  • CI/CD 使用 Secret 注入。
  • 不同环境使用不同 Key，例如 dev、staging、prod。
  • 日志里不要打印完整 Key。
  • 定期检查使用历史和异常费用。

如何确认接入成功

接入成功应同时满足：

  1. 客户端返回正常模型响应。
  2. Dashboard /dashboard/usage 出现新请求。
  3. 记录中的 Provider、模型、API Key 和时间符合预期。
  4. 费用和 Token 消耗在合理范围内。

如果客户端报错，先检查 API Key、Base URL、模型名、余额和分组。仍无法解决时，通过 /dashboard/contact 或 /dashboard/support 联系支持，并提供错误文本、请求时间、Provider、模型名、Base URL 和 API Key 后四位。

相关页面