官网Dashboard
Agent 使用文档03-API接入/02-Agent与开发接入.md

Agent 与开发接入

文档中心

文档中心位于 /dashboard/docs。普通用户可以从这里进入：

  • Agent 安装与教程：/dashboard/agents
  • 开发文档：/dashboard/docs/developer

Agent 聚合页包含 Codex、Openclaw、Claude Code、Opencode、Gemini CLI、VS Code、Cursor 等入口。

接入前准备

接入前需要准备：

  1. 已登录 Dashboard。
  2. 已创建 API Key。
  3. 知道该 Key 对应的 Provider。
  4. 知道客户端需要的 Base URL。
  5. 选择一个页面展示支持的模型名。

Base URL 规则

常用地址：

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

如果 API Key 页面返回了特定的 Gateway Base URL，应优先使用页面展示的地址。

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"

Claude Code

Claude Code 通常使用 Anthropic-compatible 接入方式。

核心环境变量：

export ANTHROPIC_BASE_URL="https://api.token4ai.cloud"
export ANTHROPIC_API_KEY="YOUR_API_KEY"

如果使用项目级配置，可以把 Base URL 写入项目配置，把 API Key 写入本地私有配置，避免提交到 Git。

Gemini CLI

Gemini CLI 通常使用 Gemini-compatible 接入方式。

核心环境变量：

export GEMINI_API_KEY="YOUR_API_KEY"
export GOOGLE_GEMINI_BASE_URL="https://api.token4ai.cloud"

配置后在项目目录运行 gemini 验证连接。

OpenAI-compatible 开发接入

自研应用或兼容 OpenAI SDK 的客户端可按 OpenAI-compatible 方式请求：

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"}]}'

生产使用时应把 API Key 放入环境变量或密钥管理系统，不要写入前端代码。

其他 Agent

Cursor、VS Code、Opencode、Openclaw 等工具的接入方式取决于它们支持的 Provider 或 OpenAI-compatible 配置项。通用原则：

  • 能配置 OpenAI Base URL 的工具，优先使用 https://api.token4ai.cloud/v1。
  • 能配置 Anthropic Base URL 的工具，使用 https://api.token4ai.cloud。
  • API Key 使用对应 Provider 创建的 Key。
  • 模型名不要凭空填写，应以 Dashboard 文档或模型列表为准。

验证接入是否成功

  1. 客户端能正常返回模型响应。
  2. Dashboard 使用历史出现新记录。
  3. 余额发生合理变化。
  4. 错误率没有异常升高。
  5. 使用历史中的 Provider、模型、Key、渠道符合预期。

相关页面