API 中转站使用文档

用户接口用户

▼ 我的令牌

1 进入令牌管理

2 创建新令牌

点击 添加令牌 按钮，在弹出的窗口中设置：

参数	说明	建议
令牌名称	便于识别的标签	如 `我的项目`
可用额度	限制该令牌最大消耗	根据需要填写
可用模型	选择允许调用的模型	不选则全部可用
IP 白名单	限制来源 IP	可选，留空不限制

确认后生成唯一令牌，格式为 sk-xxxxxxxxxxxx。

⚠立即复制保存！关闭弹窗后不再显示完整令牌。

3 管理令牌

在令牌列表页可以：

查看 — 各令牌的状态、已用量、剩余量、最后使用时间
编辑 — 修改名称、额度限制、可用模型和 IP 白名单
启用/禁用 — 临时停用某令牌，不影响其他令牌
删除 — 移除不需要的令牌，删除后立即失效且不可恢复

ℹ每个令牌独立计费，方便区分不同项目的用量。建议为不同用途创建独立令牌。

▼ 余额 & 用量

用户可在个人中心查看：

账户余额 — 当前可用余额
今日用量 — 今日已消耗 Token 数
历史用量 — 按日期查询调用次数和 Token 消耗明细
充值记录 — 充值历史记录
兑换码充值 — 输入兑换码快速增加余额

用户可在 模型广场 浏览所有可用的模型，并按分组快速筛选：

分组	包含模型
基础对话	`gpt-4o-mini`、`deepseek-chat`
高级推理	`gpt-4o`、`claude-sonnet-4`
绘图	`dall-e-3`

模型调用接口 API

所有接口遵循 OpenAI API 格式，兼容 OpenAI 官方 SDK、LangChain、LlamaIndex 等主流框架。

▼ Chat Completions

对话补全接口，支持所有对话类模型。

POST /v1/chat/completions

{
  "model": "gpt-4o-mini",
  "messages": [
    {"role": "system", "content": "You are a helpful assistant."},
    {"role": "user", "content": "Hello, introduce yourself"}
  ],
  "temperature": 0.7,
  "max_tokens": 2048,
  "stream": false
}

参数说明

参数	类型	必填	说明
`model`	string	Y	模型名称，如 `gpt-4o-mini`
`messages`	array	Y	对话消息列表
`temperature`	number	N	生成随机性，0~2，默认 1
`max_tokens`	integer	N	最大生成长度
`stream`	boolean	N	是否流式输出，默认 false
`top_p`	number	N	核采样参数，0~1

返回示例 (Response 200)

{
  "id": "chatcmpl-8a1b2c3d4e5f",
  "object": "chat.completion",
  "created": 1734567890,
  "model": "gpt-4o-mini",
  "choices": [
    {
      "index": 0,
      "message": {"role": "assistant", "content": "Hello! I am an AI assistant..."},
      "finish_reason": "stop"
    }
  ],
  "usage": {"prompt_tokens": 28, "completion_tokens": 42, "total_tokens": 70}
}

流式调用 (Stream)

设置 "stream": true，服务端以 SSE 格式逐块返回数据，最终以 data: [DONE] 结束。

流式返回

data: {"choices":[{"delta":{"role":"assistant"},"index":0}]}
data: {"choices":[{"delta":{"content":"Hello"},"index":0}]}
data: {"choices":[{"delta":{"content":"!"},"index":0}]}
data: [DONE]

cURL 调用示例

Shell

curl https://tk.cc1ai.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-token" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

▼ 模型列表查询

查询当前账户可用的所有模型列表。

GET /v1/models

curl https://tk.cc1ai.cn/v1/models \
  -H "Authorization: Bearer sk-your-token"

返回示例

{
  "object": "list",
  "data": [
    {"id": "gpt-4o", "object": "model", "created": 1687882411, "owned_by": "system"},
    {"id": "gpt-4o-mini", "object": "model", "created": 1687882410, "owned_by": "system"},
    {"id": "deepseek-chat", "object": "model", "created": 1691234567, "owned_by": "system"}
  ]
}

▼ 错误码说明

HTTP 状态码	错误类型	说明
`400`	`invalid_request_error`	请求参数错误
`401`	`authentication_error`	API Key 无效或未提供
`403`	`permission_error`	该令牌无权访问指定模型
`429`	`rate_limit_error`	请求频率超限或余额不足
`500`	`api_error`	上游服务异常
`503`	`overloaded_error`	服务暂时过载

⚠遇到 429 时先检查账户余额是否充足。

环境部署指南部署

以下内容指导您本地安装开发环境，以便运行智能体客户端。适用系统：Windows 10 / 11。

▼ 1. 安装 Git

1 下载安装包

访问 https://git-scm.com/download/win

选择 Standalone Installer Git for Windows/x64 Setup 下载。

⚠不要点 "Portable" 或 "ARM64"。

2 安装过程

保持默认路径 C:\Program Files\Git
选择 "Use the Nano editor by default"
其他全部默认，一路 Next

3 验证安装

CMD

git --version

成功显示 git version 2.xx.x.windows.1。

▼ 2. 安装 Node.js

1 下载

访问 https://nodejs.org/zh-cn/download/

选择 左侧 LTS 版本，下载 .msi 安装包。

2 安装过程

确认 "Automatically install the necessary tools" 是勾选状态
全部默认，一路 Next

⚠安装过程可能弹出黑窗口自动安装编译工具，不要关闭，约 3-5 分钟。

3 验证安装

CMD

node -v
npm -v

成功显示 v20.xx.x 和 10.xx.x。

▼ 3. 安装 Python

⚠请下载 Python 3.10 或 3.11 版，3.12+ 部分库不兼容。

1 下载

访问 python.org/downloads/windows/

找到 Python 3.11.x，点击 Download Windows installer (64-bit)。

2 安装过程

务必勾选 "Add Python to PATH"（默认不勾选，必须手动勾上）
点击 "Install Now"

3 验证安装

CMD

python --version

成功显示 Python 3.11.x。

▼ 4. 下载 Codex App

1 下载安装

访问 developers.openai.ac.cn/codex/app

或在应用商店搜索 "Codex" 下载。

2 登录

启动后选择 API KEY 登录，填入 API Key。

▼ 5. 安装 Codex++

Codex++ 是 Codex App 的外部增强启动器，通过外部 launcher 注入增强功能。

1 下载

GitHub：github.com/BigPizzaV3/CodexPlusPlus/releases

2 两个入口

入口	说明
Codex++	静默启动，注入增强功能
Codex++ 管理工具	Tauri 控制面板，管理配置

▼ 6. 配置 API 服务商

1 打开管理工具

启动 Codex++ 管理工具，选择 供应商配置。

2 添加供应商

配置项	值
接入模式	`纯API`
配置模型	`gpt-5.5`（可自定义）
Base URL	`https://tk.cc1ai.cn`
Key	你的 API 令牌

3 保存并启动

点击保存，启动 Codex App 即可使用。

用户接口 用户

模型调用接口 API

环境部署指南 部署

用户接口用户

环境部署指南部署