# AI-Tkoens 完整知识库

> 面向 AI 助手的一站式文档合集。可直接作为知识库 / System Prompt 附件输入。

- 站点：[https://ai-tokens.space/v1/zh/docs/](https://ai-tokens.space/v1/zh/docs/)
- 品牌：AI-Tkoens
- 域名：`ai-tokens.space`
- 本文件路径：`/v1/files/AI-Tkoens-knowledge-base.md`（中文别名：`/v1/files/AI-Tkoens-知识库.md`）

## 如何使用本文件

1. 将本 Markdown 全文上传到 ChatGPT / Claude / Cursor / 本地模型的知识库或项目文件。
2. 对助手说：按《AI-Tkoens 完整知识库》指导我完成某某配置/调用。
3. 若只需某一块，可只截取对应大章节（例如「五、AI 应用」或「七、AI 模型接口」）。
4. 实际 Base URL、可用模型、令牌请以你的 AI-Tkoens 控制台为准；本文给出通用步骤与接口形状。

## 目录

- [一、快速开始与产品定位](#一快速开始与产品定位) （3 篇）
- [二、用户端操作指南（控制台日常使用）](#二用户端操作指南控制台日常使用) （10 篇）
- [三、后台管理指南（AI-Tkoens 管理端）](#三后台管理指南ai-tkoens-管理端) （12 篇）
- [四、补充说明与概念](#四补充说明与概念) （16 篇）
- [五、AI 应用接入与配置](#五ai-应用接入与配置) （14 篇）
- [六、Skills 配置与使用](#六skills-配置与使用) （3 篇）
- [七、AI 模型接口（API 参考）](#七ai-模型接口api-参考) （43 篇）
- [八、管理接口（后台 API）](#八管理接口后台-api) （159 篇）
- [九、帮助支持](#九帮助支持) （1 篇）
- [十、合规与可接受使用政策](#十合规与可接受使用政策) （1 篇）

---

# 一、快速开始与产品定位

## 快速开始

探索指南、API、应用与支持资源。

文档链接：https://ai-tokens.space/v1/zh/docs/

### 浏览我们的文档

探索全面的指南和资源，充分利用 AI-Tkoens 的强大功能。

#### 接口文档

全面的 API 接口说明和调用示例。

#### AI 应用

探索基于 AI-Tkoens 开发的各类 AI 应用示例。

#### 帮助支持

常见问题解答和社区交流。

---

## 本知识库用途

本文档汇总了 AI-Tkoens（域名：ai-tokens.space）公开文档中的操作说明与接口说明。
你可以把它整份提供给 AI 助手，让助手据此指导：

1. 注册登录、令牌、额度、订阅等用户端操作
2. 渠道、模型、用户、系统设置等后台管理操作
3. 各类 AI 应用 / CLI / Skill 的接入配置
4. AI 模型 API 与管理 API 的调用方式

约定：
- 产品名统一为 **AI-Tkoens**
- API Base URL 通常为你的站点根地址 + `/v1`（具体以控制台「使用 API」页为准）
- 用户请求头常见：`Authorization: Bearer <令牌>`；部分管理接口还需 `New-Api-User: <user_id>`

---

## API 参考

AI-Tkoens 完整接口文档

文档链接：https://ai-tokens.space/v1/zh/docs/api/

### 概述

AI-Tkoens 提供完整的 RESTful API 接口，分为 **AI 模型接口** 和 **管理接口** 两大类。您可以通过这些接口实现 AI 能力调用和系统管理功能。

在线调试

您可以访问 [Apifox 操练场](https://ai-tokens.space/) 在线测试和调试 API 接口，或浏览下方的 API 文档。

### AI 模型接口

AI 模型接口提供各种 AI 能力的调用，兼容 OpenAI API 格式。

#### 模型列表

获取可用的模型列表。

#### 聊天

对话补全接口。

#### 补全

传统文本补全接口。

#### 嵌入

文本嵌入向量生成接口。

#### 重排序

文档重排序接口。

#### 审查

内容安全审核接口。内容安全审核接口是合规工具之一，不替代部署方自身安全治理义务和上游内容政策要求。面向公众服务应建立滥用举报、日志审计和处置机制。

#### 音频

语音识别和语音合成接口。

#### 实时语音

实时音频流接口。

#### 图像

AI图像生成接口。

#### 视频

AI视频生成接口。

#### 未实现

占位接口，暂未实现。

### 管理接口

管理接口用于系统配置、用户管理、业务管理等后台操作。

#### 系统

系统信息和状态接口。

#### 系统设置

系统配置管理接口。

#### 用户认证

用户登录、注册、密码管理等接口。

#### 用户管理

用户信息管理接口。

#### 双因素认证

2FA 双因素认证接口。

#### OAuth

第三方 OAuth 登录接口。

#### 渠道管理

API 渠道配置管理接口。

#### 模型管理

模型配置管理接口。

#### 令牌管理

API 令牌管理接口。

#### 兑换码

兑换码管理接口。

#### 支付

支付和充值接口。

#### 日志

使用日志查询接口。

#### 统计

数据统计接口。

#### 任务

异步任务管理接口。

#### 分组

用户分组管理接口。

#### 供应商

供应商管理接口。

#### 安全验证

安全验证相关接口。

---

# 二、用户端操作指南（控制台日常使用）

## 注册与登录

支持账号密码注册,以及多种第三方 OAuth 一键登录

文档链接：https://ai-tokens.space/v1/zh/docs/guide/feature-guide/user/auth/

支持账号密码注册,以及多种第三方 OAuth 一键登录。首次使用请先完成注册。

### 登录

#### 账号密码登录

1. 打开平台首页,点击右上角「登录」按钮,或直接访问 `/login`

![登录页](https://ai-tokens.space/v1/assets/media/46a9b0efbf9857f7dc55.png)

1. 在登录页输入用户名和密码,点击「登录」完成登录

#### 第三方 OAuth 登录

如需使用第三方账号登录,点击页面下方对应平台的图标(GitHub、Discord、LinuxDO 等),跳转至第三方授权页面完成授权后自动登录

#### 忘记密码

忘记密码时,点击登录页的「忘记密码」链接,输入注册邮箱后系统会发送重置链接,点击链接设置新密码,原密码随即失效。

### 注册

#### 注册流程

1. 在登录页点击「注册」链接,或直接访问 `/register`

![注册页](https://ai-tokens.space/v1/assets/media/0899c9687bd612f88d81.png)

1. 填写用户名、密码
2. 填写邮箱地址,点击「发送验证码」,将收到的验证码填入输入框
3. 点击「注册」完成账号创建,注册成功后自动跳转至首页

---

## 个人设置

管理账号基本信息、安全设置和第三方账号绑定

文档链接：https://ai-tokens.space/v1/zh/docs/guide/feature-guide/user/personal-setting/

管理账号基本信息、安全设置和第三方账号绑定。登录后点击右上角头像，在下拉菜单中选择「个人设置」，或直接访问 `/console/personal`。

### 基本信息

![个人信息页](https://ai-tokens.space/v1/assets/media/a3769850ed51ba9d664e.png)

#### 修改用户名

在用户名输入框中输入新用户名，点击「保存」

#### 绑定邮箱

填写邮箱地址，点击「发送验证码」，输入验证码后点击「绑定」

#### 更改密码

依次填写当前密码、新密码、确认新密码，点击「修改密码」

### 双因素认证（2FA）

开启 2FA 后，每次登录时除密码外还需输入验证器 App 中的动态码，有效防止账号被盗。

![2FA 设置区域](https://ai-tokens.space/v1/assets/media/7392c3afb235c8c4fe12.png)

#### 开启 2FA

1. 在手机上安装验证器 App（推荐 Google Authenticator 或 Microsoft Authenticator）
2. 在个人设置页找到「双因素认证」区域，点击「开启 2FA」
3. 用验证器 App 扫描页面上显示的二维码，App 中会出现一个 6 位动态码

![2FA 二维码弹窗](https://ai-tokens.space/v1/assets/media/85916a62e3d2b43e31c9.png)

1. 将 App 中显示的 6 位动态码填入验证框，点击「确认开启」
2. 系统显示一组备用码，请立即截图或抄写保存，用于无法使用验证器时的紧急登录

备用码只显示一次，关闭弹窗后无法再次查看。丢失备用码且无法使用验证器时，需联系管理员重置。

### Passkey 无密码登录

Passkey 支持使用设备指纹、面容识别或硬件安全密钥登录，无需输入密码。

![Passkey 设置区域](https://ai-tokens.space/v1/assets/media/b8bd201dd68e5ee4a23f.png)

#### 注册 Passkey

1. 在个人设置页向下滚动，找到「Passkey」区域
2. 点击「注册 Passkey」按钮
3. 浏览器弹出系统验证提示，按提示完成指纹、面容或安全密钥验证
4. 验证通过后 Passkey 注册完成，下次登录时可直接使用

### 第三方账号绑定

将 GitHub、Discord 等第三方账号与当前账号绑定后，可直接用第三方账号登录，无需输入密码。

![第三方账号绑定区域](https://ai-tokens.space/v1/assets/media/e4286a07ca20a1a2f45a.png)

#### 绑定第三方账号

1. 在个人设置页向下滚动，找到「第三方账号绑定」区域
2. 点击要绑定的平台对应的「绑定」按钮
3. 页面跳转至该平台的授权页面，登录并点击「授权」
4. 授权完成后自动跳回，绑定状态变为「已绑定」

### 可用模型查看

查看当前账户可以调用的所有模型，方便复制模型名称用于 API 调用。

![可用模型查看](https://ai-tokens.space/v1/assets/media/289284edacf89c657190.png)

#### 查看和复制模型

1. 在个人设置页向下滚动，找到「可用模型」区域
2. 列表展示所有可用模型的名称
3. 点击模型名称即可复制到剪贴板
4. 可在搜索框中输入关键词快速筛选模型

### 通知设置

配置接收系统通知的方式，支持邮件和 Webhook 两种方式。

#### 邮件通知

![邮件通知设置](https://ai-tokens.space/v1/assets/media/0a6428081820adc65934.png)

1. 在个人设置页找到「通知设置」区域
2. 勾选「启用邮件通知」
3. 选择要接收通知的事件类型： 配额不足提醒 令牌即将过期 系统公告
4. 点击「保存」完成配置

#### Webhook 通知

![Webhook 通知设置](https://ai-tokens.space/v1/assets/media/aa4af2fc5a545de81c69.png)

1. 在通知设置区域勾选「启用 Webhook」
2. 填写 Webhook URL（接收通知的接口地址）
3. 选择要推送的事件类型
4. 点击「测试」验证 Webhook 是否可用
5. 点击「保存」完成配置

Webhook 推送的数据格式为 JSON，包含事件类型、时间戳和详细信息。

### 价格设置

控制是否允许调用未设置价格的模型。

![价格设置](https://ai-tokens.space/v1/assets/media/8d577a641a1d393d285e.png)

#### 配置价格策略

1. 在个人设置页找到「价格设置」区域
2. 选择以下策略之一： **拒绝未定价模型**：只能调用已设置价格的模型（推荐） **允许未定价模型**：可以调用所有模型，未定价模型按默认倍率计费
3. 点击「保存」

允许未定价模型可能导致意外的高额消耗，建议保持默认的「拒绝未定价模型」设置

### IP 记录设置

控制是否在日志中记录 API 调用的来源 IP 地址。

![IP 记录设置](https://ai-tokens.space/v1/assets/media/9849a43dac211f03d047.png)

#### 开启 IP 记录

1. 在个人设置页找到「IP 记录」区域
2. 勾选「启用 IP 记录」
3. 点击「保存」
4. 开启后，在使用记录页面可以看到每次调用的来源 IP

IP 记录有助于：

- 监控异常访问
- 排查安全问题
- 分析流量来源

### 安全设置

#### 重置 API 密钥

![安全设置区域](https://ai-tokens.space/v1/assets/media/7915973d01f50ddc19a6.png)

如果怀疑 API 密钥泄露，可以重置密钥：

1. 在个人设置页找到「安全设置」区域
2. 点击「重置 API 密钥」按钮
3. 确认操作后，系统生成新的密钥
4. 旧密钥立即失效，所有使用旧密钥的令牌需要重新创建

重置 API 密钥后，所有现有令牌将失效，需要重新创建令牌

---

## 令牌管理

令牌是调用 API 的凭证，每个令牌可独立配置权限范围和配额上限

文档链接：https://ai-tokens.space/v1/zh/docs/guide/feature-guide/user/token/

令牌是调用 API 的凭证，每个令牌可独立配置权限范围和配额上限。左侧导航点击「令牌」，或直接访问 `/console/token`。

![令牌列表页](https://ai-tokens.space/v1/assets/media/5a788d091d8348a1c152.png)

令牌列表展示所有已创建的令牌，包含名称、状态、已用配额、剩余配额、过期时间等信息。

### 创建令牌

#### 基本配置

1. 在令牌列表页点击右上角「创建令牌」按钮，弹出创建弹窗
2. 填写令牌名称（建议按用途命名，如「生产环境」「测试用」）

![创建令牌弹窗](https://ai-tokens.space/v1/assets/media/bafd430bb55a2da0959f.png)

#### 高级配置选项

按需配置以下选项：

| 配置项 | 说明 |
| --- | --- |
| 过期时间 | 设置有效期，留空或设为 -1 表示永不过期 |
| 剩余配额 | 限制该令牌可消耗的最大配额，超出后自动失效 |
| 无限配额 | 开启后不受配额限制（仍受账户总配额约束） |
| 模型限制 | 限定该令牌只能调用指定模型，留空表示不限制 |
| IP 白名单 | 限定允许使用该令牌的来源 IP，留空表示不限制 |
| 分组 | 指定该令牌使用的渠道分组 |

#### 保存令牌 Key

点击「提交」，弹窗显示完整的令牌 Key，**立即复制保存**，关闭弹窗后无法再次查看完整 Key

![令牌创建成功，显示完整 Key](https://ai-tokens.space/v1/assets/media/ad9181a2feae3d6640ae.png)

令牌 Key 仅在创建时完整显示一次，请立即复制保存。令牌 Key 具有完整的 API 调用权限，请勿泄露给他人，不要提交到代码仓库。

### 编辑令牌

在令牌列表中找到目标令牌，点击右侧「编辑」按钮，可修改令牌的配置选项（不包括令牌 Key 本身）。

### 删除令牌

在令牌列表中找到目标令牌，点击右侧「删除」按钮，确认后该令牌立即失效，无法恢复。

---

## 使用 API

将平台地址替换 OpenAI 的 base_url，使用平台颁发的令牌作为 api_key，即可开始调用

文档链接：https://ai-tokens.space/v1/zh/docs/guide/feature-guide/user/api/

将平台地址替换 OpenAI 的 `base_url`，使用平台颁发的令牌作为 `api_key`，即可开始调用。

### 操练场在线测试

操练场是内置的在线测试工具，无需编写代码即可直接与模型对话，适合快速验证令牌是否可用。

#### 访问操练场

左侧导航点击「操练场」，或直接访问 `/console/playground`

![操练场页面](https://ai-tokens.space/v1/assets/media/6bf5d83252ac1e40d126.png)

#### 使用操练场

1. 在左侧选择要测试的模型
2. 在底部输入框输入消息内容，点击发送
3. 右侧对话区域显示模型的回复结果

![操练场对话示例](https://ai-tokens.space/v1/assets/media/5b0f685cc7edb3b86bdc.png)

### 获取 API 地址

#### 复制 API 地址

1. 访问平台首页
2. 在页面中部找到 API Base URL 显示区域
3. 点击复制按钮，将地址复制到剪贴板

![首页 API 地址复制区域](https://ai-tokens.space/v1/assets/media/8eba89d3e1f4cb7972c2.png)

#### 配置客户端

将复制的地址填入你的客户端或代码中作为 `base_url`，配合令牌即可开始调用。

### 代码示例

#### Python（OpenAI SDK）

```
from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxxxxxxxxxx",  # 平台颁发的令牌
    base_url="https://your-platform.com/v1"
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)
```

#### Claude 原生格式

```
curl https://your-platform.com/v1/messages \
  -H "x-api-key: sk-xxxxxxxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-3-5-sonnet-20241022", "max_tokens": 1024, "messages": [{"role": "user", "content": "Hello"}]}'
```

#### Gemini 原生格式

```
curl "https://your-platform.com/v1beta/models/gemini-1.5-pro:generateContent?key=sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"contents": [{"parts": [{"text": "Hello"}]}]}'
```

### 支持的接口端点

| 接口 | 路径 | 说明 |
| --- | --- | --- |
| 聊天补全 | POST /v1/chat/completions | 对话生成，支持流式输出 |
| 文本补全 | POST /v1/completions | 传统补全接口 |
| 向量嵌入 | POST /v1/embeddings | 文本向量化 |
| 图像生成 | POST /v1/images/generations | 文生图 |
| 图像编辑 | POST /v1/images/edits | 图像编辑 |
| 语音转文字 | POST /v1/audio/transcriptions | Whisper 等 |
| 文字转语音 | POST /v1/audio/speech | TTS |
| 重排序 | POST /v1/rerank | 文档重排序 |
| Responses API | POST /v1/responses | OpenAI Responses 格式 |
| 实时对话 | GET /v1/realtime （WebSocket） | OpenAI Realtime API |
| 模型列表 | GET /v1/models | 查询可用模型 |

---

## 聊天应用集成

快速将 AI-Tkoens 配置导入到各类 AI 聊天应用中

文档链接：https://ai-tokens.space/v1/zh/docs/guide/feature-guide/user/chat-apps/

AI-Tkoens 支持快速导入配置到多种 AI 聊天应用，方便测试和日常使用。

### 一键导入配置

在控制台→令牌页面可以一键导入配置到支持的聊天应用中。

![一键导入配置](https://ai-tokens.space/v1/assets/media/2b32dc69011596685d56.png)

#### 使用方法

1. 在令牌列表页找到要使用的令牌
2. 点击令牌右侧的「导入」或「配置」按钮
3. 选择目标聊天应用
4. 系统自动跳转到对应应用并填充配置信息

### ChatGPT Next Web

ChatGPT Next Web 目前暂停部署

### Lobe Chat

Lobe Chat 是一款开源的多模态对话应用，支持多种大语言模型（LLM）和插件扩展。它不仅可以实现文本对话，还支持图片、音频等多模态交互，适用于个人助理、知识问答、内容创作等多种场景。Lobe Chat 拥有简洁直观的界面，支持多端同步，用户可以根据需求自定义模型和插件，灵活扩展对话能力。无论是开发者还是普通用户，都能轻松上手，享受智能对话带来的高效体验。

Lobe Chat 目前不支持从 AI-Tkoens 一键导入配置，需要手动填写

#### 配置步骤

1. 打开 Lobe Chat 应用
2. 进入设置页面，找到「语言模型」配置区域
3. 按照以下信息填写配置：

![Lobe Chat 配置填写 - 步骤1](https://ai-tokens.space/v1/assets/media/94c77dd9b9ed7d9c4a3e.png)

- **API 地址**：填写 AI-Tkoens 平台的 Base URL
- **API Key**：填写在 AI-Tkoens 创建的令牌

![Lobe Chat 配置填写 - 步骤2](https://ai-tokens.space/v1/assets/media/bd16ef1b7704cccb8702.png)

1. 点击「保存」完成配置
2. 在模型选择中即可看到 AI-Tkoens 提供的所有可用模型

### AI as Workspace

AI as Workspace 是一种将人工智能能力集成到工作空间中的创新方式。通过将 AI 助手与日常办公、协作、知识管理等场景深度结合，用户可以更高效地处理信息、自动化重复任务，并获得智能建议，提升整体工作效率和体验。

支持从 AI-Tkoens 一键导入配置

#### 使用方法

1. 在 AI-Tkoens 令牌页面点击「导入到 AI as Workspace」
2. 系统自动跳转到 AI as Workspace 并填充配置
3. 确认配置信息后即可开始使用

### AMA 问天

AMA 问天是 AI-Tkoens 提供的智能问答助手，支持多轮对话和复杂问题解答。用户可以通过自然语言与 AMA 问天进行交流，获取知识、技术支持或业务咨询，提升沟通效率和体验。

需要先安装 AMA 问天 app

#### 使用方法

1. 从应用商店下载并安装 AMA 问天应用
2. 在 AI-Tkoens 令牌页面点击「导入到 AMA 问天」
3. 应用自动打开并完成配置
4. 开始与 AI 助手对话

### OpenCat

OpenCat 是一款开源的多平台 AI 聊天客户端，支持多种大语言模型接入。用户可以通过简洁的界面与 AI 进行自然语言对话，适用于日常交流、知识问答和内容创作等多种场景。OpenCat 支持多端同步，配置灵活，适合个人和团队使用。

需要先安装 OpenCat app

#### 使用方法

1. 从应用商店下载并安装 OpenCat 应用
2. 在 AI-Tkoens 令牌页面点击「导入到 OpenCat」
3. 应用自动打开并完成配置
4. 在 OpenCat 中选择模型开始对话

### 手动配置其他应用

对于不支持一键导入的应用，可以手动配置：

#### 配置信息

从 AI-Tkoens 获取以下信息：

| 配置项 | 说明 | 获取位置 |
| --- | --- | --- |
| API Base URL | API 接口地址 | 平台首页或令牌页面 |
| API Key | 令牌密钥 | 创建令牌时显示（仅一次） |
| 可用模型 | 支持的模型列表 | 个人设置→可用模型 或 定价页面 |

#### 通用配置步骤

1. 在目标应用中找到「设置」或「配置」入口
2. 找到「自定义 API」或「OpenAI 兼容接口」配置区域
3. 填写 API Base URL 和 API Key
4. 保存配置后即可使用

大多数支持 OpenAI API 的应用都可以通过填写自定义 API 地址的方式接入 AI-Tkoens

---

## 定价

查看全站模型定价及计费说明

文档链接：https://ai-tokens.space/v1/zh/docs/guide/feature-guide/user/pricing/

### 查看定价

#### 访问定价页

点击左侧导航栏的「定价」，或直接访问 `/pricing`

![定价页全貌](https://ai-tokens.space/v1/assets/media/88970774f24f15ebb6d9.png)

#### 浏览模型价格

页面列出所有可用模型，每行显示模型名称、输入价格和输出价格

#### 搜索模型

可在页面顶部搜索框输入模型名称关键词，快速定位特定模型的价格

### 价格说明

#### 计费规则

- **输入价格**：每 1K 输入 Token 消耗的配额
- **输出价格**：每 1K 输出 Token 消耗的配额
- 实际消耗 = Token 数量 ÷ 1000 × 对应单价

#### 分组差异

不同分组的用户可能享有不同的计费倍率，具体以实际扣减为准，可在充值页查看当前余额变化

---

## 使用记录

查看每次 API 调用的详细信息，支持按时间、模型、令牌等条件过滤

文档链接：https://ai-tokens.space/v1/zh/docs/guide/feature-guide/user/log/

查看每次 API 调用的详细信息，支持按时间、模型、令牌等条件过滤。左侧导航点击「日志」，或直接访问 `/console/log`。普通用户只能看到自己的调用记录。

### 查看使用记录

![个人日志页](https://ai-tokens.space/v1/assets/media/c09bbdb895bca03c342d.png)

日志列表每行展示一次调用记录，包含调用时间、使用的模型、消耗的 Token 数量和配额、调用状态等信息。

### 搜索与过滤

#### 设置过滤条件

1. 在日志页顶部点击「筛选」按钮，展开过滤条件区域

![日志筛选条件展开状态](https://ai-tokens.space/v1/assets/media/a11d4a7fa3665f3706f6.png)

1. 可设置以下过滤条件： **时间范围**：选择开始和结束日期 **模型**：输入模型名称关键词 **令牌名**：选择或输入令牌名称

#### 查看过滤结果

设置完成后点击「查询」，列表自动刷新显示过滤结果

![过滤后的日志列表](https://ai-tokens.space/v1/assets/media/64dc435a65991228b3c8.png)

### 数据统计

#### 访问数据看板

左侧导航点击「数据看板」，或直接访问 `/console`

![个人数据统计图表](https://ai-tokens.space/v1/assets/media/bc98448133487f15d63f.png)

#### 查看统计图表

数据看板页面以折线图或柱状图展示每日 API 调用量和配额消耗趋势。将鼠标悬停在图表上可查看具体日期的详细数据。

---

## 配额与充值

配额是平台内部计费单位，支持多种方式充值

文档链接：https://ai-tokens.space/v1/zh/docs/guide/feature-guide/user/topup/

配额是平台内部计费单位，消耗量 = 实际 Token 数 × 模型倍率。左侧导航点击「钱包管理」，或直接访问 `/console/topup`。

### 充值方式

![充值页面](https://ai-tokens.space/v1/assets/media/aaeb629d84b1b61ef8bb.png)

支持在线支付充值和兑换码两种方式增加账户配额。

| 充值方式 | 说明 |
| --- | --- |
| 兑换码 | 输入管理员生成的兑换码，直接增加配额 |
| EPay | 国内聚合支付（支付宝、微信等） |
| Stripe | 国际信用卡支付 |
| Creem / Waffo | 国际支付平台 |

### 在线支付充值

#### 选择充值金额

在充值页选择充值金额，或手动输入自定义金额

#### 完成支付

1. 选择支付方式（EPay / Stripe / Creem / Waffo）

![选择支付方式](https://ai-tokens.space/v1/assets/media/73022318c8906f1f1953.png)

1. 点击「充值」按钮，页面跳转至对应支付平台
2. 在支付平台完成付款后，自动跳回平台，账户余额更新

### 兑换码充值

#### 输入兑换码

1. 在充值页找到「兑换码」输入区域
2. 在输入框中粘贴或输入管理员提供的兑换码

![兑换码输入区域](https://ai-tokens.space/v1/assets/media/e27dd2275d44820480f6.png)

#### 完成兑换

1. 点击「兑换」按钮，系统验证兑换码有效性
2. 兑换成功后页面提示获得的配额数量，账户余额同步更新

### 邀请返利

每个账号都有唯一的邀请码，当其他人使用你的邀请码注册成功时，你即可获得邀请奖励。

#### 获取邀请码

在充值页或个人设置页找到「邀请」区域，复制你的专属邀请码

![邀请码与返利区域](https://ai-tokens.space/v1/assets/media/3c65b7ab32a4bdadae1f.png)

#### 邀请奖励机制

1. **注册即返利**：被邀请人使用你的邀请码注册成功后，你（邀请人）会立即获得系统配置的一笔「邀请奖励配额」（一次性到账）。
2. **转入主余额**：点击「转入余额」按钮，即可将累计的返利配额转入你的账户主余额中进行使用。

---

## 订阅计划

按周期购买的套餐,适合有稳定用量需求的用户

文档链接：https://ai-tokens.space/v1/zh/docs/guide/feature-guide/user/subscription/

订阅是按周期购买的套餐,购买后在有效期内享受套餐内的配额或特权,适合有稳定用量需求的用户。左侧导航点击「订阅」,或直接访问 `/console/subscription`。

### 查看订阅套餐

![订阅计划列表](https://ai-tokens.space/v1/assets/media/b3a6d9f74bbbb075fbaa.png)

订阅套餐列表展示所有可购买的套餐,包含套餐名称、价格、有效期、包含配额等信息。

订阅套餐提供按周期计费的配额包,可选择日、周、月等不同周期的套餐。

### 订阅详情

#### 浏览套餐信息

在订阅页浏览可用套餐,查看各套餐的价格、有效期和包含配额

![选择套餐并点击购买](https://ai-tokens.space/v1/assets/media/53dfe6ab8a6bdf563acb.png)

### 查看当前订阅状态

#### 订阅信息

购买订阅后,在订阅页顶部可查看当前套餐的详细信息:

![当前订阅状态](https://ai-tokens.space/v1/assets/media/16e731fc1e1d1944e9a9.png)

- 套餐名称和有效期截止日期
- 套餐内剩余配额

#### 自动续费设置

可在此设置到期后是否自动续费

---

## 任务管理

管理 Midjourney 绘图、Suno 音乐生成等异步任务

文档链接：https://ai-tokens.space/v1/zh/docs/guide/feature-guide/user/task/

管理 Midjourney 绘图、Suno 音乐生成等异步任务的状态与结果。左侧导航点击「任务」，或直接访问 `/console/task`。

![任务列表页](https://ai-tokens.space/v1/assets/media/422b3c82a398e90fd219.png)

任务列表展示所有已提交的异步生成任务，包含任务 ID、类型、状态、提交时间和完成时间。

任务状态说明：

| 状态 | 说明 |
| --- | --- |
| PENDING | 任务已提交，等待处理 |
| IN_PROGRESS | 任务正在生成中 |
| SUCCESS | 任务已完成，可查看结果 |
| FAILURE | 任务生成失败，已自动退还配额 |

---

# 三、后台管理指南（AI-Tkoens 管理端）

## 渠道管理

渠道是平台对接 AI 服务商的核心配置单元

文档链接：https://ai-tokens.space/v1/zh/docs/guide/feature-guide/admin/channel/

渠道是平台对接 AI 服务商的核心配置单元,每条渠道对应一个服务商的 API Key。使用管理员账号登录后,左侧导航点击「渠道」,或直接访问 `/console/channel`。

![渠道列表页](https://ai-tokens.space/v1/assets/media/4f1f50f360792f5853b3.png)

渠道列表展示所有已配置的 AI 服务商渠道,包含名称、类型、状态(绿色=正常 / 红色=禁用)、响应时间、已用配额等信息。

### 添加渠道

#### 基本配置

1. 在渠道列表页点击右上角「添加渠道」按钮,弹出配置弹窗
2. 在弹窗中选择服务商类型(如 OpenAI、Claude、Gemini 等)
3. 填写渠道名称和 API Key

![添加渠道弹窗(基础信息)](https://ai-tokens.space/v1/assets/media/a8f823137e16feb5c0f2.png)

#### 选择模型

在模型列表中勾选该渠道支持的模型,或点击「填入默认模型」自动填充

#### 高级配置

按需展开高级配置,填写以下可选项:

![添加渠道弹窗(高级配置)](https://ai-tokens.space/v1/assets/media/7a0f6d7ca03d62ac8dee.png)

| 配置项 | 说明 |
| --- | --- |
| Base URL | 自定义接口地址,代理或私有部署时使用 |
| 优先级 | 数值越高越优先被选中,默认为 0 |
| 权重 | 同优先级下的随机权重,默认为 0 |
| 模型映射 | 将用户请求的模型名映射为实际模型名,JSON 格式 |
| 参数覆盖 | 强制覆盖请求中的某些参数,JSON 格式 |
| 自动禁用 | 开启后连续失败达到阈值时自动禁用该渠道 |

#### 提交保存

点击「提交」完成渠道添加,新渠道出现在列表中

### 渠道测试

#### 单个渠道测试

1. 在渠道列表中找到目标渠道,点击右侧操作栏中的「测试」按钮
2. 等待测试请求完成,弹窗显示响应时间和成功/失败状态

![渠道测试结果弹窗](https://ai-tokens.space/v1/assets/media/2e82765f71c42608d5fe.png)

响应时间越短说明该渠道速度越快。

#### 批量测试

点击列表顶部「测试所有渠道」按钮一键批量测试。

### 批量操作

#### 选择渠道

1. 在渠道列表左侧勾选多条渠道的复选框
2. 页面顶部出现批量操作工具栏

![勾选多条渠道后的批量操作栏](https://ai-tokens.space/v1/assets/media/6a90501c05535ef80994.png)

#### 执行批量操作

点击对应按钮执行批量操作:

- **批量启用**:将选中渠道状态改为正常
- **批量禁用**:将选中渠道状态改为禁用
- **批量打标签**:为选中渠道统一设置标签,便于分类管理

### 多 Key 模式

多 Key 模式允许一个渠道配置多个 API Key,系统自动轮询使用,单个 Key 失败后自动跳过,恢复后重新启用。

#### 配置多 Key

1. 在渠道列表中点击目标渠道右侧的「编辑」按钮
2. 在编辑弹窗中找到「多 Key 管理」区域

![多 Key 模式配置区域](https://ai-tokens.space/v1/assets/media/03e2fa932bdd47a765fc.png)

1. 点击「添加 Key」逐条输入多个 API Key

#### 选择轮询模式

选择轮询模式:

| 轮询模式 | 说明 |
| --- | --- |
| 轮询(Round Robin) | 按顺序依次使用每个 Key |
| 加权随机 | 按权重随机选择 Key |

#### 保存配置

点击「保存」完成配置

### 参数覆盖系统

参数覆盖系统支持两种模式：简单覆盖模式（向前兼容）和高级操作模式。通过灵活的条件判断和操作类型，可以实现复杂的参数动态调整。

#### 简单覆盖模式

向前兼容性，直接指定要覆盖的字段和值，系统会将这些字段合并到原始请求中：

```
{
  "temperature": 0.8,
  "max_tokens": 2000,
  "model": "gpt-4"
}
```

#### 高级操作模式

通过 `operations` 数组定义复杂的参数操作，支持条件判断、数组操作、字符串拼接与字符串规范化等高级功能。

##### 基本结构

```
{
  "operations": [
    {
      "path": "temperature",
      "mode": "set",
      "value": 0.8,
      "conditions": [...],
      "logic": "AND"
    }
  ]
}
```

**字段说明（按需填写）：**

- `mode`: 必填
- `path`: 适用于 `set` / `delete` / `append` / `prepend` / `trim_prefix` / `trim_suffix` / `ensure_prefix` / `ensure_suffix` / `trim_space` / `to_lower` / `to_upper` / `replace` / `regex_replace`
- `value`: 常见于 `set` / `append` / `prepend` / `trim_prefix` / `trim_suffix` / `ensure_prefix` / `ensure_suffix`
- `from` / `to`: 适用于 `move` / `copy` / `replace` / `regex_replace`
- `keep_origin`: 用于 `set`（已有值则跳过）以及对象合并时的 `append` / `prepend`

#### 操作模式 (mode)

##### 1. set - 设置值

设置指定路径的值：

```
{
  "path": "temperature",
  "mode": "set",
  "value": 0.8,
  "keep_origin": false
}
```

**参数说明：**

- `keep_origin`: 为 `true` 时，如果目标路径已存在值则跳过设置

##### 2. delete - 删除字段

删除指定路径的字段：

```
{
  "path": "messages.0",
  "mode": "delete"
}
```

##### 3. move - 移动字段

将一个字段的值移动到另一个位置：

```
{
  "mode": "move",
  "from": "messages.0.content",
  "to": "system"
}
```

##### 4. append - 追加内容

在现有内容后追加新内容：

```
{
  "path": "messages.0.content",
  "mode": "append",
  "value": "\n\n请用中文回答。"
}
```

**支持的数据类型：**

- **字符串**: 在原字符串末尾追加
- **数组**: 在数组末尾添加元素（支持添加单个元素或数组）
- **对象**: 合并对象属性

##### 5. prepend - 前置内容

在现有内容前添加新内容：

```
{
  "path": "messages.0.content",
  "mode": "prepend",
  "value": "重要提示：请仔细阅读以下内容。\n\n"
}
```

**支持的数据类型：**

- **字符串**: 在原字符串开头前置
- **数组**: 在数组开头添加元素（支持添加单个元素或数组）
- **对象**: 合并对象属性

##### 6. copy - 复制字段

将 `from` 指定路径的值复制到 `to` 指定路径（不删除源字段）：

```
{
  "mode": "copy",
  "from": "model",
  "to": "original_model"
}
```

##### 7. trim_prefix - 去除前缀

对字符串字段去除指定前缀（若不匹配则不变）：

```
{
  "path": "model",
  "mode": "trim_prefix",
  "value": "openai/"
}
```

##### 8. trim_suffix - 去除后缀

对字符串字段去除指定后缀（若不匹配则不变）：

```
{
  "path": "model",
  "mode": "trim_suffix",
  "value": "-latest"
}
```

##### 9. ensure_prefix - 确保前缀

确保字符串字段以指定前缀开头（已存在则不变）：

```
{
  "path": "model",
  "mode": "ensure_prefix",
  "value": "openai/"
}
```

##### 10. ensure_suffix - 确保后缀

确保字符串字段以指定后缀结尾（已存在则不变）：

```
{
  "path": "model",
  "mode": "ensure_suffix",
  "value": "-latest"
}
```

##### 11. trim_space - 去除首尾空白

对字符串字段执行 `TrimSpace`（空格、换行、制表符等都会被移除）：

```
{
  "path": "model",
  "mode": "trim_space"
}
```

##### 12. to_lower - 转小写

将字符串字段转换为小写：

```
{
  "path": "model",
  "mode": "to_lower"
}
```

##### 13. to_upper - 转大写

将字符串字段转换为大写：

```
{
  "path": "model",
  "mode": "to_upper"
}
```

##### 14. replace - 字符串替换

对字符串字段执行子串替换：

```
{
  "path": "model",
  "mode": "replace",
  "from": "openai/",
  "to": ""
}
```

**参数要求：**

- `from`: 必填且不能为空字符串
- `to`: 可选，省略时等同于空字符串

##### 15. regex_replace - 正则替换

对字符串字段执行正则匹配替换：

```
{
  "path": "model",
  "mode": "regex_replace",
  "from": "^gpt-",
  "to": "openai/gpt-"
}
```

**参数要求：**

- `from`: 必填（正则表达式，Go regexp 语法）
- `to`: 可选，省略时等同于空字符串

#### 条件判断

通过 `conditions` 数组设置操作执行的条件，仅当条件满足时才会执行对应操作。

##### 条件结构

```
{
  "conditions": [
    {
      "path": "model",
      "mode": "contains",
      "value": "gpt-4",
      "invert": false,
      "pass_missing_key": false
    }
  ],
  "logic": "AND"
}
```

##### 条件匹配模式

- `full`: 完全匹配（默认）
- `prefix`: 前缀匹配
- `suffix`: 后缀匹配
- `contains`: 包含匹配
- `gt`: 大于（仅数字类型）
- `gte`: 大于等于（仅数字类型）
- `lt`: 小于（仅数字类型）
- `lte`: 小于等于（仅数字类型）

**须知：**

- 数值比较只能用于数字类型
- 字符串操作（prefix、suffix、contains）会将值转换为字符串进行比较

##### 条件参数说明

- `invert`: 反选功能，`true` 表示取反结果
- `pass_missing_key`: 当指定路径不存在时的行为 `true`: 路径不存在时条件通过 `false`: 路径不存在时条件不通过（默认）

##### 逻辑关系 (logic)

- `AND`: 所有条件都必须满足
- `OR`: 任意条件满足即可（默认）

#### 路径语法

使用 JSON 路径语法访问嵌套字段：

- `temperature` - 根级字段
- `messages.0.content` - 数组第一个元素的 content 字段
- `messages.-1.content` - 数组最后一个元素的 content 字段
- `metadata.user.name` - 嵌套对象字段

同时，`path` 支持以下内置变量（无需在请求体中显式存在），可直接用于条件判断：

| 变量 | 含义 | 典型用途 |
| --- | --- | --- |
| model / upstream_model | 重定向后的目标模型 | 按实际调用的上游模型做条件匹配 |
| original_model | 重定向前的目标模型 | 按用户请求的原始模型做条件匹配 |

#### 实用示例

##### 1. 动态调整模型参数

根据消息内容动态调整温度参数：

```
{
  "operations": [
    {
      "path": "temperature",
      "mode": "set",
      "value": 0.3,
      "conditions": [
        {
          "path": "messages.0.content",
          "mode": "contains",
          "value": "代码"
        }
      ]
    },
    {
      "path": "temperature",
      "mode": "set",
      "value": 0.9,
      "conditions": [
        {
          "path": "messages.0.content",
          "mode": "contains",
          "value": "创意"
        }
      ]
    }
  ]
}
```

##### 2. 添加系统提示

在消息数组开头添加系统消息：

```
{
  "operations": [
    {
      "path": "messages",
      "mode": "prepend",
      "value": [
        {
          "role": "system",
          "content": "你是一个专业的AI助手，请始终保持礼貌和专业。"
        }
      ]
    }
  ]
}
```

##### 3. 根据模型类型调整参数

根据不同模型设置不同的 max_tokens：

```
{
  "operations": [
    {
      "path": "max_tokens",
      "mode": "set",
      "value": 4000,
      "conditions": [
        {
          "path": "model",
          "mode": "prefix",
          "value": "gpt-4"
        }
      ]
    },
    {
      "path": "max_tokens",
      "mode": "set",
      "value": 2000,
      "conditions": [
        {
          "path": "model",
          "mode": "prefix",
          "value": "gpt-3.5"
        }
      ]
    }
  ]
}
```

##### 4. 多条件组合（AND逻辑）

同时满足多个条件时才执行操作：

```
{
  "operations": [
    {
      "path": "stream",
      "mode": "set",
      "value": false,
      "conditions": [
        {
          "path": "model",
          "mode": "contains",
          "value": "claude"
        },
        {
          "path": "messages.0.content",
          "mode": "contains",
          "value": "长文"
        }
      ],
      "logic": "AND"
    }
  ]
}
```

##### 5. 数值比较条件

根据数值大小进行条件判断：

```
{
  "operations": [
    {
      "path": "temperature",
      "mode": "set",
      "value": 0.1,
      "conditions": [
        {
          "path": "max_tokens",
          "mode": "gt",
          "value": 1000
        }
      ]
    }
  ]
}
```

##### 6. 反选条件

使用 `invert` 实现反选逻辑：

```
{
  "operations": [
    {
      "path": "stream",
      "mode": "set",
      "value": true,
      "conditions": [
        {
          "path": "model",
          "mode": "contains",
          "value": "gpt-3.5",
          "invert": true
        }
      ]
    }
  ]
}
```

##### 7. 处理缺失字段

使用 `pass_missing_key` 处理可能不存在的字段：

```
{
  "operations": [
    {
      "path": "temperature",
      "mode": "set",
      "value": 0.7,
      "conditions": [
        {
          "path": "custom_field",
          "mode": "full",
          "value": "special",
          "pass_missing_key": true
        }
      ]
    }
  ]
}
```

##### 8. 字符串拼接示例

在用户消息后追加指导语：

```
{
  "operations": [
    {
      "path": "messages.-1.content",
      "mode": "append",
      "value": "\n\n请详细解释你的思考过程。"
    }
  ]
}
```

#### 注意事项

**执行顺序**: 操作按照在 `operations` 数组中的顺序依次执行，前面的操作会影响后续操作

---

## 自定义 OAuth 提供商

添加任意符合 OIDC 标准的自定义登录方式

文档链接：https://ai-tokens.space/v1/zh/docs/guide/feature-guide/admin/custom-oauth/

除内置的 OAuth 提供商外,Root 可以添加任意符合 OIDC 标准的自定义登录方式。使用 Root 账号登录后,进入系统设置页(`/console/setting`),找到「自定义 OAuth」区域。

![自定义 OAuth 提供商列表](https://ai-tokens.space/v1/assets/media/337210a7e7589d2385cf.png)

### 添加自定义 OAuth 提供商

1. 点击「添加提供商」按钮,弹出配置弹窗

![添加自定义 OAuth 弹窗](https://ai-tokens.space/v1/assets/media/832e7a790bff90f0703e.png)

1. 在「Discovery URL」输入框中填写 OIDC 提供商的 Discovery 地址(通常以 `/.well-known/openid-configuration` 结尾),点击「自动发现」,系统自动填充 Authorization Endpoint、Token Endpoint 等配置

![自动发现填充后的配置项](https://ai-tokens.space/v1/assets/media/466209314ca966ff14a1.png)

1. 填写 Client ID 和 Client Secret(从 OAuth 提供商的应用管理页面获取)
2. 填写显示名称(用户在登录页看到的按钮文字)
3. 点击「保存」,配置完成后用户登录页出现该提供商的登录入口

---

## 文档与关于页配置

配置左侧导航的文档链接和关于页内容

文档链接：https://ai-tokens.space/v1/zh/docs/guide/feature-guide/admin/docs-config/

对于左侧导航栏的「文档」按钮和「关于」页面，Root 均可在系统设置中自定义配置。使用 Root 账号登录后，访问 `/console/setting`。

### 配置文档链接

1. 在系统设置页点击「运营设置」标签页
2. 找到「文档地址」输入框

![文档地址输入框](https://ai-tokens.space/v1/assets/media/6d61563f5e6bec57b1cc.png)

1. 在输入框中填写文档网站的完整 URL（如 `https://docs.example.com`）
2. 点击「保存」
3. 返回首页，左侧导航栏出现「文档」按钮，点击后跳转到填写的地址

![首页左侧导航出现「文档」按钮的效果](https://ai-tokens.space/v1/assets/media/9588cf99e587ff0d48ec.png)

文档地址留空时，左侧导航不会显示「文档」按钮。

### 配置关于页

1. 在系统设置页点击「其它设置」标签页
2. 找到「关于」内容编辑区域

![关于内容编辑区](https://ai-tokens.space/v1/assets/media/3eb583031bd73fdd3ecb.png)

1. 在文本框中填写 Markdown 格式的内容（支持标题、链接、图片、列表等）
2. 点击「保存」
3. 用户点击左侧导航「关于」后将看到配置的内容

![关于页展示效果](https://ai-tokens.space/v1/assets/media/2c83d96f7536f4a2d035.png)

---

## 分组管理

分组用于隔离不同用户的渠道访问权限和计费倍率

文档链接：https://ai-tokens.space/v1/zh/docs/guide/feature-guide/admin/group/

分组用于隔离不同用户的渠道访问权限和计费倍率，不同分组的用户只能使用分配给该分组的渠道。使用管理员账号登录后，在系统设置或管理面板中找到「分组」入口。

分组列表展示平台所有已配置的分组名称。用户和令牌均可指定所属分组，渠道也可限定只对特定分组开放。

### 分组的使用方式

- **用户分组**：在用户管理页编辑用户时，可为用户指定所属分组
- **令牌分组**：创建令牌时可指定该令牌使用的渠道分组
- **渠道分组**：添加渠道时可在「分组」字段填写允许访问该渠道的分组名称

令牌分组设为 `auto` 时，系统按优先级顺序自动选择一个可用分组，适合需要跨分组容灾的场景。

---

## 日志与统计

查看全平台 API 调用记录和消耗统计

文档链接：https://ai-tokens.space/v1/zh/docs/guide/feature-guide/admin/log/

查看全平台 API 调用记录和消耗统计，支持按用户、模型、渠道等多维度分析。使用管理员账号登录后，左侧导航点击「日志」，或直接访问 `/console/log`。

![全平台日志列表](https://ai-tokens.space/v1/assets/media/962f4d3c65c07057d739.png)

管理员视角的日志列表比普通用户多出「用户名」和「渠道名」两列，可查看所有用户的调用记录。

### 搜索与过滤

1. 在日志页顶部点击「筛选」按钮，展开过滤条件区域
2. 可设置以下过滤条件： **时间范围**：选择开始和结束日期 **用户名**：输入用户名关键词 **模型**：输入模型名称关键词 **渠道**：选择特定渠道 **令牌名**：输入令牌名称
3. 点击「查询」，列表刷新显示过滤结果

![日志筛选条件展开状态](https://ai-tokens.space/v1/assets/media/ff827463f99b9553d6ee.png)

### 日志统计面板

在日志页顶部查看统计汇总区域，展示全平台的调用量汇总数据。

![日志统计面板（总调用次数、总消耗配额等）](https://ai-tokens.space/v1/assets/media/b47f41b646530f27db25.png)

### 全平台消耗趋势

1. 左侧导航点击「数据看板」，或直接访问 `/console`（管理员视角）

![全平台消耗趋势图](https://ai-tokens.space/v1/assets/media/e8e745e28da710e138e1.png)

1. 管理员数据看板展示全平台的消耗趋势折线图，以及各用户的消耗占比分布
2. 将鼠标悬停在图表上可查看具体日期的详细数据

---

## 模型管理

管理平台所有模型的元数据和定价

文档链接：https://ai-tokens.space/v1/zh/docs/guide/feature-guide/admin/model/

管理平台所有模型的元数据和定价,支持从上游服务商同步最新模型列表。使用管理员账号登录后,左侧导航点击「模型」,或直接访问 `/console/models`。

![模型列表页](https://ai-tokens.space/v1/assets/media/67be216eefe979250ff7.png)

模型列表展示平台所有已配置的模型,包含模型名称、类型、输入/输出定价、所属厂商等信息。

### 添加 / 编辑模型

1. 点击「添加模型」按钮,或点击已有模型右侧的「编辑」按钮

![添加/编辑模型弹窗](https://ai-tokens.space/v1/assets/media/12fc58e90dc284c06ff6.png)

1. 填写模型名称、输入价格、输出价格等信息
2. 点击「保存」完成配置

### 同步上游模型

同步功能可从各服务商获取最新模型列表,预览变更后再决定是否应用。

1. 在模型管理页点击「同步上游」按钮
2. 系统请求上游服务商的模型列表,弹出预览弹窗

![同步上游模型预览弹窗](https://ai-tokens.space/v1/assets/media/81ebedf526987b165f1e.png)

1. 预览弹窗中分别列出「新增」「变更」「删除」的模型
2. 确认无误后点击「应用」,模型列表更新完成

![同步完成后的模型列表](https://ai-tokens.space/v1/assets/media/4235764facf87c62a0dd.png)

---

## 性能监控

查看服务器实时资源使用情况，并进行系统维护操作

文档链接：https://ai-tokens.space/v1/zh/docs/guide/feature-guide/admin/performance/

查看服务器实时资源使用情况，并进行系统维护操作。使用 Root 账号登录后，进入系统设置页（`/console/setting`），找到「性能监控」标签页。

![性能监控标签页](https://ai-tokens.space/v1/assets/media/900c9b96a65a2765b6c5.png)

性能监控页展示服务器当前的 CPU 使用率、内存占用、请求量等实时指标。

### 执行维护操作

在性能监控页找到对应操作按钮，点击后系统立即执行：

![维护操作按钮区域](https://ai-tokens.space/v1/assets/media/ca61b092974f59e77852.png)

| 操作 | 说明 | 使用场景 |
| --- | --- | --- |
| 清除磁盘缓存 | 释放磁盘缓存空间 | 磁盘占用过高时 |
| 重置统计数据 | 清零性能计数器 | 需要重新统计时 |
| 强制 GC | 手动触发 Go 垃圾回收，释放内存 | 内存占用异常偏高时 |
| 清理日志文件 | 删除旧日志文件，释放磁盘空间 | 日志文件积累过多时 |

点击操作按钮后，页面提示操作结果，指标数据随即刷新。

---

## 兑换码管理

批量生成和管理配额兑换码

文档链接：https://ai-tokens.space/v1/zh/docs/guide/feature-guide/admin/redemption/

批量生成和管理配额兑换码，用于活动赠送或用户充值。使用管理员账号登录后，左侧导航点击「兑换码」，或直接访问 `/console/redemption`。

![兑换码列表页](https://ai-tokens.space/v1/assets/media/641825c8a420e1d74b3a.png)

兑换码列表展示所有已生成的兑换码，包含码值（部分遮挡）、面值、使用状态（未使用 / 已使用）、创建时间。

### 批量生成兑换码

#### 打开生成弹窗

在兑换码列表页点击「生成兑换码」按钮，弹出生成弹窗

![生成兑换码弹窗](https://ai-tokens.space/v1/assets/media/59d92c4244eac94dba56.png)

#### 设置生成参数

填写以下参数：

- **名称**：便于识别的批次名称
- **面值**：每张兑换码对应的配额数量
- **数量**：本次生成的兑换码张数

#### 生成兑换码

点击「生成」，系统批量创建兑换码并显示在列表中

![生成完成后的兑换码列表](https://ai-tokens.space/v1/assets/media/0973de2b5c2e44098f6f.png)

#### 导出兑换码

可点击列表中的「导出」按钮，将兑换码导出为文件，方便批量分发

---

## 订阅计划管理

创建和管理订阅套餐

文档链接：https://ai-tokens.space/v1/zh/docs/guide/feature-guide/admin/subscription/

创建和管理订阅套餐，控制哪些套餐对用户可见，以及为用户手动开通订阅。使用管理员账号登录后，直接访问 `/console/subscription`（管理员视角与用户购买界面不同）。

![订阅计划管理列表](https://ai-tokens.space/v1/assets/media/94c26c40f97fd7b9cbd5.png)

套餐列表展示所有已创建的订阅套餐，包含名称、价格、有效期、状态（上架 / 下架）等信息。

### 创建套餐

1. 在订阅管理页点击「创建套餐」按钮，弹出创建弹窗

![创建订阅套餐弹窗](https://ai-tokens.space/v1/assets/media/65d896d36b767b80f0d3.png)

1. 填写以下信息： **套餐名称**：用户购买时看到的名称 **价格**：套餐售价 **有效期类型**：选择日 / 周 / 月 / 自定义天数 **包含配额**：套餐内包含的配额数量
2. 点击「提交」，套餐创建完成并默认处于下架状态

### 上架 / 下架套餐

1. 在套餐列表中找到目标套餐，点击右侧「上架」或「下架」按钮

![套餐上架/下架操作](https://ai-tokens.space/v1/assets/media/d3948c8acecbafb718d5.png)

1. 上架后用户在订阅页可看到并购买该套餐；下架后套餐对用户不可见，但已购买的订阅不受影响

### 为用户手动开通订阅

1. 在订阅管理页点击「手动绑定」按钮
2. 输入目标用户名或邮箱，选择要开通的套餐
3. 点击「确认」，系统为该用户创建订阅记录，立即生效

---

## 系统设置

Root 专属的全局配置中心

文档链接：https://ai-tokens.space/v1/zh/docs/guide/feature-guide/admin/system-setting/

Root 专属的全局配置中心，涵盖站点基础信息、计费规则、支付配置等所有系统级参数。使用 Root 账号登录后，左侧导航点击「设置」，或直接访问 `/console/setting`。

![系统设置页标签页导航总览](https://ai-tokens.space/v1/assets/media/3ba4a495d66b22185d73.png)

系统设置页顶部有多个标签页，点击对应标签切换到不同配置区域。

### 通用设置

1. 点击「通用设置」标签页

![通用设置标签页](https://ai-tokens.space/v1/assets/media/27c2d24fb31429fadd41.png)

1. 可配置以下内容： **站点名称**：显示在浏览器标签和页面顶部的名称 **首页公告**：在首页展示的公告文字，支持 Markdown 格式 **文档地址**：填写后首页左侧导航出现「文档」按钮，点击跳转到该地址 **充值链接**：自定义充值页面的跳转地址
2. 修改完成后点击「保存」

文档地址留空时，左侧导航不会显示「文档」按钮。

### 计费与倍率设置

1. 点击「计费设置」或「倍率设置」标签页

![计费与倍率设置标签页](https://ai-tokens.space/v1/assets/media/c09c74664977da337689.png)

1. 在模型倍率列表中找到目标模型，修改输入/输出倍率数值
2. 在分组倍率区域可为不同分组设置差异化的计费倍率
3. 修改完成后点击「保存」

### 注册与安全设置

1. 点击「安全设置」或「注册设置」标签页

![注册与安全设置标签页](https://ai-tokens.space/v1/assets/media/66db4337c3c927a35966.png)

1. 可配置以下内容： **开放注册**：开关控制是否允许新用户自行注册 **邮箱白名单**：限制只有特定邮箱域名可以注册 **Turnstile 验证**：填写 Cloudflare Turnstile 的 Site Key 和 Secret Key，启用人机验证
2. 修改完成后点击「保存」

### OAuth 配置

1. 点击「OAuth 设置」标签页

![OAuth 设置标签页](https://ai-tokens.space/v1/assets/media/46671579984abdc5a578.png)

1. 为需要启用的第三方登录平台填写对应的 Client ID 和 Client Secret
2. 修改完成后点击「保存」，用户登录页即可看到对应的第三方登录按钮

#### OIDC 配置重要提示

当启用 OIDC 配置后，请一定要勾选"允许新用户注册"，否则会导致 OIDC 登录的新用户无法正常创建用户，并同时勾选"允许通过 OIDC 进行登录"。其他配置根据需要勾选。

### 邮件服务器配置

配置邮件服务器用于发送验证码、通知等邮件。

![系统设置 - 邮件服务器](https://ai-tokens.space/v1/assets/media/2bc1af2533a035958880.png)

1. 在系统设置页找到「邮件服务器」配置区域
2. 填写以下信息： **SMTP 服务器地址**：邮件服务器地址（如 smtp.gmail.com） **SMTP 端口**：通常为 465（SSL）或 587（TLS） **发件人邮箱**：用于发送邮件的邮箱地址 **发件人名称**：邮件中显示的发件人名称 **SMTP 用户名**：通常与发件人邮箱相同 **SMTP 密码**：邮箱的授权密码或应用专用密码
3. 点击「测试邮件」验证配置是否正确
4. 点击「保存」

Gmail 等邮箱需要使用应用专用密码，而不是账号密码。请在邮箱设置中生成应用专用密码。

### Worker 配置

配置 AI-Tkoens Worker 相关参数。

![系统设置 - Worker 配置](https://ai-tokens.space/v1/assets/media/398ee45d51b9befb1253.png)

Worker 用于处理异步任务，如：

- 邮件发送
- 数据统计
- 定时任务

配置项：

- **Worker 数量**：并发处理任务的 Worker 数量
- **任务队列大小**：待处理任务的队列容量

Worker 数量建议根据服务器性能设置，通常设置为 CPU 核心数的 2-4 倍

---

## 系统设置详细配置

Root 专属的系统高级配置选项

文档链接：https://ai-tokens.space/v1/zh/docs/guide/feature-guide/admin/system-setting-advanced/

本页面详细说明系统设置中的各个配置标签页，涵盖支付、限流、聊天、绘图等高级功能配置。

### 支付设置

配置平台支持的支付方式和支付参数。

![支付设置页面](https://ai-tokens.space/v1/assets/media/1fb756ef0e616894308d.png)

#### 什么是易支付

`易支付`是对"第三方聚合收款网关/接口"模式的泛称，并非某一家具体的网站或公司。既可指商用聚合支付服务，也可指自建/开源、遵循"易支付协议风格"的网关实现。

**核心作用：** 聚合微信支付、支付宝、银行卡等渠道，向商户提供统一的下单、签名校验与回调接口。

**合规提示：** 网关本身不等同于持牌支付机构；资金清结算与合规依赖其对接的持牌渠道，请遵循所在地监管与风控要求。

#### EPay 配置

EPay 是国内聚合支付平台，支持支付宝、微信支付等。

1. 在系统设置页点击「支付设置」标签页
2. 找到「EPay」配置区域
3. 填写以下信息： **API 地址**：EPay 提供的接口地址 **商户 ID（PID）**：从 EPay 后台获取 **商户密钥（KEY）**：从 EPay 后台获取
4. 勾选「启用 EPay」
5. 点击「保存」

平台回调参数包含签名，系统会进行校验并自动入账。

#### Stripe 配置

Stripe 是国际信用卡支付平台。

![Stripe 配置](https://ai-tokens.space/v1/assets/media/2a6c1968dfa14574f80f.png)

1. 在支付设置页找到「Stripe」配置区域
2. 填写以下信息： **API 密钥（Secret Key）**：从 Stripe 控制台获取 **Publishable Key**：从 Stripe 控制台获取 **Webhook 签名密钥**：配置 Webhook 后获取 **商品价格 ID**：Stripe 产品的价格 ID
3. 勾选「启用 Stripe」
4. 点击「保存」

Stripe 需要配置 Webhook 接收支付状态通知，Webhook URL 为：`https://your-domain.com/api/payment/stripe/webhook`

#### 其他支付方式

平台还支持以下支付方式，配置方法类似：

- **Creem**：国际支付平台
- **Waffo**：国际支付平台

#### 充值方式设置

在"充值方式"中，可按以下结构配置：

```
[
  {
    "color": "rgba(var(--semi-blue-5), 1)",
    "name": "支付宝",
    "type": "alipay"
  },
  {
    "color": "rgba(var(--semi-green-5), 1)",
    "name": "微信",
    "type": "wxpay"
  },
  {
    "color": "rgba(var(--semi-green-5), 1)",
    "name": "Stripe",
    "type": "stripe",
    "min_topup": "50"
  },
  {
    "name": "自定义1",
    "color": "black",
    "type": "custom1",
    "min_topup": "50"
  }
]
```

##### 字段说明

- **name**：展示文案。显示在"选择支付方式"的按钮上（如"支付宝/微信/Stripe/自定义1"）
- **color**：按钮/徽标的主题色或边框色。支持任意 CSS 颜色值，推荐使用现有设计令牌（如 `rgba(var(--semi-blue-5), 1)`）
- **type**：通道标识，用于后端路由与下单 `stripe` → 走 Stripe 网关 其他（如 `alipay`、`wxpay`、`custom1` 等）→ 走易支付风格网关，并将该值作为渠道参数透传 详细逻辑见后端控制器 [controller/topup.go](https://github.com/QuantumNous/ai-tkoens/blob/main/controller/topup.go)
- **min_topup**：最低充值金额（单位与页面货币一致）。当输入金额小于该值时，页面会提示"此支付方式最低充值金额为 X"，并限制发起支付；后端也会进行校验
- **排序**：按数组顺序从左到右渲染

#### 充值金额配置

##### 自定义充值数量选项

设置用户可选择的充值数量选项，例如：

```
[10, 20, 50, 100, 200, 500]
```

这些数值会显示在"选择充值额度"区域，用户可以直接点击选择对应的充值金额。

##### 充值金额折扣配置

设置不同充值金额对应的折扣，键为充值金额，值为折扣率，例如：

```
{
  "100": 0.95,
  "200": 0.9,
  "500": 0.85
}
```

**配置说明：**

- **键**：充值金额（字符串格式）
- **值**：折扣率（0-1之间的小数，如 0.95 表示 95% 价格，即 5% 折扣）
- 系统会根据配置自动计算实付金额和节省金额
- 详细实现逻辑见后端控制器 [controller/topup.go](https://github.com/QuantumNous/ai-tkoens/blob/main/controller/topup.go)

充值折扣可以激励用户一次性充值更多金额，提高用户粘性

### 限流设置

配置 API 调用的频率限制，防止滥用和保护系统稳定性。

![限流设置页面](https://ai-tokens.space/v1/assets/media/faeb25bf985e8450a16c.png)

#### 全局限流

1. 在系统设置页点击「限流设置」标签页
2. 配置全局限流参数： **每分钟请求数**：单个 IP 每分钟最多请求次数 **每小时请求数**：单个 IP 每小时最多请求次数 **每天请求数**：单个 IP 每天最多请求次数
3. 点击「保存」

#### 按用户分组限流

可以为不同用户分组设置不同的限流策略：

1. 在分组管理页编辑分组
2. 设置该分组的限流参数
3. 分组内所有用户共享该限流配置

##### 分组速率限制配置示例

```
{
  "default": [200, 100],
  "vip": [0, 1000]
}
```

**配置说明：**

- **键**：分组名称
- **值**：数组，包含两个数字 第一个数字：每分钟请求数限制 第二个数字：每小时请求数限制 设置为 0 表示不限制

**示例解释：**

- `default` 分组：每分钟最多 200 次请求，每小时最多 100 次请求
- `vip` 分组：每分钟不限制，每小时最多 1000 次请求

限流设置过低可能影响正常使用，建议根据实际业务需求合理配置

### 倍率设置

倍率设置是 AI-Tkoens 计费系统的核心配置，通过设置不同的倍率可以灵活控制各种模型和用户组的计费标准。

#### 倍率系统概述

AI-Tkoens 使用三层倍率体系来计算用户的配额消耗：

1. **模型倍率（ModelRatio）** - 定义不同AI模型的基础计费倍数
2. **补全倍率（CompletionRatio）** - 对输出token进行额外计费调整
3. **分组倍率（GroupRatio）** - 为不同用户组设置差异化计费倍数

#### 配额与倍率的关系

在 AI-Tkoens 系统中，倍率是计算配额消耗的关键参数。配额是系统内部的计费单位，所有的API调用最终都会转换为配额点数进行扣减。

**配额单位转换：**

- 1 美元 = 500,000 配额点数
- 配额点数是系统内部计费的基础单位
- 用户的余额、消费记录都以配额点数为准

#### 配额计算公式

##### 按量计费模型（基于Token消耗）

```
配额消耗 = (输入token数 + 输出token数 × 补全倍率) × 模型倍率 × 分组倍率
```

##### 按次计费模型（固定价格）

```
配额消耗 = 模型固定价格 × 分组倍率 × 配额单位(500,000)
```

##### 音频模型（特殊处理，ai-tkoens内部自动处理）

```
配额消耗 = (文本输入token + 文本输出token × 补全倍率 + 音频输入token × 音频倍率 + 音频输出token × 音频倍率 × 音频补全倍率) × 模型倍率 × 分组倍率
```

##### 预消费与后消费机制

AI-Tkoens 采用预消费和后消费的双重计费机制：

1. **预消费阶段**：API调用前，根据预估token数计算配额消耗并预扣
2. **后消费阶段**：API调用完成后，根据实际token数重新计算配额消耗
3. **差额调整**：如果实际消耗与预消费不同，系统会自动调整用户配额余额

```
预消费配额 = 预估token数 × 模型倍率 × 分组倍率
实际配额 = 实际token数 × 模型倍率 × 分组倍率
配额调整 = 实际配额 - 预消费配额
```

#### 模型倍率设置

模型倍率定义了不同AI模型的基础计费倍数，系统为各种模型预设了默认倍率。

##### 常见模型倍率示例

| 模型名称 | 模型倍率 | 补全倍率 | 官网价格（输入） | 官网价格（输出） |
| --- | --- | --- | --- | --- |
| gpt-4o | 1.25 | 4 | $2.5/1M Tokens | $10/1M Tokens |
| gpt-3.5-turbo | 0.25 | 1.33 | $0.5/1M Tokens | $1.5/1M Tokens |
| gpt-4o-mini | 0.075 | 4 | $0.15/1M Tokens | $0.6/1M Tokens |
| o1 | 7.5 | 4 | $15/1M Tokens | $60/1M Tokens |

**倍率含义说明：**

- 模型倍率：相对于基础计费单位的倍数，反映模型的成本差异
- 补全倍率：输出token相对于输入token的计费倍数，反映输出成本差异
- 倍率越高，消耗的配额越多；倍率越低，消耗的配额越少

##### 设置方法

![模型倍率设置 - 页面1](https://ai-tokens.space/v1/assets/media/2d5fb8a147901f9ed278.png)

1. 在系统设置页点击「倍率设置」标签页
2. 在模型倍率列表中找到目标模型

![模型倍率设置 - 页面2](https://ai-tokens.space/v1/assets/media/0d7df0f2840d5d7ad933.png)

1. 修改以下参数： **输入倍率**：输入 Token 的计费倍率 **输出倍率**：输出 Token 的计费倍率 **补全倍率**：补全接口的计费倍率

![模型倍率设置 - 页面3](https://ai-tokens.space/v1/assets/media/0e9202a656025148e13d.png)

1. 点击「保存」

**设置方式：**

1. JSON格式设置：直接编辑模型倍率JSON配置
2. 可视化编辑器：通过图形界面设置倍率

#### 补全倍率设置

补全倍率用于对输出token进行额外计费，主要用于平衡不同模型的输入输出成本差异。

##### 默认补全倍率

| 模型类型 | 官网价格（输入） | 官网价格（输出） | 补全倍率 | 说明 |
| --- | --- | --- | --- | --- |
| gpt-4o | 2.5$/1M Tokens | 10$/1M Tokens | 4 | 输出是输入的4倍 |
| gpt-3.5-turbo | 0.5$/1M Tokens | 1$/1M Tokens | 2 | 输出是输入的2倍 |
| gpt-image-1 | 5$/1M Tokens | 40$/1M Tokens | 8 | 输出是输入的8倍 |
| gpt-4o-mini | 0.15$/1M Tokens | 0.6$/1M Tokens | 4 | 输出是输入的4倍 |
| 其他模型 | 1 | 1 | 1 | 输出是输入的1倍 |

**设置说明：**

- 补全倍率主要影响输出token的计费
- 设置为1表示输出token计费与输入token计费相同
- 大于1表示输出token计费更高，小于1表示输出token计费更低

#### 分组倍率设置

分组倍率允许为不同用户组设置差异化的计费倍数，实现灵活的定价策略。

##### 分组倍率配置

```
{
  "vip": 0.5,
  "premium": 0.8,
  "standard": 1.0,
  "trial": 2.0
}
```

##### 分组倍率优先级

1. 用户专属倍率：为特定用户设置的个人倍率
2. 分组倍率：用户所属分组的倍率
3. 默认倍率：系统默认倍率（通常为1.0）

![分组倍率设置 - 页面4](https://ai-tokens.space/v1/assets/media/69a31d74dbedaca0dd3b.png)

为不同用户分组设置差异化的计费倍率：

1. 在倍率设置页找到「分组倍率」区域
2. 选择目标分组
3. 设置该分组的全局倍率系数（如 0.8 表示 8 折）

![分组倍率设置 - 页面5](https://ai-tokens.space/v1/assets/media/5beee77bfc1fe5302792.png)

1. 点击「保存」

分组倍率与模型倍率叠加计算：

```
最终消耗 = Token 数量 × 模型倍率 × 分组倍率
```

#### 可视化倍率设置

可视化编辑器提供了直观的倍率管理界面，支持：

- 批量编辑模型倍率
- 实时预览倍率配置
- 冲突检测和提示
- 一键同步上游倍率

#### 未设置倍率模型

对于未设置倍率的模型，系统会：

1. 自用模式：使用默认倍率37.5
2. 商业模式：提示"倍率或价格未配置"错误
3. 自动检测：在管理界面显示未配置的模型

#### 上游倍率同步

系统支持从上游渠道自动同步倍率设置：

- 自动获取上游模型倍率
- 批量更新本地倍率配置
- 保持与上游价格同步
- 支持手动调整和覆盖

#### 常见问题

##### Q: 如何为新模型设置倍率？

A: 可以通过可视化编辑器添加新模型，或直接在JSON配置中添加。建议先设置保守倍率，根据实际使用情况调整。

##### Q: 分组倍率如何生效？

A: 分组倍率会与模型倍率相乘，最终影响用户的配额消耗计算。用户的实际倍率 = 模型倍率 × 分组倍率。

##### Q: 补全倍率的作用是什么？

A: 补全倍率主要用于平衡输入输出token的成本差异。某些模型的输出成本远高于输入成本，需要通过补全倍率进行调整。

##### Q: 如何批量设置相似模型的倍率？

A: 可以通过可视化编辑器进行批量操作，或者直接在JSON配置中批量添加相似模型的倍率设置。

#### 配额计算实例

##### 示例1：GPT-4 标准用户对话

场景参数：

- 输入token：1,000
- 输出token：500
- 模型倍率：15
- 补全倍率：2
- 分组倍率：1.0（标准用户）

计算过程：

```
配额消耗 = (1,000 + 500 × 2) × 15 × 1.0
         = (1,000 + 1,000) × 15
         = 2,000 × 15
         = 30,000 配额点数
```

等价美元成本：30,000 ÷ 500,000 = $0.06

##### 示例2：GPT-3.5 VIP用户对话

场景参数：

- 输入token：2,000
- 输出token：1,000
- 模型倍率：0.25
- 补全倍率：1.33
- 分组倍率：0.5（VIP用户50%折扣）

计算过程：

```
配额消耗 = (2,000 + 1,000 × 1.33) × 0.25 × 0.5
         = (2,000 + 1,330) × 0.125
         = 3,330 × 0.125
         = 416.25 配额点数
```

等价美元成本：416.25 ÷ 500,000 = $0.00083

##### 示例3：按次计费模型（如Midjourney）

场景参数：

- 模型固定价格：$0.02
- 分组倍率：1.0（标准用户）
- 配额单位：500,000

计算过程：

```
配额消耗 = 0.02 × 1.0 × 500,000
         = 10,000 配额点数
```

等价美元成本：10,000 ÷ 500,000 = $0.02

有关更多计费规则，请查看常见问题

### 聊天设置

配置内置聊天功能的相关参数。

![聊天设置页面](https://ai-tokens.space/v1/assets/media/43f88340d435d97fcc31.png)

#### 聊天应用配置

1. 在系统设置页点击「聊天设置」标签页
2. 配置以下选项： **启用聊天功能**：开关控制是否启用内置聊天 **默认模型**：聊天页面默认选中的模型 **最大历史消息数**：保留的历史对话轮数 **流式输出**：是否默认启用流式输出
3. 点击「保存」

#### 聊天集成变量

在配置聊天应用集成时，可以使用以下变量：

- **`{key}`**：替换为密钥（API Key）
- **`{address}`**：替换为服务器地址（末尾不带 `/` 和 `/v1`）

**使用示例：**

配置模板：

```
https://{address}/v1
```

实际替换后：

```
https://api.example.com/v1
```

这些变量在一键导入配置到聊天应用时会自动替换为实际值

#### 聊天应用集成

配置第三方聊天应用的集成参数：

- **ChatGPT Next Web**：配置部署地址
- **Lobe Chat**：配置推荐设置
- **其他应用**：配置集成参数

### 绘图设置

配置 Midjourney 等绘图功能的相关参数。

![绘图设置页面](https://ai-tokens.space/v1/assets/media/9bfbbc9a382761765e4f.png)

#### Midjourney 配置

1. 在系统设置页点击「绘图设置」标签页
2. 配置 Midjourney 参数： **启用 Midjourney**：开关控制是否启用绘图功能 **Midjourney Proxy 地址**：Midjourney-Proxy 服务地址 **API 密钥**：Midjourney-Proxy 的密钥 **超时时间**：绘图任务超时时间（秒）
3. 点击「保存」

#### 绘图计费

配置绘图任务的计费规则：

- **按次计费**：每次绘图消耗固定配额
- **按时长计费**：根据绘图耗时计费
- **按分辨率计费**：根据图片分辨率计费

Midjourney 功能需要额外部署 Midjourney-Proxy 服务，详见部署文档

### 数据看板设置

配置数据看板的显示内容和统计维度。

#### 看板配置 - 基础设置

![数据看板设置 - 页面1](https://ai-tokens.space/v1/assets/media/da91f7fabe4fd14503fe.png)

1. 在系统设置页点击「数据看板设置」标签页
2. 配置显示选项： **显示用户统计**：是否显示用户数量统计 **显示渠道统计**：是否显示渠道使用统计 **显示模型统计**：是否显示模型调用统计

#### 看板配置 - 图表设置

![数据看板设置 - 页面2](https://ai-tokens.space/v1/assets/media/707a0d607f3488f0b4f9.png)

1. 配置图表参数： **默认时间范围**：看板默认显示的时间范围 **刷新间隔**：自动刷新的时间间隔 **图表类型**：折线图、柱状图或饼图

#### 看板配置 - 高级选项

![数据看板设置 - 页面3](https://ai-tokens.space/v1/assets/media/be9004b849f34a77e7e2.png)

1. 配置高级选项： **数据缓存时间**：统计数据的缓存时长 **显示实时数据**：是否显示实时统计
2. 点击「保存」

### 模型设置

配置模型的显示和行为参数。

#### 模型显示设置

![模型设置 - 页面1](https://ai-tokens.space/v1/assets/media/732213ee3dfadb57e5b6.png)

1. 在系统设置页点击「模型设置」标签页
2. 配置模型显示选项： **显示模型描述**：是否在模型列表中显示描述 **显示模型图标**：是否显示模型厂商图标 **模型分组显示**：按厂商或类型分组显示

#### 模型行为设置

![模型设置 - 页面2](https://ai-tokens.space/v1/assets/media/c9932262eb56415f75b0.png)

1. 配置模型行为： **自动禁用失败模型**：连续失败后自动禁用 **失败阈值**：触发自动禁用的失败次数 **自动恢复时间**：禁用后自动恢复的时间（分钟）

#### 模型同步设置

![模型设置 - 页面3](https://ai-tokens.space/v1/assets/media/22a129e214a50e1eebb6.png)

1. 配置模型同步： **自动同步上游模型**：定期从服务商同步最新模型列表 **同步间隔**：自动同步的时间间隔（小时） **同步时保留自定义配置**：同步时不覆盖手动修改的配置
2. 点击「保存」

### 运营设置

配置平台运营相关的参数。

#### 基础运营配置

![运营设置 - 页面1](https://ai-tokens.space/v1/assets/media/c83e31a8d64902f5c492.png)

1. 在系统设置页点击「运营设置」标签页
2. 配置运营参数： **新用户初始配额**：新注册用户的初始配额 **邀请奖励配额**：邀请新用户注册后，邀请人可获得的奖励配额 **返利比例**：被邀请用户在充值时，邀请人可获得的返利配额比例（%）

#### 充值配置

![运营设置 - 页面2](https://ai-tokens.space/v1/assets/media/671cb362cf4b4ef9c939.png)

1. 配置充值选项： **最低充值金额**：单次充值的最低金额 **充值赠送比例**：充值赠送的额外配额比例 **充值档位**：预设的充值金额选项

#### 兑换码配置

![运营设置 - 页面3](https://ai-tokens.space/v1/assets/media/ec3b37a75579601084d5.png)

1. 配置兑换码： **兑换码有效期**：兑换码的默认有效期（天） **单用户兑换次数限制**：每个用户可兑换的次数
2. 点击「保存」

### 其他设置

配置其他杂项参数。

#### 首页配置

![其他设置 - 页面1](https://ai-tokens.space/v1/assets/media/6c263d7f0ac78681e024.png)

1. 在系统设置页点击「其他设置」标签页
2. 配置首页内容： **首页公告**：在首页显示的公告内容（支持 Markdown） **首页背景图**：首页背景图片 URL **显示统计数据**：是否在首页显示平台统计数据

#### 其他功能配置

![其他设置 - 页面2](https://ai-tokens.space/v1/assets/media/a64e873938aadb01d973.png)

1. 配置其他功能： **启用日志导出**：允许用户导出自己的使用日志 **日志保留天数**：系统自动清理多少天前的日志 **启用 API 文档**：是否显示 API 文档入口
2. 点击「保存」

以上所有设置仅 Root 用户可见和修改，普通管理员无权访问

---

## 用户管理

查看和管理平台所有注册用户

文档链接：https://ai-tokens.space/v1/zh/docs/guide/feature-guide/admin/user/

查看和管理平台所有注册用户，包括修改角色、配额、分组，以及账号状态控制。使用管理员账号登录后，左侧导航点击「用户」，或直接访问 `/console/user`。

![用户列表页](https://ai-tokens.space/v1/assets/media/463d41cdeea9155bc2da.png)

用户列表展示平台所有注册用户，包含用户名、邮箱、角色、分组、配额余额、状态等信息。

### 编辑用户

#### 打开编辑弹窗

在用户列表中找到目标用户，点击右侧「编辑」按钮，弹出编辑弹窗

![编辑用户弹窗](https://ai-tokens.space/v1/assets/media/9bfc12957c3191565bfa.png)

#### 修改用户信息

可修改以下信息：

- **角色**：普通用户 / 管理员，修改后立即生效
- **分组**：指定用户所属的渠道分组
- **配额余额**：直接设置用户的配额数值
- **状态**：启用或禁用账号，禁用后该用户无法登录

#### 保存修改

修改完成后点击「保存」

### 搜索用户

#### 使用搜索功能

1. 在用户列表顶部找到搜索框
2. 输入用户名或邮箱关键词

![搜索框输入关键词后的过滤结果](https://ai-tokens.space/v1/assets/media/53693610f0b9d27e6f14.png)

#### 查看搜索结果

列表实时过滤，显示匹配的用户记录

---

# 四、补充说明与概念

## 功能指南概述

AI-Tkoens 功能指南，按角色分为用户指南与管理员指南两部分

文档链接：https://ai-tokens.space/v1/zh/docs/guide/feature-guide/

AI-Tkoens 是一个统一的 LLM 网关平台，将多个 AI 服务商的接口聚合为标准的 OpenAI 兼容 API，让你通过一个地址访问数十种模型。本指南按角色分为用户指南与管理员指南两部分。

![系统首页](https://ai-tokens.space/v1/assets/media/a5cfb62e49b82474290d.png)

### 角色说明

根据账号权限，平台分为三种角色，各自拥有不同的功能范围。

#### 普通用户

注册后的默认角色，可以创建令牌、调用 API、查看个人用量、充值与订阅。

#### 管理员（Admin）

由 Root 提升的管理角色，在用户权限基础上，可以管理渠道、用户、兑换码、日志、模型与分组。

#### 超级管理员（Root）

最高权限角色，在管理员基础上，额外拥有系统全局设置、自定义 OAuth、性能监控等能力。

### 用户指南

适用于所有已登录用户，涵盖从注册到日常使用的完整流程。

#### 注册与登录

支持账号密码及 GitHub、Discord 等多种第三方 OAuth 登录方式。

- 账号密码登录
- 第三方 OAuth 登录
- 忘记密码重置
- 新用户注册流程

[查看详细文档 →](https://ai-tokens.space/v1/zh/docs/guide/feature-guide/user/auth/)

#### 个人设置

管理账号信息、开启 2FA 双因素认证、绑定 Passkey 无密码登录。

- 修改用户名和密码
- 绑定邮箱地址
- 开启双因素认证（2FA）
- 注册 Passkey 无密码登录
- 绑定第三方账号

[查看详细文档 →](https://ai-tokens.space/v1/zh/docs/guide/feature-guide/user/personal-setting/)

#### 令牌管理

创建和管理 API 调用凭证，支持配额限制、模型限制、IP 白名单。

- 创建新令牌
- 配置令牌权限
- 设置配额限制
- 配置模型限制
- 设置 IP 白名单

[查看详细文档 →](https://ai-tokens.space/v1/zh/docs/guide/feature-guide/user/token/)

#### 使用 API

兼容 OpenAI、Claude、Gemini 等格式，内置操练场在线测试工具。

- 操练场在线测试
- 获取 API 地址
- 代码示例（Python、cURL）
- 支持的接口端点

[查看详细文档 →](https://ai-tokens.space/v1/zh/docs/guide/feature-guide/user/api/)

#### 聊天应用集成

快速将配置导入到各类 AI 聊天应用，支持 Lobe Chat、OpenCat 等。

- 一键导入配置
- Lobe Chat 配置
- AI as Workspace 集成
- AMA 问天集成
- OpenCat 集成

[查看详细文档 →](https://ai-tokens.space/v1/zh/docs/guide/feature-guide/user/chat-apps/)

#### 使用记录

查看每次 API 调用的模型、Token 消耗、配额扣减等详细记录。

- 查看调用日志
- 搜索与过滤记录
- 数据统计图表
- 配额消耗分析

[查看详细文档 →](https://ai-tokens.space/v1/zh/docs/guide/feature-guide/user/log/)

#### 配额与充值

支持兑换码、EPay、Stripe 等多种方式充值，以及邀请返利机制。

- 在线支付充值
- 兑换码充值
- 邀请返利机制
- 查看充值记录

[查看详细文档 →](https://ai-tokens.space/v1/zh/docs/guide/feature-guide/user/topup/)

#### 订阅计划

按周期购买的套餐，适合有稳定用量需求的用户。

- 查看订阅套餐
- 购买订阅
- 管理自动续费

[查看详细文档 →](https://ai-tokens.space/v1/zh/docs/guide/feature-guide/user/subscription/)

#### 定价

查看全站模型定价及计费说明。

- 查看模型价格
- 搜索特定模型
- 了解计费规则

[查看详细文档 →](https://ai-tokens.space/v1/zh/docs/guide/feature-guide/user/pricing/)

#### 任务

查看和管理异步生成任务的状态和结果。

- 查看任务列表
- 查看任务详情
- 管理任务进度

[查看详细文档 →](https://ai-tokens.space/v1/zh/docs/guide/feature-guide/user/task/)

### 管理员指南

适用于 Admin 及 Root 角色，涵盖平台运营与系统配置的全部功能。

#### 渠道管理

配置 AI 服务商渠道，支持多 Key 轮询、优先级、自动禁用等策略。

- 添加新渠道
- 配置渠道参数
- 渠道测试
- 批量操作
- 多 Key 模式配置

[查看详细文档 →](https://ai-tokens.space/v1/zh/docs/guide/feature-guide/admin/channel/)

#### 用户管理

查看和管理所有用户，修改角色、分组、配额，启用或禁用账号。

- 查看用户列表
- 编辑用户信息
- 修改用户角色
- 调整用户配额
- 搜索用户

[查看详细文档 →](https://ai-tokens.space/v1/zh/docs/guide/feature-guide/admin/user/)

#### 兑换码管理

批量生成和管理配额兑换码。

- 批量生成兑换码
- 设置兑换码面值
- 导出兑换码
- 查看使用状态

[查看详细文档 →](https://ai-tokens.space/v1/zh/docs/guide/feature-guide/admin/redemption/)

#### 日志管理

查看全站 API 调用日志和用户操作记录。

- 查看全站日志
- 高级筛选
- 数据统计分析

[查看详细文档 →](https://ai-tokens.space/v1/zh/docs/guide/feature-guide/admin/log/)

#### 订阅管理

创建和管理订阅套餐。

- 创建订阅套餐
- 编辑套餐信息
- 管理订阅用户

[查看详细文档 →](https://ai-tokens.space/v1/zh/docs/guide/feature-guide/admin/subscription/)

#### 模型管理

配置模型定价和可用性。

- 设置模型倍率
- 启用或禁用模型
- 批量修改定价

[查看详细文档 →](https://ai-tokens.space/v1/zh/docs/guide/feature-guide/admin/model/)

#### 分组管理

创建用户分组，实现差异化计费和渠道分配。

- 创建用户分组
- 配置分组倍率
- 分配渠道

[查看详细文档 →](https://ai-tokens.space/v1/zh/docs/guide/feature-guide/admin/group/)

#### 系统设置（Root 专属）

Root 专属全局配置中心，涵盖站点信息、计费规则、支付、OAuth 等参数。

- 站点基本信息
- 计费规则配置
- 支付方式配置
- 邮件服务配置
- 注册与登录设置

[查看详细文档 →](https://ai-tokens.space/v1/zh/docs/guide/feature-guide/admin/system-setting/)

#### 系统高级配置（Root 专属）

系统设置的详细配置选项，包含支付、限流、聊天、绘图等高级功能。

- 支付设置（EPay、Stripe）
- 限流设置
- 倍率设置
- 聊天设置
- 绘图设置
- 数据看板设置
- 模型设置
- 运营设置

[查看详细文档 →](https://ai-tokens.space/v1/zh/docs/guide/feature-guide/admin/system-setting-advanced/)

#### 自定义 OAuth（Root 专属）

配置自定义 OAuth 登录提供商。

- 添加 OAuth 提供商
- 配置 OAuth 参数
- 测试 OAuth 登录

[查看详细文档 →](https://ai-tokens.space/v1/zh/docs/guide/feature-guide/admin/custom-oauth/)

#### 性能监控（Root 专属）

查看系统性能指标和运行状态。

- 查看系统负载
- 监控渠道性能
- 分析响应时间

[查看详细文档 →](https://ai-tokens.space/v1/zh/docs/guide/feature-guide/admin/performance/)

#### 文档配置（Root 专属）

配置文档站点的显示内容。

- 自定义文档内容
- 配置文档链接

[查看详细文档 →](https://ai-tokens.space/v1/zh/docs/guide/feature-guide/admin/docs-config/)

---

## 项目介绍

了解 AI-Tkoens，面向合法授权场景的 AI API 网关与用量管理系统

文档链接：https://ai-tokens.space/v1/zh/docs/guide/wiki/basic-concepts/project-introduction/

### 概述

AI-Tkoens 是面向合法授权场景的 AI API 网关与用量管理系统，为您的 AI 应用提供统一的基础设施，默认面向自用、团队内部和企业私有化部署。

AI-Tkoens 无缝集成全球主流 AI 服务提供商，包括 OpenAI、Anthropic、Google Gemini、DeepSeek、Midjourney、Suno 等 30+ 模型服务。

#### 核心特性

- **统一接口**：在合法授权的上游账号和服务范围内，提供统一 API 入口，兼容 OpenAI 标准格式
- **智能路由**：多渠道负载均衡、故障自动切换、加权随机分发
- **成本管理**：组织内成本分摊和企业客户账务管理能力
- **安全管控**：令牌权限管理、模型访问控制、API 调用审计
- **数据洞察**：实时数据看板、用量统计、成本分析
- **多租户架构**：适配自用、团队内部和企业私有化部署

### 许可证

AI-Tkoens 采用 **GNU AGPLv3** 开源协议，只要遵守开源协议即可免费使用。

在使用 AI-Tkoens 之前，请阅读[项目 LICENSE](https://github.com/QuantumNous/ai-tkoens/blob/main/LICENSE) 中的完整许可条款。

#### 开源许可证（AGPLv3）

在 AGPLv3 下，您可以自由地使用、修改和分发 AI-Tkoens。

**主要条款：**

- 可自由使用、修改和分发
- 完整许可文本：[GNU AGPLv3](https://www.gnu.org/licenses/agpl-3.0.html)
- **核心义务**：如果您修改并作为网络服务（SaaS）部署，您必须在 AGPLv3 下提供完整的源代码

#### 商业授权

如果您所在的组织政策不允许使用 AGPLv3 许可的软件，或您希望规避 AGPLv3 的开源义务，请发送邮件至：[support@quantumnous.com](mailto:support@quantumnous.com)

#### 贡献

所有对 AI-Tkoens 的贡献均在 AGPLv3 下授权。

**提交贡献即表示：**

- 您的代码在 AGPLv3 下授权给本项目和所有用户
- 您保留贡献的版权

#### 附加条款

- 许可证政策可能通过官方渠道（GitHub、网站）更新
- 如有争议，请参阅正式的 [LICENSE](https://github.com/QuantumNous/ai-tkoens/blob/main/LICENSE) 文档

### 免责声明

在使用 AI-Tkoens 之前，请阅读并理解这些重要声明。

**1. 合法授权与合规使用**

用户必须合法取得上游 API Key、模型服务和其他第三方服务授权，并遵守上游服务条款和平台规则。使用本项目时，应确保相关场景符合法律法规、监管要求和内容安全要求。详见[合规与可接受使用政策](https://ai-tokens.space/v1/zh/docs/legal/acceptable-use/)。

**2. AI 提供商服务条款**

用户必须遵守所有适用的 AI 提供商服务条款，包括 [OpenAI 使用条款](https://openai.com/policies/terms-of-use)、Anthropic 政策以及其他相关提供商协议。

**3. 教育和个人用途**

本项目主要用于个人学习和研究。不保证稳定性，开源许可证下可能不提供官方技术支持。

**4. AI 法规合规**

用户必须遵守相关 AI 法规，包括[《生成式人工智能服务管理暂行办法》](http://www.cac.gov.cn/2023-07/13/c_1690898327029107.htm)和其他适用的 AI 治理框架。

**5. 公众服务义务**

如用户面向不特定公众提供生成式 AI 服务，应自行完成所在地法律法规要求的备案、内容安全、身份管理、日志留存、税务、支付、消费者保护及上游授权等合规义务。

**6. 地方法律法规**

用户有责任确保遵守适用于其司法管辖区和使用场景的所有地方、国家和国际法律法规。

AI-Tkoens 按"原样"提供，不提供任何形式的保证。开发者和维护者对使用本软件产生的任何损害或法律问题不承担责任。

---

## 特性说明

文档链接：https://ai-tokens.space/v1/zh/docs/guide/wiki/basic-concepts/features-introduction/

1. 🎨 全新的UI界面（部分界面还待更新）
2. 🌍 多语言支持（待完善）
3. 🎨 添加[Midjourney-Proxy(Plus)](https://github.com/novicezk/midjourney-proxy)接口支持（使用前需确认第三方项目和上游服务授权、内容安全和服务条款要求）
4. 💰 支持合法授权部署中的内部余额、成本分摊或企业客户账务管理，可在系统设置中设置： 易支付
5. 🔍 支持查询合法授权渠道的用量或余额信息： 配合项目[ai-tkoens-key-tool](https://github.com/Calcium-Ion/ai-tkoens-key-tool)可实现用key查询使用
6. 📑 分页支持选择每页显示数量
7. 🔄 支持 SQLite 数据库存储，开箱即用，轻量便捷
8. 💵 支持组织内部成本核算或企业客户账务计量，可在 系统设置-运营设置 中设置
9. ⚖️ 支持渠道 **加权随机**
10. 📈 数据看板（控制台）
11. 🔒 可设置令牌能调用的模型
12. 🤖 支持Telegram授权登录： 系统设置-配置登录注册-允许通过Telegram登录 对[@Botfather](https://t.me/botfather)输入指令/setdomain 选择你的bot，然后输入http(s)://你的网站地址/login Telegram Bot 名称是bot username 去掉@后的字符串
13. 🎵 添加 [Suno API](https://github.com/Suno-API/Suno-API)接口支持（使用前需确认第三方项目和上游服务授权、内容安全和服务条款要求）
14. 🔄 支持Rerank模型，目前兼容Cohere和Jina，可接入Dify
15. ⚡ **[OpenAI Realtime API](https://platform.openai.com/docs/guides/realtime/integration)** - 支持OpenAI的Realtime API，支持Azure渠道
16. 支持使用路由/chat2link 进入聊天界面
17. 🧠 支持通过模型名称后缀设置 reasoning effort： OpenAI o系列模型 添加后缀 `-high` 设置为 high reasoning effort (例如: `o3-mini-high`) 添加后缀 `-medium` 设置为 medium reasoning effort (例如: `o3-mini-medium`) 添加后缀 `-low` 设置为 low reasoning effort (例如: `o3-mini-low`) Claude 思考模型 添加后缀 `-thinking` 启用思考模式 (例如: `claude-3-7-sonnet-20250219-thinking`)
18. 🔄 思考转内容，支持在 `渠道-编辑-渠道额外设置` 中设置 `thinking_to_content` 选项，默认`false`，开启后会将思考内容 `reasoning_content` 转换为 `<think>` 标签拼接到内容中返回。
19. 🔄 模型限流，支持在 `系统设置-速率限制设置` 中设置模型限流，支持设置总请求数限制和成功请求数限制
20. 💰 缓存计费支持，开启后可以在缓存命中时按照设定的比例计费： 在 `系统设置-运营设置` 中设置 提示缓存倍率 选项 在渠道中设置 提示缓存倍率，范围 0-1，例如设置为 0.5 表示缓存命中时按照 50% 计费 支持的渠道： OpenAI Azure DeepSeek Claude

---

## 技术架构

文档链接：https://ai-tokens.space/v1/zh/docs/guide/wiki/basic-concepts/technical-architecture/

![technical-architecture.svg](https://ai-tokens.space/v1/assets/media/73221fe4f065ee1d2985.svg)

---

## 分析工具设置指南

文档链接：https://ai-tokens.space/v1/zh/docs/guide/wiki/basic-concepts/analytics-setup/

#### 概述

AI-Tkoens 现在支持与流行的分析平台集成，帮助你追踪用户行为和网站性能：

- **Google Analytics 4 (GA4)**：谷歌分析平台的最新版本
- **Umami Analytics**：注重隐私的开源分析工具

两种分析工具可以同时启用，互不冲突。

#### 功能特点

✅ 零代码集成 - 仅通过环境变量配置 ✅ 自动注入脚本到 Web 界面 ✅ 支持 Docker 和独立部署 ✅ 注重隐私的实现方式 ✅ 无需修改前端代码

---

#### Google Analytics 4 设置

##### 1. 获取你的测量 ID

1. 访问 [Google Analytics](https://analytics.google.com/)
2. 创建新的媒体资源或选择现有的
3. 进入 **管理** → **数据流**
4. 创建或选择一个网站数据流
5. 复制你的 **测量 ID**（格式：`G-XXXXXXXXXX`）

##### 2. 配置环境变量

**使用 Docker Compose：**

编辑 `docker-compose.yml` 文件，取消注释 Google Analytics 行：

```
environment:
  - GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX # 替换为你的实际测量 ID
```

**独立部署：**

添加到 `.env` 文件或设置为环境变量：

```
export GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX
```

**使用 Docker Run：**

```
docker run -d \
  -e GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX \
  ...其他选项...
  calciumion/ai-tkoens:latest
```

##### 3. 重启应用

```
# Docker Compose
docker-compose down && docker-compose up -d

# 独立部署
# 直接重启你的应用程序
```

---

#### Umami Analytics 设置

##### 1. 获取 Umami 凭据

**选项 A：使用 Umami Cloud**

1. 在 [Umami Cloud](https://cloud.umami.is/) 注册
2. 添加一个新网站
3. 复制你的 **网站 ID**（UUID 格式）

**选项 B：自托管 Umami**

1. 部署你自己的 [Umami 实例](https://umami.is/docs/install)
2. 在仪表板中创建网站
3. 复制你的 **网站 ID** 和 **脚本 URL**

##### 2. 配置环境变量

**使用 Docker Compose：**

编辑 `docker-compose.yml` 文件：

```
environment:
  - UMAMI_WEBSITE_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
  # 可选：仅自托管实例需要
  - UMAMI_SCRIPT_URL=https://<your-umami-domain>/script.js
```

**独立部署：**

添加到 `.env` 文件：

```
export UMAMI_WEBSITE_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
export UMAMI_SCRIPT_URL=https://<your-umami-domain>/script.js  # 可选
```

**注意：** 如果使用 Umami Cloud，不需要设置 `UMAMI_SCRIPT_URL`，因为它默认使用官方 URL。

##### 3. 重启应用

与 Google Analytics 相同 - 重启应用以应用更改。

---

#### 同时使用两种分析工具

你可以同时启用 Google Analytics 和 Umami：

```
environment:
  - GOOGLE_ANALYTICS_ID=G-ABC123XYZ
  - UMAMI_WEBSITE_ID=a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6
  - UMAMI_SCRIPT_URL=https://analytics.umami.is/script.js
```

---

#### 验证

重启应用后：

1. 在浏览器中打开 Web 界面
2. 打开浏览器开发者工具（F12）→ **网络**标签
3. 刷新页面
4. 查找以下请求： Google Analytics：`https://www.googletagmanager.com/gtag/js` Umami：你配置的脚本 URL

你也可以查看页面源代码，在 `<head>` 部分查找注入的脚本。

---

#### 故障排除

**分析工具无法工作？**

1. ✅ 验证环境变量设置正确
2. ✅ 更改变量后重启应用
3. ✅ 检查浏览器控制台错误
4. ✅ 确保测量 ID/网站 ID 格式正确
5. ✅ 检查广告拦截器是否干扰

**Docker 用户：**

```
# 检查环境变量是否设置
docker exec ai-tkoens env | grep -E "GOOGLE_ANALYTICS|UMAMI"
```

---

#### 隐私考虑

- Google Analytics 根据[谷歌隐私政策](https://policies.google.com/privacy)收集用户数据
- Umami 注重隐私，不收集个人数据
- 如果使用分析工具，请考虑在网站上添加隐私政策
- 两种工具在正确配置时都符合 GDPR 要求

---

### 环境变量参考

| 变量 | 必需 | 默认值 | 说明 |
| --- | --- | --- | --- |
| GOOGLE_ANALYTICS_ID | 否 | - | Google Analytics 4 测量 ID（格式：G-XXXXXXXXXX） |
| UMAMI_WEBSITE_ID | 否 | - | Umami 网站 ID（UUID 格式） |
| UMAMI_SCRIPT_URL | 否 | https://analytics.umami.is/script.js | Umami 脚本 URL（仅自托管需要） |

---

### 相关链接

- [Google Analytics](https://analytics.google.com/)
- [Umami Analytics](https://umami.is/)
- [Umami Documentation](https://umami.is/docs)
- [Google Analytics Privacy](https://support.google.com/analytics/answer/6004245)

---

## 性能分析设置指南

文档链接：https://ai-tokens.space/v1/zh/docs/guide/wiki/basic-concepts/performance-analysis/

#### 概述

AI-Tkoens 提供两类性能分析能力：

- **pprof（内置）**：适合临时诊断与离线分析
- **Pyroscope（可选）**：适合线上持续分析与火焰图可视化

两者可以同时启用，互不冲突。

#### 功能特点

✅ 零代码集成 - 仅通过环境变量配置 ✅ 支持 Docker 和独立部署 ✅ 支持临时诊断与持续分析并存 ✅ 可选鉴权与实例区分

---

#### pprof（内置）设置

##### 1. 配置环境变量

**使用 Docker Compose：**

```
environment:
  - ENABLE_PPROF=true
```

**独立部署：**

```
export ENABLE_PPROF=true
```

##### 2. 重启应用

重启应用以应用更改。

##### 3. 验证

如果未修改路由，通常可在 `/debug/pprof/` 访问（以实际部署为准）。

---

#### Pyroscope 设置

##### 1. 准备 Pyroscope 服务

确保 Pyroscope 服务可访问，并记录服务地址（例如：`http://localhost:4040`）。

##### 2. 配置环境变量

**使用 Docker Compose：**

```
environment:
  - PYROSCOPE_URL=http://localhost:4040
  - PYROSCOPE_APP_NAME=ai-tkoens
  - PYROSCOPE_BASIC_AUTH_USER=your-user
  - PYROSCOPE_BASIC_AUTH_PASSWORD=your-password
  - PYROSCOPE_MUTEX_RATE=5
  - PYROSCOPE_BLOCK_RATE=5
  - HOSTNAME=your-hostname
```

**独立部署：**

```
export PYROSCOPE_URL=http://localhost:4040
export PYROSCOPE_APP_NAME=ai-tkoens
export PYROSCOPE_BASIC_AUTH_USER=your-user
export PYROSCOPE_BASIC_AUTH_PASSWORD=your-password
export PYROSCOPE_MUTEX_RATE=5
export PYROSCOPE_BLOCK_RATE=5
export HOSTNAME=your-hostname
```

##### 3. 重启应用

重启应用以应用更改。

##### 4. 验证

1. 打开 Pyroscope UI
2. 选择 `PYROSCOPE_APP_NAME` 对应的应用
3. 如设置了 `HOSTNAME`，可在实例维度区分来源

---

#### 故障排除

**性能分析无法工作？**

1. ✅ 验证环境变量设置正确
2. ✅ 更改变量后重启应用
3. ✅ 检查网络连通性与鉴权配置
4. ✅ 确认 `PYROSCOPE_APP_NAME` 命名一致

**Docker 用户：**

```
# Check env vars
docker exec ai-tkoens env | grep -E "PPROF|PYROSCOPE"
```

---

### 环境变量参考

| 变量 | 必需 | 默认值 | 说明 |
| --- | --- | --- | --- |
| ENABLE_PPROF | 否 | false | 启用 pprof 性能分析 |
| PYROSCOPE_URL | 否 | - | Pyroscope 服务地址 |
| PYROSCOPE_APP_NAME | 否 | - | Pyroscope 应用标识 |
| PYROSCOPE_BASIC_AUTH_USER | 否 | - | Pyroscope Basic Auth 用户名 |
| PYROSCOPE_BASIC_AUTH_PASSWORD | 否 | - | Pyroscope Basic Auth 密码 |
| PYROSCOPE_MUTEX_RATE | 否 | - | Mutex 采样率 |
| PYROSCOPE_BLOCK_RATE | 否 | - | Block 采样率 |
| HOSTNAME | 否 | - | 实例标识（可选） |

---

### 相关链接

- [Pyroscope](https://pyroscope.io/)
- [Pyroscope Documentation](https://pyroscope.io/docs/)

---

## 数据看板

文档链接：https://ai-tokens.space/v1/zh/docs/guide/console/dashboard/

在这里可以查看 AI-Token 的总体统计数据

![数据看板](https://ai-tokens.space/v1/assets/media/3b447b6ca823821e7e60.png)

---

## 渠道

文档链接：https://ai-tokens.space/v1/zh/docs/guide/console/channel-management/

上游渠道必须是部署方合法拥有或已获授权的账号、API Key、模型服务或企业合约。负载均衡、故障自动切换、加权随机、多密钥管理等功能用于高可用和企业多账号管理，使用时应遵守上游服务条款、平台规则和监管要求。

在这里可以管理 AI-Token 的上游渠道

![渠道](https://ai-tokens.space/v1/assets/media/f56d3371063ab76da036.png)

### 渠道创建/编辑页面

![渠道管理1](https://ai-tokens.space/v1/assets/media/ee078eb70aac7e198624.png)

![渠道管理2](https://ai-tokens.space/v1/assets/media/96d2e98ea626c6d48193.png)

![渠道管理3](https://ai-tokens.space/v1/assets/media/eb50c313200c2b29cc82.png)

### 概述

参数覆盖系统支持两种模式：简单覆盖模式（向前兼容）和高级操作模式。通过灵活的条件判断和操作类型，可以实现复杂的参数动态调整。参数覆盖功能只能用于兼容合法上游接口格式、企业网络兼容和请求规范化。

### 使用方式

#### 简单覆盖模式

向前兼容性，直接指定要覆盖的字段和值，系统会将这些字段合并到原始请求中

```
{
  "temperature": 0.8,
  "max_tokens": 2000,
  "model": "gpt-4"
}
```

#### 高级操作模式

通过 `operations` 数组定义复杂的参数操作，支持条件判断、数组操作、字符串拼接与字符串规范化等高级功能

##### 基本结构

```
{
  "operations": [
    {
      "path": "temperature",
      "mode": "set",
      "value": 0.8,
      "conditions": [...],
      "logic": "AND"
    }
  ]
}
```

**字段说明（按需填写）：**

- `mode`: 必填
- `path`: 适用于 `set` / `delete` / `append` / `prepend` / `trim_prefix` / `trim_suffix` / `ensure_prefix` / `ensure_suffix` / `trim_space` / `to_lower` / `to_upper` / `replace` / `regex_replace`
- `value`: 常见于 `set` / `append` / `prepend` / `trim_prefix` / `trim_suffix` / `ensure_prefix` / `ensure_suffix`
- `from` / `to`: 适用于 `move` / `copy` / `replace` / `regex_replace`
- `keep_origin`: 用于 `set`（已有值则跳过）以及对象合并时的 `append` / `prepend`

### 操作模式 (mode)

#### 1. set - 设置值

设置指定路径的值

```
{
  "path": "temperature",
  "mode": "set",
  "value": 0.8,
  "keep_origin": false
}
```

**参数说明：**

- `keep_origin`: 为 `true` 时，如果目标路径已存在值则跳过设置

#### 2. delete - 删除字段

删除指定路径的字段

```
{
  "path": "messages.0",
  "mode": "delete"
}
```

#### 3. move - 移动字段

将一个字段的值移动到另一个位置

```
{
  "mode": "move",
  "from": "messages.0.content",
  "to": "system"
}
```

#### 4. append - 追加内容

在现有内容后追加新内容

```
{
  "path": "messages.0.content",
  "mode": "append",
  "value": "\n\n请用中文回答。"
}
```

**支持的数据类型：**

- **字符串**: 在原字符串末尾追加
- **数组**: 在数组末尾添加元素（支持添加单个元素或数组）
- **对象**: 合并对象属性

#### 5. prepend - 前置内容

在现有内容前添加新内容

```
{
  "path": "messages.0.content",
  "mode": "prepend",
  "value": "重要提示：请仔细阅读以下内容。\n\n"
}
```

**支持的数据类型：**

- **字符串**: 在原字符串开头前置
- **数组**: 在数组开头添加元素（支持添加单个元素或数组）
- **对象**: 合并对象属性

#### 6. copy - 复制字段

将 `from` 指定路径的值复制到 `to` 指定路径（不删除源字段）

```
{
  "mode": "copy",
  "from": "model",
  "to": "original_model"
}
```

**参数要求：**

- `from` / `to`: 必填
- 源路径不存在时会报错

#### 7. trim_prefix - 去除前缀

对字符串字段去除指定前缀（若不匹配则不变）

```
{
  "path": "model",
  "mode": "trim_prefix",
  "value": "openai/"
}
```

**参数要求：**

- `value`: 必填

#### 8. trim_suffix - 去除后缀

对字符串字段去除指定后缀（若不匹配则不变）

```
{
  "path": "model",
  "mode": "trim_suffix",
  "value": "-latest"
}
```

**参数要求：**

- `value`: 必填

#### 9. ensure_prefix - 确保前缀

确保字符串字段以指定前缀开头（已存在则不变）

```
{
  "path": "model",
  "mode": "ensure_prefix",
  "value": "openai/"
}
```

**参数要求：**

- `value`: 必填且不能为空字符串

#### 10. ensure_suffix - 确保后缀

确保字符串字段以指定后缀结尾（已存在则不变）

```
{
  "path": "model",
  "mode": "ensure_suffix",
  "value": "-latest"
}
```

**参数要求：**

- `value`: 必填且不能为空字符串

#### 11. trim_space - 去除首尾空白

对字符串字段执行 `TrimSpace`（空格、换行、制表符等都会被移除）

```
{
  "path": "model",
  "mode": "trim_space"
}
```

#### 12. to_lower - 转小写

将字符串字段转换为小写

```
{
  "path": "model",
  "mode": "to_lower"
}
```

#### 13. to_upper - 转大写

将字符串字段转换为大写

```
{
  "path": "model",
  "mode": "to_upper"
}
```

#### 14. replace - 字符串替换

对字符串字段执行子串替换

```
{
  "path": "model",
  "mode": "replace",
  "from": "openai/",
  "to": ""
}
```

**参数要求：**

- `from`: 必填且不能为空字符串
- `to`: 可选，省略时等同于空字符串

#### 15. regex_replace - 正则替换

对字符串字段执行正则匹配替换

```
{
  "path": "model",
  "mode": "regex_replace",
  "from": "^gpt-",
  "to": "openai/gpt-"
}
```

**参数要求：**

- `from`: 必填（正则表达式，Go regexp 语法）
- `to`: 可选，省略时等同于空字符串

### 条件判断

通过 `conditions` 数组设置操作执行的条件，仅当条件满足时才会执行对应操作

#### 条件结构

```
{
  "conditions": [
    {
      "path": "model",
      "mode": "contains",
      "value": "gpt-4",
      "invert": false,
      "pass_missing_key": false
    }
  ],
  "logic": "AND"
}
```

#### 条件匹配模式

- `full`: 完全匹配（默认）
- `prefix`: 前缀匹配
- `suffix`: 后缀匹配
- `contains`: 包含匹配
- `gt`: 大于（仅数字类型）
- `gte`: 大于等于（仅数字类型）
- `lt`: 小于（仅数字类型）
- `lte`: 小于等于（仅数字类型）
- 须知：

- 数值比较只能用于数字类型
- 字符串操作（prefix、suffix、contains）会将值转换为字符串进行比较

#### 条件参数说明

- `invert`: 反选功能，`true` 表示取反结果
- `pass_missing_key`: 当指定路径不存在时的行为 `true`: 路径不存在时条件通过 `false`: 路径不存在时条件不通过（默认）

#### 逻辑关系 (logic)

- `AND`: 所有条件都必须满足
- `OR`: 任意条件满足即可（默认）

### 路径语法

使用 JSON 路径语法访问嵌套字段：

- `temperature` - 根级字段
- `messages.0.content` - 数组第一个元素的 content 字段
- `messages.-1.content` - 数组最后一个元素的 content 字段
- `metadata.user.name` - 嵌套对象字段

同时，`path` 支持以下内置变量（无需在请求体中显式存在），可直接用于条件判断：

| 变量 | 含义 | 典型用途 |
| --- | --- | --- |
| model / upstream_model | 重定向后的目标模型 | 按实际调用的上游模型做条件匹配 |
| original_model | 重定向前的目标模型 | 按用户请求的原始模型做条件匹配 |

### 实用示例

#### 1. 动态调整模型参数

根据消息内容动态调整温度参数：

```
{
  "operations": [
    {
      "path": "temperature",
      "mode": "set",
      "value": 0.3,
      "conditions": [
        {
          "path": "messages.0.content",
          "mode": "contains",
          "value": "代码"
        }
      ]
    },
    {
      "path": "temperature",
      "mode": "set",
      "value": 0.9,
      "conditions": [
        {
          "path": "messages.0.content",
          "mode": "contains",
          "value": "创意"
        }
      ]
    }
  ]
}
```

#### 2. 添加系统提示

在消息数组开头添加系统消息：

```
{
  "operations": [
    {
      "path": "messages",
      "mode": "prepend",
      "value": [
        {
          "role": "system",
          "content": "你是一个专业的AI助手，请始终保持礼貌和专业。"
        }
      ]
    }
  ]
}
```

#### 3. 根据模型类型调整参数

根据不同模型设置不同的 max_tokens：

```
{
  "operations": [
    {
      "path": "max_tokens",
      "mode": "set",
      "value": 4000,
      "conditions": [
        {
          "path": "model",
          "mode": "prefix",
          "value": "gpt-4"
        }
      ]
    },
    {
      "path": "max_tokens",
      "mode": "set",
      "value": 2000,
      "conditions": [
        {
          "path": "model",
          "mode": "prefix",
          "value": "gpt-3.5"
        }
      ]
    }
  ]
}
```

#### 4. 多条件组合（AND逻辑）

同时满足多个条件时才执行操作：

```
{
  "operations": [
    {
      "path": "stream",
      "mode": "set",
      "value": false,
      "conditions": [
        {
          "path": "model",
          "mode": "contains",
          "value": "claude"
        },
        {
          "path": "messages.0.content",
          "mode": "contains",
          "value": "长文"
        }
      ],
      "logic": "AND"
    }
  ]
}
```

#### 5. 数值比较条件

根据数值大小进行条件判断：

```
{
  "operations": [
    {
      "path": "temperature",
      "mode": "set",
      "value": 0.1,
      "conditions": [
        {
          "path": "max_tokens",
          "mode": "gt",
          "value": 1000
        }
      ]
    }
  ]
}
```

#### 6. 反选条件

使用 `invert` 实现反选逻辑：

```
{
  "operations": [
    {
      "path": "stream",
      "mode": "set",
      "value": true,
      "conditions": [
        {
          "path": "model",
          "mode": "contains",
          "value": "gpt-3.5",
          "invert": true
        }
      ]
    }
  ]
}
```

#### 7. 处理缺失字段

使用 `pass_missing_key` 处理可能不存在的字段：

```
{
  "operations": [
    {
      "path": "temperature",
      "mode": "set",
      "value": 0.7,
      "conditions": [
        {
          "path": "custom_field",
          "mode": "full",
          "value": "special",
          "pass_missing_key": true
        }
      ]
    }
  ]
}
```

#### 8. 字符串拼接示例

在用户消息后追加指导语：

```
{
  "operations": [
    {
      "path": "messages.-1.content",
      "mode": "append",
      "value": "\n\n请详细解释你的思考过程。"
    }
  ]
}
```

### 注意事项

**执行顺序**: 操作按照在 `operations` 数组中的顺序依次执行，前面的操作会影响后续操作

---

## 用户管理

文档链接：https://ai-tokens.space/v1/zh/docs/guide/console/user-management/

这里可以管理 AI-Token 的注册用户

![用户管理](https://ai-tokens.space/v1/assets/media/55009e6792580d8587dc.png)

---

## API 令牌

文档链接：https://ai-tokens.space/v1/zh/docs/guide/console/api-token/

在这里可以进行查看、编辑和添加令牌等操作。

### 查看令牌

![查看令牌](https://ai-tokens.space/v1/assets/media/e48d23329990fac238e7.png)

### 添加令牌

![添加令牌](https://ai-tokens.space/v1/assets/media/361f64eab49ca0776b98.png)

---

## 系统设置

文档链接：https://ai-tokens.space/v1/zh/docs/guide/console/settings/system-settings/

这里可以配置 AI-Token worker，邮件服务器和登录注册相关设置

![系统设置1](https://ai-tokens.space/v1/assets/media/398ee45d51b9befb1253.png)

![系统设置2](https://ai-tokens.space/v1/assets/media/2bc1af2533a035958880.png)

当启用OIDC配置后，请一定要勾选"允许新用户注册"，否则会导致OIDC登录的新用户无法正常创建用户，并同时勾选"允许通过OIDC进行登录"。其他配置根据需要勾选。

![系统设置3](https://ai-tokens.space/v1/assets/media/63d253e6b56a24e5cead.png)

![系统设置4](https://ai-tokens.space/v1/assets/media/c3edd2d1e70ba1c7e26d.png)

---

## 运营设置

文档链接：https://ai-tokens.space/v1/zh/docs/guide/console/settings/operation-settings/

在这里配置充值链接、文档地址、屏蔽词、日志记录、监控和额度等运营设置。

屏蔽词、日志记录和监控功能应服务于内容安全、滥用治理和合规审计。部署方应确保这些功能用于保障服务安全合规，追踪或治理能力。

![运营1](https://ai-tokens.space/v1/assets/media/c83e31a8d64902f5c492.png) ![运营2](https://ai-tokens.space/v1/assets/media/671cb362cf4b4ef9c939.png) ![运营3](https://ai-tokens.space/v1/assets/media/ec3b37a75579601084d5.png)

---

## 模型相关设置

文档链接：https://ai-tokens.space/v1/zh/docs/guide/console/settings/model-settings/

这里可以配置请求透传，连接保活和针对特定模型的设置。

![模型设置1](https://ai-tokens.space/v1/assets/media/732213ee3dfadb57e5b6.png) ![模型设置2](https://ai-tokens.space/v1/assets/media/c9932262eb56415f75b0.png) ![模型设置3](https://ai-tokens.space/v1/assets/media/22a129e214a50e1eebb6.png)

---

## 支付设置

文档链接：https://ai-tokens.space/v1/zh/docs/guide/console/settings/payment-settings/

支付能力适用于合法授权场景下的内部结算、企业客户账务或合规服务收费。部署方应确保相关服务、收费、上游授权和运营方式符合所在地法律法规、上游服务条款、平台规则和支付风控要求。

这里可以配置充值功能相关的设置

![支付设置](https://ai-tokens.space/v1/assets/media/1fb756ef0e616894308d.png)

![Stripe](https://ai-tokens.space/v1/assets/media/2a6c1968dfa14574f80f.png)

### 支持的支付网关

- **易支付（EPay）** 必填项：`API 地址`、`商户 ID（PID）`、`商户密钥（KEY）` 平台回调参数包含签名，系统会进行校验并自动入账
- **Stripe（可选）** 必填项：`API 密钥` `WebHook 签名密钥` `商品价格 ID`

### 什么是易支付

`易支付`是对“第三方聚合收款网关/接口”模式的泛称，并非某一家具体的网站或公司。既可指商用聚合支付服务，也可指自建/开源、遵循“易支付协议风格”的网关实现。

- **核心作用**: 聚合微信支付、支付宝、银行卡等渠道，向商户提供统一的下单、签名校验与回调接口。
- **合规提示**: 网关本身不等同于持牌支付机构；资金清结算与合规依赖其对接的持牌渠道，请遵循所在地监管与风控要求。

### 充值方式设置模板

在“充值方式”中，可按以下结构配置：

```
[
  {
    "color": "rgba(var(--semi-blue-5), 1)",
    "name": "支付宝",
    "type": "alipay"
  },
  {
    "color": "rgba(var(--semi-green-5), 1)",
    "name": "微信",
    "type": "wxpay"
  },
  {
    "color": "rgba(var(--semi-green-5), 1)",
    "name": "Stripe",
    "type": "stripe",
    "min_topup": "50"
  },
  {
    "name": "自定义1",
    "color": "black",
    "type": "custom1",
    "min_topup": "50"
  }
]
```

#### 字段说明

- name: 展示文案。显示在"选择支付方式"的按钮上（如"支付宝/微信/Stripe/自定义1"）。
- color: 按钮/徽标的主题色或边框色。支持任意 CSS 颜色值，推荐使用现有设计令牌（如 `rgba(var(--semi-blue-5), 1)`）。
- type: 通道标识，用于后端路由与下单。 `stripe` → 走 Stripe 网关。 其他（如 `alipay`、`wxpay`、`custom1` 等）→ 走易支付风格网关，并将该值作为渠道参数透传。 详细逻辑见后端控制器 `controller/topup.go`（参考: [controller/topup.go](https://github.com/QuantumNous/ai-tkoens/blob/main/controller/topup.go)）。
- min_topup: 最低充值金额（单位与页面货币一致）。当输入金额小于该值时，页面会提示"此支付方式最低充值金额为 X"，并限制发起支付；后端也会进行校验。
- 排序: 按数组顺序从左到右渲染。

### 充值金额配置

#### 自定义充值数量选项

设置用户可选择的充值数量选项，例如：

```
[10, 20, 50, 100, 200, 500]
```

这些数值会显示在"选择充值额度"区域，用户可以直接点击选择对应的充值金额。

#### 充值金额折扣配置

设置不同充值金额对应的折扣，键为充值金额，值为折扣率，例如：

```
{
  "100": 0.95,
  "200": 0.9,
  "500": 0.85
}
```

- 键：充值金额（字符串格式）
- 值：折扣率（0-1之间的小数，如 0.95 表示 95% 价格，即 5% 折扣）
- 系统会根据配置自动计算实付金额和节省金额
- 折扣功能的使用应符合授权范围、上游服务条款、平台规则和所在地法律法规要求
- 详细实现逻辑见后端控制器 [controller/topup.go](https://github.com/QuantumNous/ai-tkoens/blob/main/controller/topup.go)

---

## 钱包

文档链接：https://ai-tokens.space/v1/zh/docs/guide/console/wallet/

在这里可以进行内部余额管理、授权兑换和合规邀请记录。支付方式由管理员在系统设置->支付设置中配置。

充值、兑换码和邀请链接适用于合法授权场景。使用时应符合授权范围、上游服务条款、平台规则和所在地法律法规要求。

![钱包](https://ai-tokens.space/v1/assets/media/55e3cf560e8ff6477836.png)

---

## 使用日志

文档链接：https://ai-tokens.space/v1/zh/docs/guide/console/usage-log/

在这里可以查看调用API的日志，查看所使用的令牌分组、模型和花费。普通用户可以看见自己的日志，管理员可以看见其它用户的日志。

![使用日志](https://ai-tokens.space/v1/assets/media/0ed371a6efc4ca534737.png)

---

# 五、AI 应用接入与配置

## AI 应用

支持的 AI 应用和集成方案

文档链接：https://ai-tokens.space/v1/zh/docs/apps/

### 概述

AI-Tkoens 兼容多种流行的 AI 应用和工具。以下是已验证支持的应用列表及配置指南。

### 支持的应用

#### AionUi

免费开源的Cowork，支持多模型、文件管理和实时预览。

#### CC Switch

支持一键填入，点击 AI-Tkoens 后弹窗配置 Claude/Codex/Gemini 及主模型与各型号。

#### Cherry Studio

功能强大的 AI 助手客户端，支持多模型对话。

#### DeepChat

开源全功能AI Agent客户端。

#### Memoh

容器化 AI 智能体平台，每个机器人独立容器运行，支持长期记忆与多渠道接入。

#### OpenClaw

自托管 AI 助手平台 — 安装 OpenClaw，对接 AI-Tkoens，支持飞书、Discord、Slack 等多渠道 AI 代理管理。

#### Fluent Read

AI 驱动的智能阅读和翻译助手。

#### LangBot

基于大语言模型的聊天机器人框架。

#### Luna Translator

游戏和文档的实时翻译工具。

#### AstrBot

开源的一站式 Agent 聊天机器人平台。

#### Claude Code

Anthropic Claude 驱动的代码编辑器集成。

#### Codex CLI

命令行界面的 AI 代码助手工具。

#### Factory Droid CLI

自动化工作流的 AI 代理工具。

### 集成指南

大多数应用只需要配置以下信息即可连接 AI-Tkoens：

1. **API 地址**：您的 AI-Tkoens 服务地址
2. **API Key**：在 AI-Tkoens 控制台生成的令牌
3. **模型名称**：选择需要使用的模型

具体配置步骤请参考各应用的详细文档。

---

## AionUi - 免费开源的桌面办公Agent

AionUi 教程 — 免费开源桌面办公 Agent，支持 Gemini CLI、Claude Code、Codex 等多种 AI 代理。对接 AI-Tkoens 实现多模型工作流。

文档链接：https://ai-tokens.space/v1/zh/docs/apps/aionui/

🚀 AionUi 是一款免费、本地、开源的Cowork，支持 Gemini CLI、Claude Code、Codex、OpenCode、Qwen Code、Goose CLI、Auggie 等多种 AI 代理。它提供了完整的 GUI 界面和 WebUI 远程访问功能，是 Cowork 的开源替代方案。

- 官网地址：[https://www.aionui.com](https://www.aionui.com)
- GitHub 仓库：[https://github.com/iOfficeAI/AionUi](https://github.com/iOfficeAI/AionUi)
- 下载地址：[https://github.com/iOfficeAI/AionUi/releases](https://github.com/iOfficeAI/AionUi/releases)

![AionUi Logo](https://ai-tokens.space/v1/assets/media/04a4fe2ed578d6554b35.png)

### 核心特性

#### 💬 多会话聊天

- **多会话 + 独立上下文** - 可同时打开多个聊天会话，每个会话拥有独立的上下文记忆
- **本地存储** - 所有对话数据保存在本地 SQLite 数据库中，不会丢失

#### 🤖 多模型支持

- **多平台支持** - 支持 Gemini、OpenAI、Claude、Qwen 等主流模型，灵活切换
- **本地模型支持** - 支持 Ollama、LM Studio 等本地模型部署

#### 🤝 多代理模式

- **同时运行多个 AI 代理** - 可同时运行多个 AI 代理（如 Gemini CLI、Claude Code、Codex、OpenCode、Qwen Code、Goose CLI、Auggie 等）
- **MCP 统一管理** - 通过 Model Context Protocol (MCP) 统一管理和配置所有代理，简化操作流程
- **Skills 配置** - 支持为不同代理配置专属的 Skills，扩展代理能力
- **助手自定义** - 支持自定义助手配置，打造个性化的 AI 工作流
- **独立配置** - 每个代理可独立配置和使用，互不干扰
- **灵活切换** - 在不同代理之间灵活切换，满足不同场景需求

#### 🗂️ 文件管理

- **文件树浏览 + 拖拽上传** - 像文件夹一样浏览文件，支持拖拽文件或文件夹一键导入
- **智能整理** - 可让 AI 帮助整理文件夹，自动分类

#### 📄 预览面板

- **9+ 格式预览** - 支持 PDF、Word、Excel、PPT、代码、Markdown、图片等格式
- **实时跟踪 + 可编辑** - 自动跟踪文件变化，支持实时编辑和调试 Markdown、代码、HTML

#### 🎨 AI 图像生成与编辑

- **智能图像生成** - 支持 Gemini 2.5 Flash Image Preview、Nano、Banana 等多种图像生成模型
- **图像识别与编辑** - AI 驱动的图像分析和编辑功能

#### 🌐 多渠道访问

- **WebUI 远程访问** - 可通过浏览器从网络上的任何设备访问，支持移动设备
- **Telegram 集成** - 支持通过 Telegram 机器人进行交互
- **飞书集成** - 支持通过飞书进行访问和交互
- **本地数据安全** - 所有数据存储在本地 SQLite 数据库中，适合服务器部署

### AI-Token 接入方法

#### 参数填写

提供商类型：AI-Token 支持的类型 API 密钥：于 AI-Token 获取 API 地址：AI-Token 站点地址（例如：`https://<your-AI-Token-domain>/v1`）

请使用您自己部署的 AI-Tkoens，或确认服务方具备合法上游授权和合规义务的 AI-Tkoens 服务。不要将来源不明的 API 地址或密钥接入生产环境。

#### 配置步骤

1. **在 AI-Token 中复制 API key** ![复制 API 密钥](https://ai-tokens.space/v1/assets/media/bb107492eacf8a5f0c38.png)
2. **打开 AionUi 设置** 在 AionUi 中进入设置页面 找到 模型配置 Tab 点击"添加模型" ![打开设置](https://ai-tokens.space/v1/assets/media/d16ce1162de514a005e9.png)
3. **添加新的提供商** 点击"添加模型" 选择 AI-Token ![添加 AI-Token 提供商](https://ai-tokens.space/v1/assets/media/ba7170f858cec6dd155a.png)
4. **配置 API 信息** API 地址：填写您的 AI-Token 站点地址（格式：`https://<your-AI-Token-domain>/v1`） API 密钥：粘贴从 AI-Token 控制台复制的 API Key
5. **添加模型** 下拉选择需要添加的模型 模型名称应与 AI-Token 中配置的模型名称一致 选择合适的请求协议
6. **开始使用** 返回聊天页面 选择已配置的 AI-Token 模型开始对话

### 相关链接

- [GitHub 仓库](https://github.com/iOfficeAI/AionUi)
- [完整使用指南](https://github.com/iOfficeAI/AionUi#-detailed-usage-guide)
- [FAQ 常见问题](https://github.com/iOfficeAI/AionUi#-support--help)

---

## CC Switch - AI CLI 统一管理工具

CC Switch 教程 — 跨平台 AI CLI 管理工具，统一管理 Claude Code、Codex、Gemini CLI 的 Provider 配置、MCP 服务器与系统提示词。对接 AI-Tkoens 一键填入。

文档链接：https://ai-tokens.space/v1/zh/docs/apps/cc-switch/

聊天设置选项

在 AI-Tkoens 控制台的系统设置->聊天设置中，可添加如下快捷选项，便于在令牌管理页一键填充到 CC Switch：

```
{ "CC Switch": "ccswitch" }
```

🔀 CC Switch 是一款开源、跨平台的 AI CLI 统一管理工具，支持 Claude Code、Codex 和 Gemini CLI 的 Provider 配置一键切换、MCP 服务器统一管理、系统提示词（Prompts）管理以及 Skills 扩展管理， 让你在多个 AI 编程助手之间自由切换，无需手动编辑配置文件。

- GitHub 仓库：[https://github.com/farion1231/cc-switch](https://github.com/farion1231/cc-switch)
- 下载地址：[GitHub Releases](https://github.com/farion1231/cc-switch/releases)

### 核心特性

#### 🔌 Provider 管理

- **一键切换** — 在 Claude Code、Codex、Gemini 的 API 配置之间一键切换，无需手动修改环境变量或配置文件
- **多端点支持** — 每个 Provider 可配置多个端点，支持 API Key 管理与延迟测速
- **4 层模型配置** — 支持 Haiku / Sonnet / Opus / Custom 四级模型粒度配置

#### 🛠️ MCP 服务器管理

- **跨应用统一管理** — 单面板管理 Claude / Codex / Gemini 三端的 MCP 服务器
- **三种传输类型** — 支持 stdio、HTTP、SSE（Server-Sent Events）
- **自动同步** — 统一导入导出 + 双向同步

#### 💬 Prompts 管理

- **多预设系统提示词** — 无限预设、快速切换
- **跨应用支持** — Claude（`CLAUDE.md`）、Codex（`AGENTS.md`）、Gemini（`GEMINI.md`）
- **Markdown 编辑器** — CodeMirror 6 + 实时预览

#### 🌐 多平台支持

- **桌面应用** — Windows、macOS、Linux 原生安装包
- **Web 版本** — 适用于无头服务器 / SSH 远程环境的浏览器访问方案
- **CLI 版本** — 命令行交互模式与命令模式双支持

### AI-Token 接入方法

CC Switch 支持 `ccswitch://` Deep Link 协议，可从 AI-Tkoens 令牌管理页一键导入 Provider 配置。

#### 配置步骤

1. **在 AI-Tkoens 令牌管理页，点击对应令牌的下拉菜单** 在菜单中选择 **CC Switch** 选项，系统会自动唤起 CC Switch 应用并弹出配置弹窗。
2. **在弹窗中完成配置** ![填入 CC Switch 弹窗](https://ai-tokens.space/v1/assets/media/e2203aaa5f9a191f1a31.png) 弹窗各字段说明： **应用**：顶部切换应用类型 — **Claude** / **Codex** / **Gemini**，根据需要选择目标应用 **名称**：为该配置填写一个名称（例如 `My Claude`），方便后续在 CC Switch 中识别和切换 **主模型**（必填）— 默认使用的主力模型 **Haiku 模型** — 轻量快速模型 **Sonnet 模型** — 均衡模型 **Opus 模型** — 最强模型 所有模型均为下拉选择，未选择时显示「请选择模型」。
3. **完成配置** 点击 **「打开 CC Switch」** 即可将配置导入 CC Switch 并开始使用；点击 **「取消」** 放弃本次操作。

### 安装方式

#### macOS（推荐 Homebrew）

```
brew tap farion1231/ccswitch
brew install --cask cc-switch
```

#### Windows

从 [Releases](https://github.com/farion1231/cc-switch/releases) 下载 `.msi` 安装包或便携版 `.zip`。

#### Linux

从 [Releases](https://github.com/farion1231/cc-switch/releases) 下载 `.deb` 包或 `.AppImage`。

ArchLinux 用户：

```
paru -S cc-switch-bin
```

#### Web 版本（无头 / SSH 服务器）

```
wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch-web-linux-x64.tar.gz
tar -xzf cc-switch-web-linux-x64.tar.gz
cd cc-switch-web/
./cc-switch-web
```

默认端口 `17666`，通过浏览器访问 `http://localhost:17666`。

### 相关链接

- [GitHub 仓库](https://github.com/farion1231/cc-switch)
- [更新日志](https://github.com/farion1231/cc-switch/blob/main/CHANGELOG.md)
- [Web 版本仓库](https://github.com/cp-yu/cc-switch-web)
- [CLI 版本仓库](https://github.com/thomas-jack/cc-switch-cli)

---

## Cherry Studio - 桌面 AI 客户端

Cherry Studio 教程 — 将桌面 AI 客户端对接 AI-Tkoens，一键填入 API Key。内置 30+ 专业 AI 助手，覆盖多种工作场景。

文档链接：https://ai-tokens.space/v1/zh/docs/apps/cherry-studio/

聊天设置选项

在 AI-Tkoens 控制台的系统设置->聊天设置中，可添加如下快捷选项，便于在令牌管理页一键填充到 Cherry Studio：

```
{ "Cherry Studio": "cherrystudio://providers/api-keys?v=1&data={cherryConfig}" }
```

🍒 Cherry Studio 是一款功能强大的桌面 AI 客户端，专为专业用户设计，集成了 30+ 行业智能助手，能够满足各种工作场景的需求，显著提升工作效率。

- 官网地址：[https://cherry-ai.com](https://cherry-ai.com/)
- 下载地址：[https://cherry-ai.com/download](https://cherry-ai.com/download)
- 官方文档：[https://docs.cherry-ai.com](https://docs.cherry-ai.com)

### AI-Token 接入方法

#### 参数填写

提供商类型：AI-Token 支持的类型 API 密钥：于 AI-Token 获取 API 地址：AI-Token 站点地址

请使用您自己部署的 AI-Tkoens，或确认服务方具备合法上游授权和合规义务的 AI-Tkoens 服务。不要将来源不明的 API 地址或密钥接入生产环境。

#### 图文指引

1. 在 AI-Token 中复制 API key ![复制 API 密钥](https://ai-tokens.space/v1/assets/media/c3a06d6d846d6a08e989.png)
2. 添加提供商 ![添加供应商](https://ai-tokens.space/v1/assets/media/f31e6349b89a22d27ad1.png)
3. 添加模型 ![添加模型](https://ai-tokens.space/v1/assets/media/c743b32f56f8fd8922c4.png)
4. 返回聊天页面 ![切换聊天页面](https://ai-tokens.space/v1/assets/media/307f30e144abb8509383.png)
5. 切换 AI-Token 模型 ![切换模型](https://ai-tokens.space/v1/assets/media/08a4e5d93ffe82eb14f2.png)

### 在 Cherry Studio 中画图

1. 首先添加支持画图的模型 ![画图模型](https://ai-tokens.space/v1/assets/media/28c7956cafc528eccaa9.png)
2. 画图 ![画图](https://ai-tokens.space/v1/assets/media/32ec6276cf5c9460c817.png)

---

## DeepChat - 全功能AI Agent客户端

DeepChat 教程 — 将全功能AI Agent客户端对接 AI-Tkoens，并通过 DeepLink 一键导入 DeepChat 配置。

文档链接：https://ai-tokens.space/v1/zh/docs/apps/deepchat/

聊天设置选项

在 AI-Tkoens 控制台的系统设置->聊天设置中，可添加如下快捷选项，便于在令牌管理页一键填充到 DeepChat：

```
{ "DeepChat": "deepchat://provider/install?v=1&data={deepchatConfig}" }
```

DeepChat 是一款开源、跨平台的商业化友好全功能AI Agent客户端，支持云端与本地模型、MCP 工具调用、Skills、ACP、Agent 集成和远程控制等工作流，适合需要统一管理多个 Provider 与高级 AI Agent的用户。

- 官网地址：[https://deepchat.thinkinai.xyz](https://deepchat.thinkinai.xyz)
- GitHub 仓库：[https://github.com/ThinkInAIXYZ/deepchat](https://github.com/ThinkInAIXYZ/deepchat)
- 下载地址：[https://deepchat.thinkinai.xyz/#/download](https://deepchat.thinkinai.xyz/#/download)

### AI-Token 接入方法

#### 方式一：一键导入

1. 在 AI-Tkoens 控制台侧边栏进入「令牌管理」，找到需要使用的令牌 ![进入令牌管理](https://ai-tokens.space/v1/assets/media/6346bf30d666cd149789.png)
2. 在令牌操作中选择 **DeepChat** ![选择 DeepChat](https://ai-tokens.space/v1/assets/media/6096b1f311a29edb3449.png)
3. 浏览器唤起 DeepChat，确认打开应用 ![打开 DeepChat](https://ai-tokens.space/v1/assets/media/0d0c9ae68340134f033d.png)
4. 在 DeepChat 的 Provider 导入预览中确认配置 ![确认 DeepChat 配置](https://ai-tokens.space/v1/assets/media/6206a4800f6e7948c188.png)
5. 打开模型列表，选择 AI-Tkoens 模型开始使用 ![打开模型列表](https://ai-tokens.space/v1/assets/media/a6406f2f4245a05f5288.png)

#### 方式二：手动导入

1. 在 AI-Tkoens 控制台复制 API Key 和站点地址 ![AI-Tkoens 手动配置指引](https://ai-tokens.space/v1/assets/media/d5f67a244da9d7260f76.png)
2. 在 DeepChat 设置中添加或编辑 AI-Tkoens Provider，填写 API 地址和 API Key ![DeepChat 手动配置指引](https://ai-tokens.space/v1/assets/media/651eb72fc445b3435aec.png)
3. 打开模型列表，选择 AI-Tkoens 模型开始使用 ![打开模型列表](https://ai-tokens.space/v1/assets/media/a6406f2f4245a05f5288.png)

### 相关链接

- [DeepChat GitHub 仓库](https://github.com/ThinkInAIXYZ/deepchat)
- [DeepChat 下载页面](https://deepchatai.cn/#/download)

---

## Memoh - 容器化 AI 智能体平台

Memoh 对接教程 — 将自托管容器化 AI 智能体平台对接 AI-Tkoens，为 Telegram、Discord、飞书、QQ、微信等渠道创建具有长期记忆的 AI 机器人。

文档链接：https://ai-tokens.space/v1/zh/docs/apps/memoh/

Memoh 是一个开源的自托管 AI 智能体平台，每个机器人运行在独立的容器中，拥有持久化记忆和独立文件系统。支持接入 Telegram、Discord、飞书、QQ、Matrix、企业微信、微信、邮件以及内置 Web UI 等 9 种渠道，并支持 MCP 工具调用、浏览器自动化、定时任务等丰富的智能体能力。

- 官方网站：[https://memoh.sh](https://memoh.sh)
- 官方文档：[https://docs.memoh.ai](https://docs.memoh.ai)
- 项目主页：[https://github.com/memohai/Memoh](https://github.com/memohai/Memoh)

### 核心特性

- **容器化隔离**：每个机器人运行在独立的 containerd 容器中，拥有专属文件系统和网络，支持快照、数据导入导出
- **记忆引擎**：基于 LLM 的事实抽取、混合检索（稠密 + 稀疏 + BM25）、24 小时上下文加载、记忆压缩与重建
- **多渠道支持**：Telegram、Discord、飞书、QQ、Matrix、企业微信、微信、邮件、Web UI
- **MCP 支持**：完整的 MCP 协议支持（HTTP / SSE / Stdio / OAuth），每个机器人可独立管理 MCP 连接
- **浏览器自动化**：内置 Playwright 驱动的无头浏览器，支持网页浏览、表单填写、截图等操作
- **Web 管理面板**：基于 Vue 3 + Tailwind CSS 的现代化管理界面，支持流式对话、工具调用可视化、文件管理等

### AI-Token 接入方法

Memoh 支持接入任何 OpenAI 兼容的模型提供商，可以通过 AI-Token 来统一管理和访问各种 AI 模型服务。

#### 配置步骤

##### 获取 AI-Token API Key 密钥

在 AI-Token 注册并登录后，点击上方导航栏的「控制台」，点击「令牌管理」，然后点击「添加令牌」按钮，创建一个新的 API Key 密钥，选择适当的权限，然后点击「创建」。

创建成功后，点击复制密钥按钮，复制生成的 API Key 密钥。

![copy-api-key](https://ai-tokens.space/v1/assets/media/c3a06d6d846d6a08e989.png)

##### 在 Memoh 中添加模型提供商

登录 Memoh Web 管理面板，进入提供商管理页面，点击AI-Token。

![switch-to-AI-Token-provider](https://ai-tokens.space/v1/assets/media/c8888bad1caab2d3037d.png)

在配置页面中填写以下信息：

- **API Base URL**：填写 AI-Token 的接口地址，例如 `https://api.example.com/v1`（如果本地部署则填写 `http://localhost:3000/v1`）
- **API Key**：粘贴从 AI-Token 复制的 API Key 密钥

点击保存，完成提供商配置。

##### 导入模型

提供商配置完成后，进入模型管理页面，点击自动导入或手动添加你需要使用的模型。

##### 为机器人配置模型

进入机器人设置页面，在模型配置一栏中，将默认聊天模型切换为刚刚通过 AI-Token 提供商添加的模型，点击保存。

![set_chat_model](https://ai-tokens.space/v1/assets/media/df2aefe07a0b7e25f962.png)

至此，您已经成功配置了 AI-Token 作为 Memoh 的模型提供商。现在，您可以通过 Memoh 中的各个渠道（Telegram、Discord、飞书等）与 AI 机器人对话，所有请求将通过 AI-Token 进行转发。

---

## 流畅阅读 (FluentRead) - 开源翻译插件

FluentRead 教程 — 开源浏览器翻译插件，支持 20+ 翻译引擎与 AI 大模型翻译。对接 AI-Tkoens 实现沉浸式双语阅读体验。

文档链接：https://ai-tokens.space/v1/zh/docs/apps/fluent-read/

聊天设置选项

在 AI-Tkoens 控制台的系统设置->聊天设置中，可添加如下快捷选项，便于在令牌管理页一键填充到 FluentRead：

```
{ "流畅阅读": "fluentread" }
```

🌊 流畅阅读（FluentRead）是一款开源浏览器翻译插件，致力于提供母语般的阅读体验。

- 项目地址：[https://github.com/Bistutu/FluentRead](https://github.com/Bistutu/FluentRead)

### 🌟 核心特性

#### 智能翻译引擎

- **多引擎支持**：支持 20+ 种翻译引擎
- **传统翻译**：微软翻译、谷歌翻译、DeepL翻译等
- **AI 大模型**：OpenAI、DeepSeek、Kimi、Ollama等
- **自定义引擎**：支持自定义翻译服务配置

#### 沉浸式阅读体验

- **双语对照**：原文与译文并列显示，阅读更轻松
- **划词翻译**：选中任意文本，即时获得翻译结果
- **一键复制**：快速复制译文，提高阅读效率
- **全文翻译**：悬浮球一键翻译整个网页，无需刷新页面

#### 隐私与定制

- **隐私保护**：所有数据本地存储，代码开源透明
- **高度定制**：丰富的自定义选项，满足不同场景需求
- **完全免费**：开源免费，非商业化项目

### 📦 安装方式

| 浏览器 | 安装方式 |
| --- | --- |
| Chrome | Chrome 应用商店 \| 国内镜像 |
| Edge | Edge 应用商店 |
| Firefox | Firefox 附加组件商店 |

### 🚀 配置方法

#### 从 AI-Tkoens 控制台导入配置（推荐）

当浏览器安装了流畅阅读插件后，打开 AI-Tkoens 控制台->令牌管理页面会弹出添加流畅阅读的提示

![添加提示](https://ai-tokens.space/v1/assets/media/3db876139e4859d1834b.png)

选择模型后点击一键填充到FluentRead，会弹出确认窗口，检查对应的信息是否正确

![确认](https://ai-tokens.space/v1/assets/media/0c03eb494ceb6101d66b.png)

确认导入后在流畅阅读中的AI-Tkoens配置便会启用

![配置结果](https://ai-tokens.space/v1/assets/media/80882775492d745ee3de.png)

#### 在流畅阅读中手动填写配置

![手动配置](https://ai-tokens.space/v1/assets/media/85380fa1b244e7b579ad.png)

| 配置项 | 内容 |
| --- | --- |
| 翻译服务 | AI-Token |
| 访问令牌 | AI-Token 密钥 |
| AI-Token接口 | AI-Token部署地址（不带/v1） |
| 模型 | 列表中选择，或者自定义模型 |
| 自定义模型 | 模型名称 |

---

## OpenClaw - 自托管 AI 智能助手平台

OpenClaw 教程 — 安装 OpenClaw、对接 AI-Tkoens，快速搭建自托管 AI 助手。开源项目，支持 Telegram、Discord、WhatsApp 等多渠道集成。

文档链接：https://ai-tokens.space/v1/zh/docs/apps/openclaw/

项目介绍

OpenClaw 是一个开源、自托管的个人 AI 助手平台，将消息应用连接到运行在你自己硬件上的 AI 代理。专为开发者和高级用户设计，无需交出数据控制权即可拥有自主 AI 助手。

- 官方主页：[https://openclaw.ai](https://openclaw.ai)
- 项目文档：[https://docs.openclaw.ai](https://docs.openclaw.ai)
- GitHub：[https://github.com/openclaw/openclaw](https://github.com/openclaw/openclaw)

OpenClaw 完全开源，你可以在 [OpenClaw 的 GitHub 仓库](https://github.com/openclaw/openclaw) 浏览源码、提交 Issue 或参与贡献。本教程涵盖安装、配置，以及将 OpenClaw 对接 AI-Tkoens 的完整步骤。

### 🌟 核心特性

#### 多渠道集成

- **多渠道集成**：支持 Telegram、Discord、WhatsApp、iMessage 等多种消息渠道，也可通过插件扩展更多平台
- **单一网关**：通过一个 Gateway 进程统一管理所有渠道
- **语音支持**：支持 macOS/iOS/Android 语音交互
- **Canvas 界面**：可渲染交互式 Canvas 界面

#### 自托管与数据安全

- **完全自托管**：运行在你自己的机器或服务器上
- **开源透明**：MIT 开源协议，代码完全透明
- **数据本地化**：上下文和技能存储在你的本地计算机，而非云端

#### 智能代理能力

- **持续运行**：支持后台常驻运行，拥有持久记忆
- **计划任务**：支持 cron 定时任务
- **会话隔离**：按代理/工作区/发送者隔离会话
- **多代理路由**：支持多代理协同工作
- **工具调用**：原生支持工具调用和代码执行

### 📦 接入前准备

准备信息

- Node.js 22 或更高版本
- 一个可用的 AI-Tkoens 地址（通常以 `/v1` 结尾）
- 一个可用的 AI-Tkoens API Key
- 请使用您自己部署的 AI-Tkoens，或确认服务方具备合法上游授权和合规义务的 AI-Tkoens 服务。不要将来源不明的 API 地址或密钥接入生产环境。

在开始接入 AI-Tkoens 之前，建议先按 OpenClaw 官方当前推荐流程把 Gateway 和 Control UI 跑起来。这样后续排查问题时，更容易区分是 OpenClaw 本身未启动，还是模型提供商配置有误。

#### 1. 安装 OpenClaw（macOS/Linux）

```
curl -fsSL https://openclaw.ai/install.sh | bash
```

其他安装方式可参考 OpenClaw 官方文档：[Getting Started](https://docs.openclaw.ai/start/getting-started)。

#### 2. 运行引导向导

```
openclaw onboard --install-daemon
```

该向导会完成基础认证、Gateway 设置，以及可选的渠道初始化。这里的目标是先把 OpenClaw 跑起来，后面再把默认模型切到 AI-Tkoens。

#### 3. 检查 Gateway 与 Control UI

```
openclaw gateway status
```

```
openclaw dashboard
```

如果浏览器能打开 Control UI，说明 OpenClaw 基础运行已经正常。这个阶段不需要先配置 Telegram、Discord、飞书等消息渠道。

#### 4. 定位配置文件

OpenClaw 的配置文件通常位于 `~/.openclaw/openclaw.json`，你可以在引导向导生成的基础上继续修改。

路径相关环境变量

如果你把 OpenClaw 跑在专用服务账号下，或希望自定义配置/状态目录，可以使用：

- `OPENCLAW_HOME`
- `OPENCLAW_STATE_DIR`
- `OPENCLAW_CONFIG_PATH`

详细说明见官方环境变量文档：[Environment Variables](https://docs.openclaw.ai/help/environment)。

### 🚀 使用 AI-Tkoens 作为模型提供商

OpenClaw 支持通过 `models.providers` 接入自定义或兼容 OpenAI 接口的模型网关。对于 AI-Tkoens，最常见的做法是把它作为一个自定义 provider 加进配置里，再把默认模型指向 `AI-Token/模型ID`。

#### 接入思路

1. 在 `models.providers` 下声明一个 `AI-Token` provider
2. 将 `baseUrl` 指向你的 AI-Tkoens 地址，并确保包含 `/v1`
3. 将 `api` 设为 `openai-completions`
4. 在 `models` 中列出你希望 OpenClaw 使用的模型 ID
5. 在 `agents.defaults.model.primary` 中把默认模型切到 `AI-Token/...`

#### 推荐做法：用环境变量保存密钥

先在当前 shell、服务环境，或 OpenClaw 可读取的 `.env` 中提供你的 AI-Tkoens 密钥：

```
export AI-Token_API_KEY="sk-your-AI-Token-key"
```

然后在 `openclaw.json` 里补充或修改以下片段：

```
{
  models: {
    mode: "merge",
    providers: {
      AI-Token: {
        baseUrl: "https://<your-AI-Token-domain>/v1",
        apiKey: "${AI-Token_API_KEY}",
        api: "openai-completions",
        models: [
          { id: "gemini-2.5-flash", name: "Gemini 2.5 Flash" },
          { id: "kimi-k2.5", name: "Kimi K2.5" },
        ],
      },
    },
  },

  agents: {
    defaults: {
      model: {
        primary: "AI-Token/gemini-2.5-flash",
        fallbacks: ["AI-Token/kimi-k2.5"],
      },
      models: {
        "AI-Token/gemini-2.5-flash": { alias: "flash" },
        "AI-Token/kimi-k2.5": { alias: "kimi" },
      },
    },
  },
}
```

这不是一份必须原样照抄的完整配置，而是接入 AI-Tkoens 最关键的部分。只要 `provider`、模型 ID 和默认模型引用对应正确，OpenClaw 就能通过 AI-Tkoens 调用你暴露出来的模型资源。

#### 关键配置说明

| 配置项 | 说明 |
| --- | --- |
| models.mode | 建议设为 merge ，在保留 OpenClaw 内置 provider 的同时追加 AI-Token |
| models.providers.AI-Token.baseUrl | 你的 AI-Tkoens 地址，通常需要带上 /v1 |
| models.providers.AI-Token.apiKey | AI-Tkoens 密钥，推荐通过 ${AI-Token_API_KEY} 注入 |
| models.providers.AI-Token.api | 对于 AI-Tkoens 这类 OpenAI 兼容网关，使用 openai-completions |
| models.providers.AI-Token.models | 这里列出的模型 ID 必须与你的 AI-Tkoens 实际暴露的模型名称一致 |
| agents.defaults.model.primary | 默认主模型，格式必须是 provider/model-id |
| agents.defaults.model.fallbacks | 备选模型列表，主模型失败时自动切换 |
| agents.defaults.models | 可选，用来给模型起别名，方便在 UI 或会话里引用 |

#### 验证是否接入成功

完成配置后，回到 Control UI 或重新打开：

```
openclaw dashboard
```

如果你能在 OpenClaw 中正常发起对话，并且默认模型已经变成 `AI-Token/...`，说明接入成功。你也可以使用：

```
openclaw models list
```

确认 `AI-Token/` 前缀的模型已经出现在可选列表中。

#### 常见问题

- `baseUrl` 没带 `/v1`：这是最常见的接入错误之一。
- 模型 ID 填错：`primary` 和 `fallbacks` 必须与 `models.providers.AI-Token.models` 里的 `id` 对应。
- 密钥只在当前终端生效：如果 Gateway 以后台服务运行，请确保服务进程也能读取 `AI-Token_API_KEY`。
- 想前台排障：可使用官方前台运行方式 `openclaw gateway --port 18789` 观察日志与报错。

---

## LangBot - 即时通信机器人开发平台

LangBot 对接教程 — 面向飞书、钉钉、Telegram、Discord 等平台的 AI 聊天机器人开发框架。支持知识库、Agent、MCP，兼容 AI-Tkoens。

文档链接：https://ai-tokens.space/v1/zh/docs/apps/langbot/

LangBot 是一个开源的即时通信机器人开发平台，支持多种即时通信平台，如飞书、钉钉、微信、QQ、Telegram、Discord、Slack 等。接入全球主流的 AI 模型，支持知识库、Agent、MCP等多种 AI 应用能力，并完美适配 AI-Token。

- 官网地址：[https://langbot.app](https://langbot.app/)
- 下载地址：[https://github.com/langbot-app/LangBot/releases](https://github.com/langbot-app/LangBot/releases)
- 官方文档：[https://docs.langbot.app](https://docs.langbot.app/)
- 开源地址：[https://github.com/langbot-app/LangBot](https://github.com/langbot-app/LangBot)

### 接入 AI-Token

LangBot 支持接入本地部署的 AI-Token 和第三方使用 AI-Token 搭建的 AI-Token 服务。

#### 使用方式

1. 从 AI-Token 中获取 API key ![获取 API key](https://ai-tokens.space/v1/assets/media/c940e9b13afc58828fe4.png) 若是本地部署的 AI-Token 请自行配置 API 地址（可参考[容器网络连接](https://docs.langbot.app/zh/workshop/network-details.html)），若使用第三方 AI-Token 服务，可在页面上复制地址。注意，地址后需要添加`/v1`。
2. 在 LangBot 中添加模型，选择使用 AI-Token 供应商，填写对应的 API key 和 API 地址 ![添加 AI-Token 模型](https://ai-tokens.space/v1/assets/media/96028c9bf27a1ad8668e.png)
3. 在流水线中选择使用模型 ![选择模型](https://ai-tokens.space/v1/assets/media/75e8bd06492c3d84c203.png)
4. 在对话调试中对话或与绑定至流水线的机器人对话即可使用 ![对话](https://ai-tokens.space/v1/assets/media/8cb28ab3fa9f24c17b85.png) ![微信对话](https://ai-tokens.space/v1/assets/media/0f052bf1d79adf54fefe.png) 部署配置机器人请参考[部署机器人](https://docs.langbot.app/zh/deploy/platforms/readme.html)。

#### 使用 LangBot 知识库

LangBot 支持使用 AI-Token 的嵌入模型，并将其作为知识库的向量模型。

1. 在 LangBot 中添加嵌入模型，选择使用 AI-Token 供应商 ![添加嵌入模型](https://ai-tokens.space/v1/assets/media/1690df58633974879851.png)
2. 在新建知识库时选用嵌入模型 ![使用嵌入模型](https://ai-tokens.space/v1/assets/media/9f2ec6171c10252a0826.png)

更多使用方式请查看 LangBot 官方文档：[https://docs.langbot.app](https://docs.langbot.app/)

---

## AstrBot - Agent 聊天机器人

AstrBot 配置教程 — 将开源 Agent 聊天机器人平台对接 AI-Tkoens，为 QQ、飞书、钉钉、企业微信等即时通讯注入 AI 能力。

文档链接：https://ai-tokens.space/v1/zh/docs/apps/astrbot/

AstrBot 是一个开源的一站式 Agent 聊天机器人平台，可将大模型能力无缝接入 QQ、飞书、钉钉、企业微信等主流即时通讯软件，为个人、开发者和团队打造可靠、可扩展的对话式智能基础设施。无论是个人 AI 伙伴、智能客服、自动化助手，还是企业知识库，AstrBot 都能在你的即时通讯软件平台的工作流中快速构建生产可用的 AI 应用。

- 官方网站：[https://astrbot.app](https://astrbot.app)
- 官方文档：[https://docs.astrbot.app](https://docs.astrbot.app)
- 项目主页：[https://github.com/astrbotdevs/astrbot](https://github.com/astrbotdevs/astrbot)

### AI-Token 接入方法

AstrBot 支持接入 AI-Token 作为模型提供商，用户可以通过 AI-Token 来访问和使用各种 AI 模型服务。

#### 配置步骤

##### 获取 AI-Token API Key 密钥

在 AI-Token 注册并登录后，点击上方导航栏的「控制台」，点击「令牌管理」，然后点击「添加令牌」按钮，创建一个新的 API Key 密钥，选择适当的权限，然后点击「创建」。

![create-api-key](https://ai-tokens.space/v1/assets/media/0b55ce8c04ceb242db1a.png)

创建成功后，点击复制密钥按钮，复制生成的 API Key 密钥。

![copy-api-key](https://ai-tokens.space/v1/assets/media/afe6aa6ef62e8220e4ee.png)

##### 在 AstrBot 中配置 AI-Token 服务提供商

打开 AstrBot 管理面板，进入「模型提供商」页面，然后，点击「新增模型提供商」按钮。

AI-Token 完美地支持了 OpenAI Chat Completion 和 Responses 接口，我们点击 「OpenAI」，进入 OpenAI 提供商的配置页面。

在弹出的对话框中，将 API Base URL 设置为 AI-Token 的接口地址。请使用您自己部署的 AI-Tkoens，或确认服务方具备合法上游授权和合规义务的 AI-Tkoens 服务。如果您本地部署了 AI-Token，则填写本地地址，例如 `http://localhost:3000/v1`。不要将来源不明的 API 地址或密钥接入生产环境。

然后，将 API Key 填入「API Key」字段中，点击「保存」按钮。

![astrbot-provider-config](https://ai-tokens.space/v1/assets/media/59ceefdff9edf2151b3a.png)

然后点击保存，完成 AI-Token 提供商的配置。

##### 应用服务提供商

进入「配置文件」页面，找到模型一节，将「默认聊天模型」修改为刚刚创建的 AI-Token 提供商，点击「保存」按钮。

![apply](https://ai-tokens.space/v1/assets/media/7b8becf289cb2f6ce3f6.png)

至此，您已经成功配置了 AI-Token 作为 AstrBot 的模型提供商。现在，您可以通过 AstrBot 来访问和使用 AI-Token 提供的各种 AI 模型服务了。

---

## LunaTranslator - 开源 GalGame 翻译器

LunaTranslator 教程 — 开源 GalGame / 视觉小说翻译器，支持 HOOK、OCR 与 AI 翻译引擎。对接 AI-Tkoens 提升翻译质量。

文档链接：https://ai-tokens.space/v1/zh/docs/apps/luna-translator/

聊天设置选项

在 AI-Tkoens 控制台的系统设置->聊天设置中，可添加如下快捷选项，便于在令牌管理页一键填充到 LunaTranslator：

```
{ "LunaTranslator": "lunatranslator://llmapi/base64?data={cheryConfig}" }
```

LunaTranslator 是一款开源免费的视觉小说（GalGame）翻译器，致力于提供母语级别的视觉小说游玩体验。

- 项目地址：[https://github.com/HIllya51/LunaTranslator](https://github.com/HIllya51/LunaTranslator)
- 项目文档：[https://docs.lunatranslator.org](https://docs.lunatranslator.org/zh/README.html)

### 功能支持

- **HOOK** 主要使用HOOK提取游戏文本，几乎适配了所有的常见和冷门的视觉小说
- **内嵌翻译** 部分游戏还可以直接内嵌翻译到游戏中，以获取沉浸式体验
- **HOOK模拟器** 对NS/PSP/PSV/PS2上的大部分游戏，支持HOOK模拟器直接读取游戏文本
- **OCR** 内置较高精度的OCR模型，并支持许多其他在线&离线OCR引擎，以便灵活的读取任意文本
- **丰富的翻译接口** 支持几乎所有翻译引擎，包括大语言模型翻译、离线翻译等
- **语言学习** 支持日语分词及假名注音，支持AnkiConnect，支持Yomitan插件
- **语音合成** 支持大量在线&离线语音合成引擎
- **语音识别** 在Windows 10和Windows 11上，可以使用Windows语音识别。

### 安装方式

在 [LunaTranslator 文档- 下载 & 启动 & 更新](https://docs.lunatranslator.org/zh/README.html) 进行下载安装

### 在 LunaTranslator 接入 AI-Token

LunaTranslator 支持接入本地部署的 AI-Token。请使用您自己部署的 AI-Tkoens，或确认服务方具备合法上游授权和合规义务的 AI-Tkoens 服务。不要将来源不明的 API 地址或密钥接入生产环境。

#### 一键配置

1. 在 AI-Tkoens 控制台的`系统设置`->`聊天设置`中，添加如下快捷选项： `{ "LunaTranslator": "lunatranslator://llmapi/base64?data={cheryConfig}" }` ![add_config](https://ai-tokens.space/v1/assets/media/c160d9da2c6f03514ea8.png)
2. 在 **`AI-Token`** -> `控制台` -> `令牌管理` 选项卡中选择要使用在 LunaTranslator 的令牌，点击聊天按钮旁的下拉选项，选择 `LunaTranslator`,将会跳转到 LunaTranslator 并自动配置 API 地址与 API Key ![跳转到 LunaTranslator](https://ai-tokens.space/v1/assets/media/265767daa213c265404b.png)
3. 在 **`LunaTranslator`** -> `设置` -> `翻译设置` -> `大模型` 中将出现一个新增的大模型接口配置，点击编辑 ![设置api](https://ai-tokens.space/v1/assets/media/b116899f4968e02b8a5a.png)
4. 点击 **model** 下拉框旁的刷新按钮，获取 AI-Token 平台的模型列表，选择或输入模型名称，完成后点击确定保存 ![设置模型](https://ai-tokens.space/v1/assets/media/69bac004f6add19d077f.png)
5. 检查 **new_api** 大模型接口配置旁边的开关按钮是否打开，若未启用则启用接口即可开始使用 ![开启配置](https://ai-tokens.space/v1/assets/media/f294d9da378198c064a5.png)

#### 手动配置

1. 在 **`AI-Token`** -> `控制台` -> `令牌管理` 选项卡中获取 API Key ![获取 API Key](https://ai-tokens.space/v1/assets/media/6e7cfdf718d319fce4fe.png)
2. 在 **`LunaTranslator`** -> `设置` - `翻译设置` -> `大模型` 中选择添加 ![添加 API](https://ai-tokens.space/v1/assets/media/787b7f0730a4ca507344.png)
3. 复制 **大模型通用接口** 模板，新增接口 ![添加 API2](https://ai-tokens.space/v1/assets/media/3022880e6e5a44046453.png)
4. 在 **新增的接口** 中，填写对应的 API 地址和 API Key ![设置 API1](https://ai-tokens.space/v1/assets/media/376b176c3d5fda2ab9b2.png) ![设置 API2](https://ai-tokens.space/v1/assets/media/6b21c9d04bae76f86e10.png)
5. 点击 **model** 下拉框旁的刷新按钮，获取 AI-Token 平台的模型列表，选择或输入模型名称，完成后点击确定保存 ![设置 API3](https://ai-tokens.space/v1/assets/media/c39e83c5cbb2f53538a5.png)
6. 点击 **AI-Token** 旁边的开关按钮，启用接口即可开始使用 ![打开API](https://ai-tokens.space/v1/assets/media/2bcf5c2d503dca68196b.png)

更多使用方式请查看 LunaTranslator 官方文档:[LunaTranslator 文档 - 大模型翻译接口](https://docs.lunatranslator.org/zh/guochandamoxing.html)

---

## Claude Code

Claude Code 教程 — 将 Anthropic 的终端编程助手对接 AI-Tkoens。支持代码理解、多文件编辑，集成 VS Code 与 JetBrains IDE。

文档链接：https://ai-tokens.space/v1/zh/docs/apps/claude-code/

项目介绍

直接在你的终端中释放 Claude 的强大能力。瞬间搜索百万行代码库。将耗时数小时的工作流程化为一条命令。你的工具，你的工作流，你的代码库，以思维速度进化。

- 官方主页：[https://www.anthropic.com/claude-code](https://www.anthropic.com/claude-code)

### 效果演示

![introduce-01.webp](https://ai-tokens.space/v1/assets/media/98500a5fb7169fb0c133.jpg)

![introduce-02.webp](https://ai-tokens.space/v1/assets/media/2fdd2d5cd1f7f2d71179.webp)

#### 特性

| 功能分类 | 特性 |
| --- | --- |
| 代码理解 | 深度代码库分析，利用智能代理搜索理解项目结构和依赖 |
|  | 自动生成高层次代码概述，快速帮助用户理解代码库 |
| 代码编辑 | 支持多文件协同编辑，适用于复杂代码修改 |
|  | 提供符合项目模式和架构的实际可用代码建议 |
| 集成能力 | 支持在终端中直接运行，无需切换上下文 |
|  | 与VS Code和JetBrains IDE无缝集成，无需复制粘贴 |
| 代码生成和优化 | 自动生成代码、创建测试、修复错误，支持从概念到提交的完整流程 |
|  | 为代码生成和理解优化，结合Claude Opus 4等先进模型 |
| 安全与灵活性 | 改动需获得用户明确授权，文件和命令操作更安全 |
|  | 适应用户代码规范，支持自定义配置 |
| 工具链整合 | 支持与GitHub、GitLab等工具结合，实现自动化工作流程 |
|  | 与测试套件、构建系统集成，增强现有开发工具 |
| 跨平台与扩展 | 支持Windows、macOS、Linux操作系统 |
|  | 可配置运行在SDK或GitHub Actions中，灵活适配不同需求 |
| 主要应用场景 | 代码库入门和理解、新成员快速上手 |
|  | 代码问题修复与优化流程，从分析问题到提交PR |
|  | 项目代码重构与新功能实现 |
| 用户反馈亮点 | 提升日常开发效率，省去例行任务消耗的时间 |
|  | 处理复杂多步骤任务表现优异，扩展开发可能性 |

### AI 模型配置方法

#### Windows 端图文指引

##### 1.安装 Node.js 环境

Claude Code 需要 Node.js 环境才能运行。

Node.js 环境安装步骤

- 打开浏览器访问 [https://nodejs.org/](https://nodejs.org/)
- 点击 "LTS"版本进行下载（推荐长期支持版本）
- 下载完成后双击 .msi 文件
- 按照安装向导完成安装，保持默认设置即可

Windows 注意事项

- 建议使用 PowerShell 而不是 CMD
- 如果遇到权限问题，尝试以管理员身份运行
- 某些杀毒软件可能会误报，需要添加白名单

![windows-img-01.webp](https://ai-tokens.space/v1/assets/media/1d5286676cff02661eed.webp)

![windows-img-02.webp](https://ai-tokens.space/v1/assets/media/c61b8847825e369c752d.webp)

![windows-img-03.webp](https://ai-tokens.space/v1/assets/media/b4686c6e50a8ddf16ba4.webp)

![windows-img-04.webp](https://ai-tokens.space/v1/assets/media/a347e4c31daad591c3f8.webp)

![windows-img-05.webp](https://ai-tokens.space/v1/assets/media/9ad1c1243042d27ae868.webp)

验证安装是否成功

安装完成后，打开 PowerShell 或 CMD，输入以下命令：

```
node --version
npm --version
```

如果显示版本号，说明安装成功。

##### 2.安装 Git Bash

Windows 注意事项

Windows 环境下需要使用 Git Bash 安装 Claude code。安装完成后，环境变量设置和使用 Claude Code 仍然在普通的 PowerShell 或 CMD 中进行。

下载并安装 Git for Windows

- 访问 [https://git-scm.com/downloads/win](https://git-scm.com/downloads/win)
- 点击 "Download for Windows" 下载安装包
- 运行下载的 .exe 安装文件
- 在安装过程中保持默认设置，直接点击 "Next" 完成安装

![windows-img-06.webp](https://ai-tokens.space/v1/assets/media/26a7fb6cd10307bc0c1b.webp)

![windows-img-07.webp](https://ai-tokens.space/v1/assets/media/6545896c82958e4b827f.webp)

![windows-img-08.webp](https://ai-tokens.space/v1/assets/media/9c0837118a58f7196fb2.webp)

验证 Git Bash 安装

安装完成后，打开 Git Bash，输入以下命令验证：

```
git --version
```

如果显示版本号，说明安装成功。

##### 3.安装 Claude Code

安装 Claude Code

打开 PowerShell，运行以下命令：

```
npm install -g @anthropic-ai/claude-code
```

这个命令会从 npm 官方仓库下载并安装最新版本的 Claude Code。

![windows-img-09.webp](https://ai-tokens.space/v1/assets/media/efeb5bebd48859e8e187.webp)

将 ~/.local/bin 加入 PATH（仅当提示要求时）

```
[Environment]::SetEnvironmentVariable('Path', ([Environment]::GetEnvironmentVariable('Path','User') + ";$HOME\.local\bin"), 'User')
```

验证 Claude Code 安装

安装完成后，输入以下命令检查是否安装成功：

```
claude --version
```

如果显示版本号，恭喜你！Claude Code 已经成功安装了。

##### 4.设置环境变量

一键设置命令 (Windows 系统)

为了让 Claude Code 连接到你的中转服务，需要设置多个环境变量：

```
iex (irm 'https://raw.githubusercontent.com/QuantumNous/ai-tkoens-docs/refs/heads/main/helper/claude-cli-setup.ps1')
```

![windows-configure](https://ai-tokens.space/v1/assets/media/e9790532b38460c909a1.png)

##### 5.开始使用 Claude Code

现在你可以开始使用 Claude Code 了！

启动 Claude Code

打开 PowerShell，直接启动 Claude Code：

```
claude
```

在特定项目中使用：

```
# 进入你的项目目录
cd C:\path\to\your\project

# 启动 Claude Code
claude
```

![windows-img-11.webp](https://ai-tokens.space/v1/assets/media/b82309f26958bc94c040.webp)

![windows-img-12.webp](https://ai-tokens.space/v1/assets/media/15e62fe8c9a4b60a01e3.webp)

![windows-img-13.webp](https://ai-tokens.space/v1/assets/media/518ea773d5bbac7f0803.webp)

![windows-img-14.webp](https://ai-tokens.space/v1/assets/media/8ce967edc1b8280f37e5.webp)

![windows-img-15.webp](https://ai-tokens.space/v1/assets/media/6e20e18ca3907d1652fb.webp)

选择模型

输入命令：

```
/model
```

按 Enter 进入，选择模型，通常使用默认设置即可。

![windows-img-16.webp](https://ai-tokens.space/v1/assets/media/914263bd2383bf52a8b6.webp)

![windows-img-17.webp](https://ai-tokens.space/v1/assets/media/8e1991dbe330cc0c9c27.webp)

> 注意：设置环境变量修改后，使用所有模型（包括官方预设模型）均调用自定义接入点，而不使用官方账号额度。

#### MacOS 端图文指引

##### 1.安装 Claude Code CLI

打开终端

![macos-img-01.webp](https://ai-tokens.space/v1/assets/media/90b8a78fc1b52a494cec.webp)

安装 Claude Code

打开终端，运行以下命令：

```
curl -fsSL https://claude.ai/install.sh | bash
```

可选项：出现提示后运行提供的命令

```
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
```

![macos-img-02.webp](https://ai-tokens.space/v1/assets/media/ebeaaa2e47cdd866ff18.webp)

##### 2.设置环境变量

为了让 Claude Code 连接到第三方中转服务，需要设置环境变量：

一键设置 Claude Code 环境变量

输入命令：

```
curl -fsSL https://raw.githubusercontent.com/QuantumNous/ai-tkoens-docs/refs/heads/main/helper/claude-cli-setup.sh | bash
```

![macos-configure](https://ai-tokens.space/v1/assets/media/9453fabeaf5be07aedc1.png)

验证 Claude Code 安装

安装完成后，输入以下命令检查是否安装成功：

```
claude --version
```

如果显示版本号，恭喜你！Claude Code 已经成功安装了。

##### 3.开始使用 Claude Code

现在你可以开始使用 Claude Code 了！

启动 Claude Code

直接启动 Claude Code：

```
claude
```

在特定项目中使用：

```
# 进入你的项目目录
cd /path/to/your/project

# 启动 Claude Code
claude
```

![macos-img-04.webp](https://ai-tokens.space/v1/assets/media/a8edc9c993740846638d.webp)

![macos-img-05.webp](https://ai-tokens.space/v1/assets/media/a736298d529313a3ac50.webp)

![macos-img-06.webp](https://ai-tokens.space/v1/assets/media/68d485b3de4d4d3e395d.webp)

![macos-img-07.webp](https://ai-tokens.space/v1/assets/media/d446c399722c6733f6c8.webp)

![macos-img-08.webp](https://ai-tokens.space/v1/assets/media/7d7dcbe858e1d8553939.webp)

选择模型 (可选)

输入命令：

```
/model
```

按 Enter 进入，选择官方模型，通常使用默认模型即可。

![macos-img-09.webp](https://ai-tokens.space/v1/assets/media/7b22b8cf09b3e878bbe9.webp)

![macos-img-10.webp](https://ai-tokens.space/v1/assets/media/65707c4d4fba4c2b3ed0.webp)

![macos-img-11.webp](https://ai-tokens.space/v1/assets/media/afd30362c309a9cf9b14.webp)

> 注意：设置环境变量修改 ANTHROPIC_BASE_URL 后，使用所有模型（包括官方预设模型）均调用自定义接入点，而不使用官方账号额度。

##### 4.macOS 常见问题解决

macOS 安全设置阻止运行

如果系统阻止运行 Claude Code：

- 打开"系统偏好设置" → "安全性与隐私"
- 点击"仍要打开"或"允许"
- 或者在 Terminal 中运行：`sudo spctl --master-disable`

#### Linux 端图文指引

##### 1.安装 Claude Code

![linux-img-01.webp](https://ai-tokens.space/v1/assets/media/b06b19404fc86f26a7f0.webp)

安装 Claude Code

打开终端，运行以下命令：

```
curl -fsSL https://claude.ai/install.sh | bash
```

如果遇到权限问题，可以使用 sudo：

```
sudo curl -fsSL https://claude.ai/install.sh | bash
```

![linux-img-03.webp](https://ai-tokens.space/v1/assets/media/06a20b8b45fcc18e3ce3.webp)

验证 Claude Code 安装

安装完成后，输入以下命令检查是否安装成功：

```
claude --version
```

如果显示版本号，恭喜你！Claude Code 已经成功安装了。

##### 2.设置环境变量

为了让 Claude Code 连接到你的中转服务，需要设置两个环境变量：

一键修改环境变量

输入命令：

```
curl -fsSL https://raw.githubusercontent.com/QuantumNous/ai-tkoens-docs/refs/heads/main/helper/claude-cli-setup.sh | bash
```

![macos-configure](https://ai-tokens.space/v1/assets/media/9453fabeaf5be07aedc1.png)

##### 3.开始使用 Claude Code

现在你可以开始使用 Claude Code 了！

启动 Claude Code

直接启动 Claude Code：

```
claude
```

在特定项目中使用：

```
# 进入你的项目目录
cd /path/to/your/project

# 启动 Claude Code
claude
```

![linux-img-03.webp](https://ai-tokens.space/v1/assets/media/06a20b8b45fcc18e3ce3.webp)

![linux-img-04.webp](https://ai-tokens.space/v1/assets/media/8d753045604f6dc1611c.webp)

![linux-img-05.webp](https://ai-tokens.space/v1/assets/media/a9a69915a97b0eecc91a.webp)

选择模型

输入命令：

```
/model
```

按 Enter 进入，选择官方模型，通常使用默认模型即可。

![linux-img-06.webp](https://ai-tokens.space/v1/assets/media/7c3594526f4304b7d85e.webp)

![linux-img-07.webp](https://ai-tokens.space/v1/assets/media/d13173aa1f97934fb104.webp)

![linux-img-08.webp](https://ai-tokens.space/v1/assets/media/10ee475891f9ee23a85e.webp)

![linux-img-09.webp](https://ai-tokens.space/v1/assets/media/4c2bc02aefeb7cb3edba.webp)

> 注意：设置环境变量修改 ANTHROPIC_BASE_URL 后，使用所有模型（包括官方预设模型）均调用自定义接入点，而不使用官方账号额度。

##### 4.Linux 常见问题解决

缺少依赖库

某些 Linux 发行版需要安装额外依赖：

```
# Ubuntu/Debian
sudo apt install build-essential

# CentOS/RHEL
sudo dnf groupinstall "Development Tools"
```

环境变量不生效

检查以下几点：

- 确认修改了正确的配置文件（`.bashrc` 或 `.zshrc`）
- 重新启动终端或运行 `source ~/.bashrc`
- 验证设置：`echo $ANTHROPIC_BASE_URL`

---

## OpenAI Codex CLI

OpenAI Codex CLI 安装教程 — 在 Windows、macOS、Linux 上安装终端 AI 编程助手，对接 AI-Tkoens。支持沙箱策略与原子补丁编辑。

文档链接：https://ai-tokens.space/v1/zh/docs/apps/codex-cli/

项目介绍

Codex CLI 是一个来自 OpenAI 的编码代理，可在您的计算机上本地运行。

- 官方主页：[https://chatgpt.com/codex](https://chatgpt.com/codex)
- 项目主页：[https://github.com/openai/codex](https://github.com/openai/codex)

### 效果演示

![introduce-01.webp](https://ai-tokens.space/v1/assets/media/a43e5a051b342ebac614.webp)

#### 特性

| 功能分类 | 特性 |
| --- | --- |
| 终端式编码助手 | Codex CLI 是一个基于终端的交互式编码助理，用于在命令行中编辑代码、生成补丁并运行命令。 |
| 工具驱动架构 | 提供 apply_patch 、 shell 、 update_plan 、 multi_tool_use 等工具，用于对仓库文件和操作进行可控修改。 |
| 原子补丁编辑 | 使用专门的补丁格式通过 apply_patch 原子地添加/更新/删除文件，便于审计与回滚。 |
| 沙箱与审批 | 支持沙箱策略（如 workspace-write 、 read-only ）和审批模式（ on-request 、 on-failure 、 never ），控制写入与网络访问权限。 |
| 计划追踪 | update_plan 用于列出步骤并跟踪状态，要求始终只有一个 in_progress 步骤以保持明确进度。 |
| 交互规范 | 在重要操作前发送简短前导说明，保持语气友好、简洁并提供进度更新。 |
| 安全约束 | 遵循严格规则（不随意更改无关文件、不添加版权头、不执行破坏性命令），需要用户批准敏感操作。 |
| 测试与格式化 | 推荐在修改后运行相关测试与格式化工具，但不负责修复与当前任务无关的问题。 |
| 输出与风格 | 最终输出遵循 CLI 渲染规范（例如 ** 标题、反引号表示路径/命令），保持可扫描的简洁结构。 |
| 并行执行 | 支持通过 multi_tool_use.parallel 并行运行多个工具以提升效率。 |

### AI 模型配置方法

#### Windows 端图文指引

##### 1.打开终端

![windows_open_terminal](https://ai-tokens.space/v1/assets/media/a0a876218c7225d27b0e.png)

##### 2.安装 WSL

为在 Windows 上获得最佳性能，请安装并使用 Windows Subsystem for Linux (WSL2)。

安装 WSL2，重启 Windows 计算机

```
wsl --install
```

安装完成后重启 Windows 计算机。

Windows 注意事项

- 建议使用 PowerShell 而不是 CMD
- 如果遇到权限问题，尝试以管理员身份运行
- 某些杀毒软件可能会误报，需要添加白名单

![windows-img-03.webp](https://ai-tokens.space/v1/assets/media/5b1fda613fea7b9cf767.webp)

下载 Node Version Manager (NVM)

```
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
```

![windows-img-04.webp](https://ai-tokens.space/v1/assets/media/cd2452ceae129245c3bb.webp)

NVM 安装 Node.js 22

标签栏新开一个 PowerShell 窗口，打开 WSL：

```
wsl
```

安装 Node.js（版本号有时效性，请根据 [OpenAI 官网](https://developers.openai.com/codex/windows) 要求安装对应版本）：

```
nvm install 22
```

![windows-img-05.webp](https://ai-tokens.space/v1/assets/media/48494868d14884c215a6.webp)

##### 3.安装 Codex CLI

安装 Codex CLI

```
npm i -g @openai/codex
```

这个命令会从 npm 官方仓库下载并安装最新版本的 Codex CLI。

![windows-img-06.webp](https://ai-tokens.space/v1/assets/media/a24f4693cdf8dc9b0088.webp)

##### 4.修改配置文件

一键修改 Codex CLI 配置文件

```
iex (irm 'https://raw.githubusercontent.com/QuantumNous/ai-tkoens-docs/refs/heads/main/helper/codex-cli-setup.ps1')
```

![windows-configure](https://ai-tokens.space/v1/assets/media/ca453aaf257dc2932328.png)

##### 5.开始使用 Codex CLI

现在你可以开始使用 Codex CLI 了！

启动 Codex CLI

启动 WSL2：

```
wsl
```

直接启动 Codex CLI：

```
codex
```

在特定项目中使用：

```
cd mnt/c/path/to/your/project
codex
```

按 Enter 启动 Codex CLI。

![windows-img-09.webp](https://ai-tokens.space/v1/assets/media/fe4b25884b065ef8ed16.webp)

![windows-img-10.webp](https://ai-tokens.space/v1/assets/media/979c09c323fc7f0ce12d.webp)

> 设置 Codex CLI 的权限：1. 允许 Codex 直接修改文件；2. Codex 修改文件需要手动授权

选择模型

```
/model
```

![windows-img-11.webp](https://ai-tokens.space/v1/assets/media/55e49b7d7a9af4d6628b.webp)

![windows-img-12.webp](https://ai-tokens.space/v1/assets/media/064f0ce4343c2bb77ca0.webp)

![windows-img-13.webp](https://ai-tokens.space/v1/assets/media/b94ee12586e28f98d162.webp)

![windows-img-14.webp](https://ai-tokens.space/v1/assets/media/6d8fe4a2731ae87cc357.webp)

> 注意：修改接口地址后，使用所有模型（包括官方预设模型）均调用您配置的、合法授权的自有或组织接入点。请使用您自己部署的 AI-Tkoens，或确认服务方具备合法上游授权和合规义务的 AI-Tkoens 服务。不要将来源不明的 API 地址或密钥接入生产环境。

#### macOS 端图文指引

##### 1.安装 Homebrew (已安装请跳过)

Homebrew 是 macOS 缺失的软件包的管理器。

官网：[https://brew.sh](https://brew.sh)

![macos-img-01.webp](https://ai-tokens.space/v1/assets/media/90b8a78fc1b52a494cec.webp)

安装 Homebrew

```
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

![macos-img-02.webp](https://ai-tokens.space/v1/assets/media/10b143e179b6a076e058.webp)

![macos-img-03.webp](https://ai-tokens.space/v1/assets/media/b168f33bf316997ebfa7.webp)

![macos-img-04.webp](https://ai-tokens.space/v1/assets/media/cb487deb22fcb92c8d6c.webp)

##### 2.安装 Node.js 环境

Node.js 环境安装步骤

更新 Homebrew：

```
brew update
```

安装 Node.js：

```
brew install node
```

macOS 注意事项

- 如果遇到权限问题，可能需要使用 `sudo`
- 首次运行可能需要在系统偏好设置中允许
- 建议使用 Terminal 或 iTerm2

![macos-img-05.webp](https://ai-tokens.space/v1/assets/media/898701a3c25eac81b4ac.jpg)

![macos-img-06.webp](https://ai-tokens.space/v1/assets/media/2b94a038f47e841a7571.webp)

验证安装是否成功

安装完成后，打开终端，输入以下命令：

```
node --version
npm --version
```

如果显示版本号，说明安装成功。

##### 3.安装 Codex CLI

安装 Codex CLI

打开终端，运行以下命令：

```
# 全局安装 Codex CLI
npm install -g @openai/codex
```

如果遇到权限问题，可以使用 sudo：

```
sudo npm install -g @openai/codex
```

![macos-img-07.webp](https://ai-tokens.space/v1/assets/media/8d9bf3db6aa672f50a3d.webp)

验证 Codex CLI 安装

安装完成后，输入以下命令检查是否安装成功：

```
codex --version
```

如果显示版本号，恭喜你！Codex CLI 已经成功安装了。

##### 4.修改配置文件

一键修改 Codex CLI 配置文件

```
curl -fsSL https://raw.githubusercontent.com/QuantumNous/ai-tkoens-docs/refs/heads/main/helper/codex-cli-setup.sh | bash
```

![macos-configure](https://ai-tokens.space/v1/assets/media/53a16c40e3ddeb897514.png)

##### 5.开始使用 Codex CLI

现在你可以开始使用 Codex CLI 了！

启动 Codex CLI

直接启动 Codex CLI：

```
codex
```

在特定项目中使用：

```
cd /path/to/your/project
codex
```

按 Enter 启动 Codex CLI。

![macos-img-09.webp](https://ai-tokens.space/v1/assets/media/db95e824b1ce7e333b06.webp)

![macos-img-10.webp](https://ai-tokens.space/v1/assets/media/d2e876ed7ef54d792a46.webp)

> 设置 Codex CLI 的权限：1. 允许 Codex 直接修改文件；2. Codex 修改文件需要手动授权

![macos-img-11.webp](https://ai-tokens.space/v1/assets/media/207bf59f235965b50140.webp)

![macos-img-12.webp](https://ai-tokens.space/v1/assets/media/dcd66dc30b303b457c76.webp)

![macos-img-13.webp](https://ai-tokens.space/v1/assets/media/1986ef3b218d8f84f6f5.webp)

![macos-img-14.webp](https://ai-tokens.space/v1/assets/media/d160f4a6f070e24273a7.webp)

> 注意：修改接口地址后，使用所有模型（包括官方预设模型）均调用您配置的、合法授权的自有或组织接入点。

##### 6.macOS 常见问题解决

安装时提示权限错误

尝试以下解决方法：

- 使用 `sudo` 安装：`sudo npm install -g @openai/codex`
- 或者配置 `npm` 使用用户目录：`npm config set prefix ~/.npm-global`

macOS 安全设置阻止运行

如果系统阻止运行 Codex CLI：

- 打开"系统偏好设置" → "安全性与隐私"
- 点击"仍要打开"或"允许"
- 或者在 Terminal 中运行：`sudo spctl --master-disable`

#### Linux 端图文指引

##### 1.安装 Node.js 环境

Codex CLI 需要 Node.js 环境才能运行。

Node.js 环境安装步骤

添加 NodeSource 仓库：

```
sudo curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
```

安装 Node.js：

```
sudo apt-get install -y nodejs
```

Linux 注意事项

- 某些发行版可能需要安装额外的依赖
- 如果遇到权限问题，使用 sudo
- 确保你的用户在 npm 的全局目录有写权限

![linux-img-01.webp](https://ai-tokens.space/v1/assets/media/58dedc7bfa456311c4e0.webp)

![linux-img-02.webp](https://ai-tokens.space/v1/assets/media/4fcdfd2f014e93577c1f.webp)

验证安装是否成功

安装完成后，打开终端，输入以下命令：

```
node --version
npm --version
```

如果显示版本号，说明安装成功。

##### 2.安装 Codex CLI

安装 Codex CLI

打开终端，运行以下命令：

```
# 全局安装 Codex CLI
npm install -g @openai/codex
```

如果遇到权限问题，可以使用 sudo：

```
sudo npm install -g @openai/codex
```

![linux-img-03.webp](https://ai-tokens.space/v1/assets/media/c48a530436804ced7512.webp)

验证 Codex CLI 安装

安装完成后，输入以下命令检查是否安装成功：

```
codex --version
```

如果显示版本号，恭喜你！Codex CLI 已经成功安装了。

##### 3.修改配置文件

一键修改 Codex CLI 配置文件

```
curl -fsSL https://raw.githubusercontent.com/QuantumNous/ai-tkoens-docs/refs/heads/main/helper/codex-cli-setup.sh | bash
```

![macos-configure](https://ai-tokens.space/v1/assets/media/53a16c40e3ddeb897514.png)

##### 4.开始使用 Codex CLI

现在你可以开始使用 Codex CLI 了！

启动 Codex CLI

直接启动 Codex CLI：

```
codex
```

在特定项目中使用：

```
# 进入你的项目目录
cd /path/to/your/project

# 启动 Codex CLI
codex
```

按 Enter 启动 Codex CLI。

![linux-img-05.webp](https://ai-tokens.space/v1/assets/media/5401bb7a8a93c8eb9a33.webp)

![linux-img-06.webp](https://ai-tokens.space/v1/assets/media/cedac802c29b62ceb916.webp)

> 设置 Codex CLI 的权限：1. 允许 Codex 直接修改文件；2. Codex 修改文件需要手动授权

![linux-img-07.webp](https://ai-tokens.space/v1/assets/media/a37d0115018c13a99887.webp)

![linux-img-08.webp](https://ai-tokens.space/v1/assets/media/532720e325b05738c457.webp)

![linux-img-09.webp](https://ai-tokens.space/v1/assets/media/5152e1ee596d17d8ca9f.webp)

![linux-img-10.webp](https://ai-tokens.space/v1/assets/media/8412e648e722c8622ed4.webp)

> 注意：修改接口地址后，使用所有模型（包括官方预设模型）均调用您配置的、合法授权的自有或组织接入点。

##### 5.Linux 常见问题解决

安装时提示权限错误

尝试以下解决方法：

- 使用 `sudo` 安装：`sudo npm install -g @openai/codex`
- 或者配置 `npm` 使用用户目录：`npm config set prefix ~/.npm-global`
- 然后添加到 PATH：`export PATH=~/.npm-global/bin:$PATH`

缺少依赖库

某些 Linux 发行版需要安装额外依赖：

```
# Ubuntu/Debian
sudo apt install build-essential

# CentOS/RHEL
sudo dnf groupinstall "Development Tools"
```

---

## Factory Droid CLI

Factory Droid CLI 教程 — 安装并配置 AI 软件工程助手，对接 AI-Tkoens。从规划到测试的全流程自动化开发。

文档链接：https://ai-tokens.space/v1/zh/docs/apps/factory-droid-cli/

项目介绍

Droid CLI 是由 Factory AI 开发的命令行工具，旨在作为 AI 软件工程代理运行。它允许用户通过终端与各种大型语言模型交互，构建、调试和重构代码，甚至创建完整的应用程序。

- 官方主页：[https://factory.ai/product/cli](https://factory.ai/product/cli)
- 官方文档：[https://docs.factory.ai/cli/getting-started/quickstart](https://docs.factory.ai/cli/getting-started/quickstart)

### 效果演示

![droid.webp](https://ai-tokens.space/v1/assets/media/ceb25edf8ae9144d4771.webp)

#### 特性

| 类别 | 特性 | 价值/能力 | 示例/备注 |
| --- | --- | --- | --- |
| 快速上手与 CLI | 30 秒安装；在项目目录中启动 droid 交互会话；支持 macOS/Linux 与 Windows | 快速接入当前工程，无需新工具 | Windows 安装： irm https://app.factory.ai/cli/windows \| iex ；启动： droid |
| 端到端特性开发 | 从规划到实现到测试的全流程自动化；透明的评审流程 | 提升交付速度，保持人类把控 | 原生 diff 查看与批准流程（见"透明与可控"） |
| 代码库深度理解 | 融合组织在代码库、文档、Issue 追踪中的共享知识；上下文感知，效果随时间提升 | 更准确的建议与改动 | 持续利用跨仓库与文档的知识 |
| 工程系统集成 | 原生集成 Jira、Notion、Slack 等工具；开发工作与团队流程保持同步 | 减少工具切换与信息孤岛 | "等"表示还有更多集成 |
| 生产级自动化 | 工作流可在本地与 CI/CD 复用；企业级安全与合规内建 | 一致性与可审计性 | 适配流水线与企业环境 |
| 企业级能力 | 私有部署选项、SOC-2 合规、空气隔离（air-gapped）环境 | 满足安全与合规要求 | 以安全与质量优先 |
| 现有工具增强 | 在终端、IDE 与既有开发环境中工作；无需切换编辑器或学习新界面 | 保持现有工作习惯、低迁移成本 | 与熟悉工具深度集成 |
| 透明与可控 | 每个决策可见且可审阅；对代码变更保持完全监督；原生 diff 查看与审批工作流 | 降低风险、提升可控性 | 审核友好、可追踪 |
| 模型灵活性 | 不锁定单一 AI 提供商；按任务选择最佳模型；组织级一致行为与记忆 | 在性能与成本间做最优选择 | 支持多模型路由 |
| 下一步与资源 | Quickstart、Common Use Cases、IDE Integration、Configuration、AGENTS.md | 便于落地与实践 | 见页面 "Next steps/Additional resources" |

### AI 模型配置方法

#### Windows 端图文指引

##### 1.打开终端

![windows_open_terminal](https://ai-tokens.space/v1/assets/media/a0a876218c7225d27b0e.png)

##### 2.安装 Factory Droid CLI

官方一键安装命令：

一键安装命令

```
irm https://app.factory.ai/cli/windows | iex
```

![windows-install](https://ai-tokens.space/v1/assets/media/d5522db15a0ad0162ba6.webp)

##### 3.修改配置文件

Droid CLI 使用第三方 API 需要修改配置文件。

![windows-configure.webp](https://ai-tokens.space/v1/assets/media/7e387f02ef521089d33a.png)

修改环境变量

```
iex (irm 'https://raw.githubusercontent.com/QuantumNous/ai-tkoens-docs/refs/heads/main/helper/factory-cli-setup.ps1')
```

##### 4.开始使用 Droid CLI

现在你可以开始使用 Droid CLI 了！

启动 Droid CLI

直接启动 Droid CLI：

```
droid
```

在特定项目中使用：

```
# 进入你的项目目录
cd C:\path\to\your\project

# 启动 Droid CLI
droid
```

按 Enter 启动 Droid CLI。

Droid CLI 要求用户登录官方账号（免费）后才能使用。

##### 5.Windows 常见问题解决

安装时提示 permission denied 错误

这通常是权限问题，尝试以下解决方法：

- 以管理员身份运行 PowerShell
- 或者配置 `npm` 使用用户目录：`npm config set prefix %APPDATA%\npm`

PowerShell 执行策略错误

如果遇到执行策略限制，运行：

```
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```

#### macOS/Linux 端图文指引

##### 1.安装 Droid CLI

安装 Droid CLI

打开终端，运行以下命令：

```
curl -fsSL https://app.factory.ai/cli | sh
```

![macos-open-terminal](https://ai-tokens.space/v1/assets/media/d2b368fabb69766ee005.webp)

![macos-img-02.webp](https://ai-tokens.space/v1/assets/media/8002369585dd588e9a03.webp)

按照安装提示修改环境变量（直接复制安装提示代码）：

Linux 视情况选择 `~/.bashrc` 或 `~/.zshrc`

Droid CLI 环境变量 (仅作示例)

```
echo 'export PATH=/Users/修改此处/.local/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
```

##### 2.修改配置文件

Droid CLI 使用第三方 API 需要修改配置文件。

一键修改配置文件

```
curl -fsSL https://raw.githubusercontent.com/QuantumNous/ai-tkoens-docs/refs/heads/main/helper/factory-cli-setup.sh | bash
```

![macos-img-03.webp](https://ai-tokens.space/v1/assets/media/6ae18992164743ec55f5.png)

##### 3.开始使用 Droid CLI

现在你可以开始使用 Droid CLI 了！

启动 Droid CLI

直接启动 Droid CLI：

```
droid
```

在特定项目中使用：

```
# 进入你的项目目录
cd /path/to/your/project

# 启动 Droid CLI
droid
```

按 Enter 启动 Droid CLI。

> Droid CLI 要求用户登录官方账号（免费）后才能使用。

---

# 六、Skills 配置与使用

## Skills

AI-Tkoens 官方 AI 编辑器 Skill 插件一览，支持 Claude Code、Codex 与 OpenClaw（龙虾）。可直接在 AI 编码助手中管理模型、令牌、分组与余额，并提问 AI-Tkoens 的使用问题。

文档链接：https://ai-tokens.space/v1/zh/docs/skills/

### 概述

**Skills** 是一种轻量级扩展协议，让 AI 编辑器（如 Claude Code、Codex、OpenClaw（龙虾）、Cursor、Windsurf 等）能够在编码环境内直接与 AI-Tkoens 交互，无需切换到浏览器或管理面板。

AI-Tkoens Skills 现已支持在 Claude Code、Codex、OpenClaw（龙虾）等工具中直接执行查询模型、管理令牌、查看余额，以及提问 AI-Tkoens 使用问题等操作。

AI-Tkoens 目前提供以下 Skills：

#### AI-Token

用户级 Skill — 在 Claude Code、Codex、OpenClaw（龙虾）中查询模型、管理令牌、查看分组和余额，并直接提问 AI-Tkoens 使用问题。

#### AI-Token-admin（敬请期待）

管理员级 Skill — 渠道管理、用户管理、系统配置等运维操作。面向 AI-Tkoens 管理员。

### 支持的 AI 编辑器

所有 Skills 均可在以下 AI 编码工具中使用：

| AI 编辑器 / 编码助手 | 类型 | 备注 |
| --- | --- | --- |
| Claude Code | 终端 AI 编程助手 | Anthropic 官方 CLI |
| OpenClaw | 自托管 AI 助手平台 | 支持 Skills，可在对话中直接调用 /AI-Token 指令 |
| Cursor | AI 原生代码编辑器 | 基于 VS Code |
| Windsurf | AI 代码编辑器 | Codeium 出品 |
| Cline | VS Code AI 扩展 | 开源 AI 编码代理 |
| Codex CLI | 终端 AI 编程助手 | OpenAI 官方 CLI |

> 任何支持 Skills 协议的 AI 工具都可以使用 AI-Tkoens Skills。

### 了解更多

- GitHub 仓库：[github.com/QuantumNous/skills](https://github.com/QuantumNous/skills)
- AI-Tkoens 官网：[ai-tokens.space](https://ai-tokens.space)

---

## AI-Token

AI-Token 是 AI-Tkoens 官方用户级 Skill 插件，支持 Claude Code、Codex 和 OpenClaw（龙虾）。通过自然语言指令在 AI 编码助手内查询模型、管理令牌、查看分组和余额，并直接提问 AI-Tkoens 的使用问题。

文档链接：https://ai-tokens.space/v1/zh/docs/skills/newapi/

什么是 AI-Token-skills？

**AI-Token-skills** 是 AI-Tkoens 官方推出的 AI 编辑器 Skill 插件。Skill 是一种轻量级扩展协议，让 AI 编码助手（如 Claude Code、Codex、OpenClaw（龙虾）、Cursor、Windsurf、Cline 等）能够在编辑器内**直接调用 AI-Tkoens 接口**，完成模型查询、令牌管理、余额查看，以及提问 AI-Tkoens 部署、配置和 API 调用等使用问题，实现真正的"编码即运维"工作流。

- GitHub 仓库：[github.com/QuantumNous/skills](https://github.com/QuantumNous/skills)

现在也支持在 OpenClaw（龙虾）中使用，你可以直接在对话工作流里调用 `/AI-Token` 指令完成模型查询、令牌管理、余额查看，也能直接提问 AI-Tkoens 的使用问题。

### 为什么使用 Skills

在日常 AI 开发中，开发者经常需要在编辑器和 AI-Tkoens 管理面板之间反复切换：查看可用模型、创建 API 令牌、检查余额、调整分组配额……这些操作打断了编码流程。

**AI-Token-skills 解决的问题：**

- **零切换**：在 Claude Code、Codex、OpenClaw（龙虾）等 AI 编码助手中直接输入自然语言指令，无需打开浏览器或管理后台
- **内置问答**：可直接提问 AI-Tkoens 的部署、配置、分组、模型调用格式等使用问题，快速获得帮助
- **安全优先**：密钥永不明文显示，令牌复制与注入均通过安全通道完成（`sk-` 开头的密钥绝不会出现在终端或日志中）
- **即装即用**：一行 `npx` 命令完成安装，自动检测运行时环境（Bun / Node.js / Deno）
- **多编辑器兼容**：支持所有实现 Skills 协议的 AI 编辑器和编码助手

### 支持的 AI 编辑器

AI-Token-skills 可在以下 AI 编码工具中使用：

| AI 编辑器 / 编码助手 | 类型 | 备注 |
| --- | --- | --- |
| Claude Code | 终端 AI 编程助手 | Anthropic 官方 CLI |
| OpenClaw | 自托管 AI 助手平台 | 支持 Skills，可在对话中直接调用 /AI-Token 指令 |
| Cursor | AI 原生代码编辑器 | 基于 VS Code |
| Windsurf | AI 代码编辑器 | Codeium 出品 |
| Cline | VS Code AI 扩展 | 开源 AI 编码代理 |
| Codex CLI | 终端 AI 编程助手 | OpenAI 官方 CLI |

> 任何支持 Skills 协议的 AI 工具都可以使用 AI-Token-skills。

### 功能与指令一览

以下是 AI-Token-skills 提供的全部指令。这些指令通过 AI-Tkoens REST API 执行，支持查询和管理 AI-Tkoens 实例中的各类资源。

#### 查询类指令

| 指令 | 说明 | 用途 |
| --- | --- | --- |
| /AI-Token models | 列出可用 AI 模型 | 查看当前 AI-Tkoens 实例中配置的所有模型（OpenAI、Claude、Gemini 等） |
| /AI-Token groups | 列出用户分组 | 查看账户所属的分组及其配额、倍率设置 |
| /AI-Token balance | 查看账户余额 | 实时查询当前用户的账户余额和用量 |

#### 令牌管理指令

| 指令 | 说明 | 用途 |
| --- | --- | --- |
| /AI-Token tokens | 列出 API 令牌 | 查看所有已创建的令牌（密钥以掩码形式显示，如 sk-reHR**********OspA ） |
| /AI-Token create-token <name> [--group=xxx] | 创建新 API 令牌 | 为不同应用或项目创建独立的 API 密钥 |
| /AI-Token switch-group <token_id> <group> | 切换令牌分组 | 更改令牌所属的分组以调整模型访问权限和倍率 |
| /AI-Token copy-token <token_id> | 复制密钥到剪贴板 | 安全地将真实密钥复制到系统剪贴板（密钥不会显示在终端中） |
| /AI-Token apply-token <token_id> <file> | 注入密钥到配置文件 | 将令牌密钥安全写入项目配置文件（如 .env ），使用占位符替换机制 |

#### 帮助指令

| 指令 | 说明 | 用途 |
| --- | --- | --- |
| /AI-Token help <question> | 提问关于 AI-Tkoens 的问题 | 获取 AI-Tkoens 部署、配置、API 调用格式等帮助信息 |

### 安装与配置

#### 安装 AI-Token-skills

使用 `npx` 一键安装：

```
npx skills add https://github.com/QuantumNous/skills --skill AI-Token
```

该命令会从 GitHub 仓库拉取最新的 Skill 定义并安装到你的编辑器环境。

#### 设置环境变量

AI-Token-skills 需要三个环境变量来连接你的 AI-Tkoens 实例。推荐在终端配置文件中设置：

```
# ~/.bashrc 或 ~/.zshrc
export AI-Token_BASE_URL=https://<your-AI-Token-domain>
export AI-Token_ACCESS_TOKEN=your-access-token
export AI-Token_USER_ID=1
```

| 变量 | 说明 | 示例 |
| --- | --- | --- |
| AI-Token_BASE_URL | AI-Tkoens 服务地址 | https://api.example.com |
| AI-Token_ACCESS_TOKEN | 管理员或用户的访问令牌 | 从「个人设置 → 账户管理 → 安全设置 → 系统访问令牌」获取 |
| AI-Token_USER_ID | 用户 ID | 1 （管理员默认为 1） |

也可以在项目根目录创建 `.env` 文件。请确保 `.env` 已加入 `.gitignore`，防止密钥泄露。

#### 开始使用

安装完成后，在支持 Skills 的 AI 编辑器中直接输入 `/AI-Token` 指令即可。例如：

- 输入 `/AI-Token models` 查看可用模型列表
- 输入 `/AI-Token balance` 查看当前余额
- 输入 `/AI-Token create-token my-app` 创建一个名为 `my-app` 的新令牌
- 输入 `/AI-Token help 如何配置模型分组和令牌？` 直接提问 AI-Tkoens 的使用问题
- 在 OpenClaw（龙虾）中同样可以直接调用 `/AI-Token models`、`/AI-Token balance` 等指令

### 运行环境要求

AI-Token-skills 需要以下任一 JavaScript 运行时（Skill 启动时自动检测）：

| 运行时 | 版本要求 | 推荐程度 |
| --- | --- | --- |
| Bun | 最新版 | 推荐（最快） |
| Node.js | >= 18 | 广泛支持 |
| Deno | 最新版 | 可选 |

### 安全机制

AI-Token-skills 内置多层安全防护，保护你的 API 密钥安全：

- 令牌列表仅显示**掩码密钥**（如 `sk-reHR**********OspA`），真实密钥不会出现在终端输出中
- `copy-token` 仅将密钥复制到系统剪贴板，不会在任何输出中显示
- `apply-token` 使用占位符替换机制注入密钥，不直接暴露密钥内容
- 所有 `sk-` 开头的密钥值在整个执行流程中都被严格保护

### 了解更多

AI-Token-skills 正在持续迭代中，指令和功能可能随版本更新。请以仓库 README 为准获取最新信息和变更日志：

- GitHub 仓库：[github.com/QuantumNous/skills](https://github.com/QuantumNous/skills)
- AI-Tkoens 官网：[ai-tokens.space](https://ai-tokens.space)
- AI-Tkoens GitHub：[github.com/QuantumNous/ai-tkoens](https://github.com/QuantumNous/ai-tkoens)

---

## AI-Token-admin（敬请期待）

AI-Token-admin 是 AI-Tkoens 官方管理员级 Skill 插件，支持在 Claude Code、Cursor、Windsurf 等 AI 编辑器中直接执行渠道管理、用户管理、系统配置、日志查询等管理员运维操作。正在开发中，敬请期待。

文档链接：https://ai-tokens.space/v1/zh/docs/skills/newapi-admin/

开发中 — 敬请期待

**AI-Token-admin** 目前正在开发中，尚未发布。以下为计划支持的功能预览。正式发布后本页面将更新为完整文档。

### 简介

**AI-Token-admin** 是面向 AI-Tkoens 管理员的 Skill 插件。与用户级的 [AI-Token](https://ai-tokens.space/v1/zh/docs/skills/newapi/) Skill 不同，AI-Token-admin 专注于**管理员运维场景**，让站点管理员在 AI 编辑器中通过自然语言指令完成日常管理任务，无需登录管理后台。

### 计划功能

#### 渠道管理

| 指令（规划中） | 说明 |
| --- | --- |
| /AI-Token-admin channels | 列出所有渠道及其状态 |
| /AI-Token-admin channel-add | 添加新渠道（OpenAI、Claude、Gemini、Azure 等） |
| /AI-Token-admin channel-test <id> | 测试指定渠道的连通性 |
| /AI-Token-admin channel-toggle <id> | 启用或禁用指定渠道 |
| /AI-Token-admin channel-priority | 查看和调整渠道优先级 |

#### 用户管理

| 指令（规划中） | 说明 |
| --- | --- |
| /AI-Token-admin users | 列出用户列表 |
| /AI-Token-admin user-info <id> | 查看用户详情（余额、分组、用量） |
| /AI-Token-admin user-quota <id> | 调整用户配额和余额 |
| /AI-Token-admin user-group <id> <group> | 修改用户所属分组 |
| /AI-Token-admin user-ban <id> | 封禁或解封用户 |

#### 系统配置

| 指令（规划中） | 说明 |
| --- | --- |
| /AI-Token-admin config | 查看当前系统配置 |
| /AI-Token-admin config-set <key> <value> | 修改系统配置项 |
| /AI-Token-admin ratio | 查看模型倍率设置 |
| /AI-Token-admin ratio-sync | 同步上游模型倍率 |

#### 日志与监控

| 指令（规划中） | 说明 |
| --- | --- |
| /AI-Token-admin logs | 查看最近的请求日志 |
| /AI-Token-admin stats | 查看系统统计数据（请求量、消耗、错误率） |
| /AI-Token-admin status | 检查系统健康状态和渠道连通性 |

#### 令牌与兑换码管理

| 指令（规划中） | 说明 |
| --- | --- |
| /AI-Token-admin redemptions | 列出兑换码 |
| /AI-Token-admin redemption-create | 批量创建兑换码 |
| /AI-Token-admin token-overview | 全局令牌使用概览 |

### 与 AI-Token Skill 的区别

|  | AI-Token | AI-Token-admin |
| --- | --- | --- |
| 面向用户 | 普通用户 / 开发者 | 站点管理员 |
| 操作范围 | 个人模型、令牌、余额、分组 | 全局渠道、用户、配置、日志 |
| 权限要求 | 用户访问令牌 | 管理员访问令牌 |
| 状态 | 已发布 | 开发中 |

### 关注进展

AI-Token-admin 正在积极开发中，欢迎关注仓库获取最新动态：

- GitHub 仓库：[github.com/QuantumNous/skills](https://github.com/QuantumNous/skills)
- 已发布的用户级 Skill：[AI-Token](https://ai-tokens.space/v1/zh/docs/skills/newapi/)

---

# 七、AI 模型接口（API 参考）

## 原生Gemini格式 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/audio/geminirelayv1beta-383836364/

Gemini 音频生成接口。 可使用gemini-2.5-flash-preview-tts等模型

POST``/`v1beta`/`models`/`{model}:generateContent`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Path Parameters

model*

string

模型名称

### Request Body

application/json

contents*

generationConfig*

### Response Body

#### application/json

$?

```
curl -X POST "https://ai-tokens.space/v1beta/models/string:generateContent" \  -H "Content-Type: application/json" \  -d '{    "contents": [      {}    ],    "generationConfig": {      "responseModalities": [        "string"      ],      "speechConfig": {        "voiceConfig": {          "prebuiltVoiceConfig": {            "voiceName": "string"          }        }      }    }  }'
```

/$

```
{
  "candidates": [
    {
      "content": {
        "role": "string",
        "parts": [
          {}
        ]
      },
      "finishReason": "string",
      "safetyRatings": [
        {}
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 0,
    "candidatesTokenCount": 0,
    "totalTokenCount": 0
  }
}
```

---

## 文本转语音 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/audio/openai/createspeech/

将文本转换为音频

POST `/v1/audio/speech`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Request Body

application/json

model*

string

input*

string

要转换的文本

Length

length <= 4096

voice*

string

Value in

"alloy" | "echo" | "fable" | "onyx" | "nova" | "shimmer"

response_format?

string

Default

"mp3"

Value in

"mp3" | "opus" | "aac" | "flac" | "wav" | "pcm"

speed?

number

Default

1

Range

0.25 <= value <= 4

### Response Body

#### audio/mpeg

$?

```
curl -X POST "https://ai-tokens.space/v1/audio/speech" \  -H "Content-Type: application/json" \  -d '{    "model": "tts-1",    "input": "string",    "voice": "alloy"  }'
```

/$

```
"string"
```

---

## 音频转录 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/audio/openai/createtranscription/

将音频转换为文本

POST `/v1/audio/transcriptions`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Request Body

multipart/form-data

file*

file

音频文件

Format

binary

model*

string

language?

string

ISO-639-1 语言代码

prompt?

string

response_format?

string

Default

"json"

Value in

"json" | "text" | "srt" | "verbose_json" | "vtt"

temperature?

number

timestamp_granularities?

array<string>

### Response Body

#### application/json

$?

```
curl -X POST "https://ai-tokens.space/v1/audio/transcriptions" \  -F file="string" \  -F model="whisper-1"
```

/$

```
{
  "text": "string"
}
```

---

## 音频翻译 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/audio/openai/createtranslation/

将音频翻译为英文文本

POST `/v1/audio/translations`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Request Body

multipart/form-data

file*

file

Format

binary

model*

string

prompt?

string

response_format?

string

temperature?

number

### Response Body

#### application/json

$?

```
curl -X POST "https://ai-tokens.space/v1/audio/translations" \  -F file="string" \  -F model="string"
```

/$

```
{
  "text": "string"
}
```

---

## 原生Claude格式 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/chat/createmessage/

Anthropic Claude Messages API 格式的请求。 需要在请求头中包含 `anthropic-version`。

POST `/v1/messages`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Header Parameters

anthropic-version*

string

Anthropic API 版本

x-api-key?

string

Anthropic API Key (可选，也可使用 Bearer Token)

### Request Body

application/json

model*

string

messages*

system?

string|

max_tokens*

integer

Range

1 <= value

temperature?

number

Range

0 <= value <= 1

top_p?

number

top_k?

integer

stream?

boolean

stop_sequences?

array<string>

tools?

tool_choice?

thinking?

metadata?

### Response Body

#### application/json

$?

```
curl -X POST "https://ai-tokens.space/v1/messages" \  -H "anthropic-version: 2023-06-01" \  -H "Content-Type: application/json" \  -d '{    "model": "claude-3-opus-20240229",    "messages": [      {        "role": "user",        "content": "string"      }    ],    "max_tokens": 1  }'
```

/$

```
{
  "id": "string",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "string",
      "text": "string"
    }
  ],
  "model": "string",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 0,
    "output_tokens": 0,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  }
}
```

---

## Gemini媒体识别 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/chat/gemini/geminirelayv1beta-391536411/

Gemini图像、PDF、音频、视频识别请求

⚠️注意：仅支持通过 inlineData 以 base64 方式上传图像、PDF、音频、视频，不支持 fileData.fileUri 或 File API。

POST``/`v1beta`/`models`/`{model}:generateContent`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Path Parameters

model*

string

模型名称

### Request Body

application/json

contents?

generationConfig?

safetySettings?

tools?

systemInstruction?

### Response Body

#### application/json

$?

```
curl -X POST "https://ai-tokens.space/v1beta/models/string:generateContent" \  -H "Content-Type: application/json" \  -d '{}'
```

/$

```
{
  "candidates": [
    {
      "content": {
        "role": "string",
        "parts": [
          {}
        ]
      },
      "finishReason": "string",
      "safetyRatings": [
        {}
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 0,
    "candidatesTokenCount": 0,
    "totalTokenCount": 0
  }
}
```

---

## Gemini文本聊天 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/chat/gemini/geminirelayv1beta/

代理 Gemini API 请求。 路径格式: `/v1beta/models/{model_name}:{action}`

例如:

- `/v1beta/models/gemini-2.5-pro:generateContent`
- `/v1beta/models/gemini-2.5-pro:streamGenerateContent?alt=sse`

POST``/`v1beta`/`models`/`{model}:generateContent`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Path Parameters

model*

string

模型名称

### Request Body

application/json

contents?

generationConfig?

safetySettings?

tools?

systemInstruction?

### Response Body

#### application/json

$?

```
curl -X POST "https://ai-tokens.space/v1beta/models/string:generateContent" \  -H "Content-Type: application/json" \  -d '{}'
```

/$

```
{
  "candidates": [
    {
      "content": {
        "role": "string",
        "parts": [
          {}
        ]
      },
      "finishReason": "string",
      "safetyRatings": [
        {}
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 0,
    "candidatesTokenCount": 0,
    "totalTokenCount": 0
  }
}
```

---

## ChatCompletions格式 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/chat/openai/createchatcompletion/

根据对话历史创建模型响应。支持流式和非流式响应。

兼容 OpenAI Chat Completions API。

POST `/v1/chat/completions`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Request Body

application/json

model*

string

模型 ID

messages*

对话消息列表

temperature?

number

采样温度

Default

1

Range

0 <= value <= 2

top_p?

number

核采样参数

Default

1

Range

0 <= value <= 1

n?

integer

生成数量

Default

1

Range

1 <= value

stream?

boolean

是否流式响应

Default

false

stream_options?

stop?

string|

停止序列

max_tokens?

integer

最大生成 Token 数

max_completion_tokens?

integer

最大补全 Token 数

presence_penalty?

number

Default

0

Range

-2 <= value <= 2

frequency_penalty?

number

Default

0

Range

-2 <= value <= 2

logit_bias?

user?

string

tools?

tool_choice?

string|

response_format?

seed?

integer

reasoning_effort?

string

推理强度 (用于支持推理的模型)

Value in

"low" | "medium" | "high"

modalities?

array<string>

audio?

### Response Body

#### application/json

#### application/json

#### application/json

$?

```
curl -X POST "https://ai-tokens.space/v1/chat/completions" \  -H "Content-Type: application/json" \  -d '{    "model": "gpt-4",    "messages": [      {        "role": "system",        "content": "string"      }    ]  }'
```

/$

```
{
  "id": "string",
  "object": "chat.completion",
  "created": 0,
  "model": "string",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "system",
        "content": "string",
        "name": "string",
        "tool_calls": [
          {
            "id": "string",
            "type": "function",
            "function": {
              "name": "string",
              "arguments": "string"
            }
          }
        ],
        "tool_call_id": "string",
        "reasoning_content": "string"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 0,
    "completion_tokens": 0,
    "total_tokens": 0,
    "prompt_tokens_details": {
      "cached_tokens": 0,
      "text_tokens": 0,
      "audio_tokens": 0,
      "image_tokens": 0
    },
    "completion_tokens_details": {
      "text_tokens": 0,
      "audio_tokens": 0,
      "reasoning_tokens": 0
    }
  },
  "system_fingerprint": "string"
}
```

```
{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}
```

```
{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}
```

---

## Responses格式 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/chat/openai/createresponse/

OpenAI Responses API，用于创建模型响应。 支持多轮对话、工具调用、推理等功能。

POST `/v1/responses`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Request Body

application/json

model*

string

input?

string|

输入内容，可以是字符串或消息数组

instructions?

string

max_output_tokens?

integer

temperature?

number

top_p?

number

stream?

boolean

tools?

tool_choice?

string|

reasoning?

previous_response_id?

string

truncation?

string

Value in

"auto" | "disabled"

### Response Body

#### application/json

$?

```
curl -X POST "https://ai-tokens.space/v1/responses" \  -H "Content-Type: application/json" \  -d '{    "model": "string"  }'
```

/$

```
{
  "id": "string",
  "object": "response",
  "created_at": 0,
  "status": "completed",
  "model": "string",
  "output": [
    {
      "type": "string",
      "id": "string",
      "status": "string",
      "role": "string",
      "content": [
        {
          "type": "string",
          "text": "string"
        }
      ]
    }
  ],
  "usage": {
    "prompt_tokens": 0,
    "completion_tokens": 0,
    "total_tokens": 0,
    "prompt_tokens_details": {
      "cached_tokens": 0,
      "text_tokens": 0,
      "audio_tokens": 0,
      "image_tokens": 0
    },
    "completion_tokens_details": {
      "text_tokens": 0,
      "audio_tokens": 0,
      "reasoning_tokens": 0
    }
  }
}
```

---

## 原生OpenAI格式 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/completions/createcompletion/

基于给定提示创建文本补全

POST `/v1/completions`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Request Body

application/json

model*

string

prompt*

string|

max_tokens?

integer

temperature?

number

top_p?

number

n?

integer

stream?

boolean

stop?

string|

suffix?

string

echo?

boolean

### Response Body

#### application/json

$?

```
curl -X POST "https://ai-tokens.space/v1/completions" \  -H "Content-Type: application/json" \  -d '{    "model": "string",    "prompt": "string"  }'
```

/$

```
{
  "id": "string",
  "object": "text_completion",
  "created": 0,
  "model": "string",
  "choices": [
    {
      "text": "string",
      "index": 0,
      "finish_reason": "string"
    }
  ],
  "usage": {
    "prompt_tokens": 0,
    "completion_tokens": 0,
    "total_tokens": 0,
    "prompt_tokens_details": {
      "cached_tokens": 0,
      "text_tokens": 0,
      "audio_tokens": 0,
      "image_tokens": 0
    },
    "completion_tokens_details": {
      "text_tokens": 0,
      "audio_tokens": 0,
      "reasoning_tokens": 0
    }
  }
}
```

---

## 原生OpenAI格式 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/embeddings/createembedding/

将文本转换为向量嵌入

POST `/v1/embeddings`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Request Body

application/json

model*

string

input*

string|

要嵌入的文本

encoding_format?

string

Default

"float"

Value in

"float" | "base64"

dimensions?

integer

输出向量维度

### Response Body

#### application/json

$?

```
curl -X POST "https://ai-tokens.space/v1/embeddings" \  -H "Content-Type: application/json" \  -d '{    "model": "text-embedding-ada-002",    "input": "string"  }'
```

/$

```
{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [
        0
      ]
    }
  ],
  "model": "string",
  "usage": {
    "prompt_tokens": 0,
    "total_tokens": 0
  }
}
```

---

## 原生Gemini格式 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/embeddings/createengineembedding/

使用指定引擎/模型创建嵌入

POST `/v1/engines/{model}/embeddings`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Path Parameters

model*

string

模型/引擎 ID

### Request Body

application/json

model*

string

input*

string|

要嵌入的文本

encoding_format?

string

Default

"float"

Value in

"float" | "base64"

dimensions?

integer

输出向量维度

### Response Body

#### application/json

$?

```
curl -X POST "https://ai-tokens.space/v1/engines/string/embeddings" \  -H "Content-Type: application/json" \  -d '{    "model": "text-embedding-ada-002",    "input": "string"  }'
```

/$

```
{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [
        0
      ]
    }
  ],
  "model": "string",
  "usage": {
    "prompt_tokens": 0,
    "total_tokens": 0
  }
}
```

---

## Gemini原生格式 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/images/gemini/geminirelayv1beta-383837589/

Gemini 图片生成

POST``/`v1beta`/`models`/`{model}:generateContent`/``

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Path Parameters

model*

string

模型名称

### Request Body

application/json

contents*

generationConfig*

### Response Body

#### application/json

$?

```
curl -X POST "https://ai-tokens.space/v1beta/models/string:generateContent/" \  -H "Content-Type: application/json" \  -d '{    "contents": [      {}    ],    "generationConfig": {      "responseModalities": [        "string"      ],      "imageConfig": {        "aspectRatio": "string",        "imageSize": "string"      }    }  }'
```

/$

```
{
  "candidates": [
    {
      "content": {
        "role": "string",
        "parts": [
          {}
        ]
      },
      "finishReason": "string",
      "safetyRatings": [
        {}
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 0,
    "candidatesTokenCount": 0,
    "totalTokenCount": 0
  }
}
```

---

## OpenAI聊天格式 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/images/gemini/geminirelayv1beta-389846313/

Gemini 图片生成

POST `/v1/chat/completions`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Request Body

application/json

model*

string

stream*

boolean

messages*

extra_body?

contents*

### Response Body

#### application/json

$?

```
curl -X POST "https://ai-tokens.space/v1/chat/completions" \  -H "Content-Type: application/json" \  -d '{    "model": "string",    "stream": true,    "messages": [      {}    ],    "contents": [      {}    ]  }'
```

/$

```
{
  "id": "string",
  "model": "string",
  "object": "string",
  "created": 0,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "string",
        "content": "string"
      },
      "finish_reason": "string"
    }
  ],
  "usage": {
    "prompt_tokens": 0,
    "completion_tokens": 0,
    "total_tokens": 0
  }
}
```

---

## 编辑图像 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/images/openai/post-v1-images-edits/

在给定原始图像和提示的情况下创建编辑或扩展图像。

POST `/v1/images/edits`/``

### Authorization

Bearer

Authorization

Bearer <token>

In: `header`

### Request Body

multipart/form-data

image*

file

要编辑的图像。必须是有效的 PNG 文件，小于 4MB，并且是方形的。如果未提供遮罩，图像必须具有透明度，将用作遮罩。

Format

binary

mask?

file

附加图像，其完全透明区域（例如，alpha 为零的区域）指示image应编辑的位置。必须是有效的 PNG 文件，小于 4MB，并且尺寸与原始image相同。

Format

binary

prompt*

string

所需图像的文本描述。最大长度为 1000 个字符。

n?

string

要生成的图像数。必须介于 1 和 10 之间。

size?

string

生成图像的大小。必须是`256x256`、`512x512`或 `1024x1024`之一。

response_format?

string

生成的图像返回的格式。必须是`url`或`b64_json`。

user?

string

代表您的最终用户的唯一标识符，可以帮助 OpenAI 监控和检测滥用行为。[了解更多](https://platform.openai.com/docs/guides/safety-best-practices/end-user-ids)。

model?

string

### Response Body

#### application/json

$?

```
curl -X POST "https://ai-tokens.space/v1/images/edits/" \  -F image="cmMtdXBsb2FkLTE2ODc4MzMzNDc3NTEtMjA=/31225951_59371037e9_small.png" \  -F prompt="A cute baby sea otter wearing a beret."
```

/$

```
{}
```

---

## 生成图像 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/images/openai/post-v1-images-generations/

在给定提示的情况下创建图像。[了解更多](https://platform.openai.com/docs/guides/images)。

POST `/v1/images/generations`/``

### Authorization

Bearer

Authorization

Bearer <token>

In: `header`

### Request Body

application/json

model?

string

用于图像生成的模型。`dall-e-2`、`dall-e-3` 或 `gpt-image-1` 之一。默认为 `dall-e-2`，除非使用特定于 `gpt-image-1` 的参数。

prompt*

string

所需图像的文本描述。`gpt-image-1` 的最大长度为 32000 个字符，`dall-e-2` 的最大长度为 1000 个字符，`dall-e-3` 的最大长度为 4000 个字符。

n?

integer

要生成的图像数量。必须介于 1 到 10 之间。对于 `dall-e-3`，仅支持 `n=1`。

size?

string

生成的图像的大小。`对于 gpt-image-1`，必须是 `1024x1024`、`1536x1024`（横向）、`1024x1536`（纵向）或`自动`（默认值）之一，`对于 dall-e-2`，必须是 `256x256、``512x512` 或 `1024x1024` 之一，对于 `dall-e-3`，必须是 `1024x1024`、`1792x1024` 或 `1024x1792` 之一。

background?

string

允许为生成的图像的背景设置透明度。此参数仅支持 `gpt-image-1`。必须是以下之一 `透明`、`不透明`或`自动`（默认值）。使用`自动`时，模型将自动确定图像的最佳背景。

如果`是透明`的，则输出格式需要支持透明度，因此应将其设置为 `png`（默认值）或 `webp`。

moderation?

string

控制 `gpt-image-1` 生成的图像的内容审核级别。必须为`低，` 以进行限制较少的筛选或`自动`（默认值）。

quality?

string

将生成的图像的质量。

stream?

string

style?

string

user?

string

### Response Body

#### application/json

$?

```
curl -X POST "https://ai-tokens.space/v1/images/generations/" \  -H "Content-Type: application/json" \  -d '{    "prompt": "string"  }'
```

/$

```
{
  "created": 0,
  "data": [
    {
      "b64_json": "string",
      "url": "string"
    }
  ],
  "usage": {
    "total_tokens": 0,
    "input_tokens": 0,
    "output_tokens": 0,
    "input_tokens_details": {
      "text_tokens": 0,
      "image_tokens": 0
    }
  }
}
```

---

## 生成图像 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/images/qwen/createimage/

百炼qwen-image系列图片生成

POST `/v1/images/generations`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Request Body

application/json

model*

string

input*

parameters?

### Response Body

#### application/json

$?

```
curl -X POST "https://ai-tokens.space/v1/images/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "string",    "input": {      "messages": [        {}      ]    }  }'
```

/$

```
{
  "created": 0,
  "data": [
    {
      "url": "string",
      "b64_json": "string",
      "revised_prompt": "string"
    }
  ]
}
```

---

## 编辑图像 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/images/qwen/editimage/

百炼qwen-image系列图片编辑

POST `/v1/images/edits`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Request Body

application/json

model*

string

input*

parameters?

### Response Body

#### application/json

$?

```
curl -X POST "https://ai-tokens.space/v1/images/edits" \  -H "Content-Type: application/json" \  -d '{    "model": "string",    "input": {      "messages": [        {}      ]    }  }'
```

/$

```
{
  "created": 0,
  "data": [
    {
      "url": "string",
      "b64_json": "string",
      "revised_prompt": "string"
    }
  ]
}
```

---

## 原生OpenAI格式 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/models/list/listmodels/

获取当前可用的模型列表。

根据请求头自动识别返回格式：

- 包含 `x-api-key` 和 `anthropic-version` 头时返回 Anthropic 格式
- 包含 `x-goog-api-key` 头或 `key` 查询参数时返回 Gemini 格式
- 其他情况返回 OpenAI 格式

GET `/v1/models`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Query Parameters

key?

string

Google API Key (用于 Gemini 格式)

### Header Parameters

x-api-key?

string

Anthropic API Key (用于 Claude 格式)

anthropic-version?

string

Anthropic API 版本

x-goog-api-key?

string

Google API Key (用于 Gemini 格式)

### Response Body

#### application/json

#### application/json

$?

```
curl -X GET "https://ai-tokens.space/v1/models"
```

/$

```
{
  "object": "list",
  "data": [
    {
      "id": "gpt-4",
      "object": "model",
      "created": 0,
      "owned_by": "openai"
    }
  ]
}
```

```
{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}
```

---

## 原生Gemini格式 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/models/list/listmodelsgemini/

以 Gemini API 格式返回可用模型列表

GET``/`v1beta`/`models`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Response Body

#### application/json

$?

```
curl -X GET "https://ai-tokens.space/v1beta/models"
```

/$

```
{
  "models": [
    {
      "name": "models/gemini-pro",
      "version": "string",
      "displayName": "string",
      "description": "string",
      "inputTokenLimit": 0,
      "outputTokenLimit": 0,
      "supportedGenerationMethods": [
        "string"
      ]
    }
  ]
}
```

---

## 原生OpenAI格式 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/moderations/createmoderation/

检查文本内容是否违反使用政策

POST `/v1/moderations`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Request Body

application/json

input*

string|

model?

string

### Response Body

#### application/json

$?

```
curl -X POST "https://ai-tokens.space/v1/moderations" \  -H "Content-Type: application/json" \  -d '{    "input": "string"  }'
```

/$

```
{
  "id": "string",
  "model": "string",
  "results": [
    {
      "flagged": true,
      "categories": {},
      "category_scores": {}
    }
  ]
}
```

---

## 原生OpenAI格式 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/realtime/createrealtimesession/

建立 WebSocket 连接用于实时对话。

**注意**: 这是一个 WebSocket 端点，需要使用 WebSocket 协议连接。

连接 URL 示例: `wss://api.example.com/v1/realtime?model=gpt-4o-realtime`

GET `/v1/realtime`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Query Parameters

model?

string

要使用的模型

### Response Body

#### application/json

$?

```
curl -X GET "https://ai-tokens.space/v1/realtime"
```

/$
Empty

```
{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}
```

---

## 文档重排序 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/rerank/creatererank/

根据查询对文档列表进行相关性重排序

POST `/v1/rerank`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Request Body

application/json

model*

string

query*

string

查询文本

documents*

要重排序的文档列表

top_n?

integer

返回前 N 个结果

return_documents?

boolean

Default

false

### Response Body

#### application/json

$?

```
curl -X POST "https://ai-tokens.space/v1/rerank" \  -H "Content-Type: application/json" \  -d '{    "model": "rerank-english-v2.0",    "query": "string",    "documents": [      "string"    ]  }'
```

/$

```
{
  "id": "string",
  "results": [
    {
      "index": 0,
      "relevance_score": 0,
      "document": {}
    }
  ],
  "meta": {}
}
```

---

## 上传文件 (未实现) [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/unimplemented/files/createfile/

此接口尚未实现

POST `/v1/files`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Request Body

multipart/form-data

file?

file

Format

binary

purpose?

string

### Response Body

#### application/json

$?

```
curl -X POST "https://ai-tokens.space/v1/files"
```

/$

```
{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}
```

---

## 删除文件 (未实现) [`DELETE`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/unimplemented/files/deletefile/

此接口尚未实现

DELETE `/v1/files/{file_id}`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Path Parameters

file_id*

string

### Response Body

#### application/json

$?

```
curl -X DELETE "https://ai-tokens.space/v1/files/string"
```

/$

```
{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}
```

---

## 获取文件内容 (未实现) [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/unimplemented/files/downloadfile/

此接口尚未实现

GET `/v1/files/{file_id}/content`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Path Parameters

file_id*

string

### Response Body

#### application/json

$?

```
curl -X GET "https://ai-tokens.space/v1/files/string/content"
```

/$

```
{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}
```

---

## 列出文件 (未实现) [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/unimplemented/files/listfiles/

此接口尚未实现

GET `/v1/files`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Response Body

#### application/json

$?

```
curl -X GET "https://ai-tokens.space/v1/files"
```

/$

```
{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}
```

---

## 获取文件信息 (未实现) [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/unimplemented/files/retrievefile/

此接口尚未实现

GET `/v1/files/{file_id}`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Path Parameters

file_id*

string

### Response Body

#### application/json

$?

```
curl -X GET "https://ai-tokens.space/v1/files/string"
```

/$

```
{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}
```

---

## 取消微调任务 (未实现) [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/unimplemented/fine-tuning/cancelfinetune/

此接口尚未实现

POST `/v1/fine-tunes/{fine_tune_id}/cancel`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Path Parameters

fine_tune_id*

string

### Response Body

#### application/json

$?

```
curl -X POST "https://ai-tokens.space/v1/fine-tunes/string/cancel"
```

/$

```
{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}
```

---

## 创建微调任务 (未实现) [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/unimplemented/fine-tuning/createfinetune/

此接口尚未实现

POST `/v1/fine-tunes`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Request Body

application/json

### Response Body

#### application/json

$?

```
curl -X POST "https://ai-tokens.space/v1/fine-tunes" \  -H "Content-Type: application/json" \  -d '{}'
```

/$

```
{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}
```

---

## 获取微调任务事件 (未实现) [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/unimplemented/fine-tuning/listfinetuneevents/

此接口尚未实现

GET `/v1/fine-tunes/{fine_tune_id}/events`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Path Parameters

fine_tune_id*

string

### Response Body

#### application/json

$?

```
curl -X GET "https://ai-tokens.space/v1/fine-tunes/string/events"
```

/$

```
{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}
```

---

## 列出微调任务 (未实现) [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/unimplemented/fine-tuning/listfinetunes/

此接口尚未实现

GET `/v1/fine-tunes`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Response Body

#### application/json

$?

```
curl -X GET "https://ai-tokens.space/v1/fine-tunes"
```

/$

```
{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}
```

---

## 获取微调任务详情 (未实现) [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/unimplemented/fine-tuning/retrievefinetune/

此接口尚未实现

GET `/v1/fine-tunes/{fine_tune_id}`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Path Parameters

fine_tune_id*

string

### Response Body

#### application/json

$?

```
curl -X GET "https://ai-tokens.space/v1/fine-tunes/string"
```

/$

```
{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}
```

---

## 创建视频生成任务 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/videos/createvideogeneration/

提交视频生成任务，支持文生视频和图生视频。

返回任务 ID，可通过 GET 接口查询任务状态。

POST `/v1/video/generations`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Request Body

application/json

model?

string

模型/风格 ID

prompt?

string

文本描述提示词

image?

string

图片输入 (URL 或 Base64)

duration?

number

视频时长（秒）

width?

integer

视频宽度

height?

integer

视频高度

fps?

integer

视频帧率

seed?

integer

随机种子

n?

integer

生成视频数量

response_format?

string

响应格式

user?

string

用户标识

metadata?

扩展参数 (如 negative_prompt, style, quality_level 等)

### Response Body

#### application/json

#### application/json

$?

```
curl -X POST "https://ai-tokens.space/v1/video/generations" \  -H "Content-Type: application/json" \  -d '{}'
```

/$

```
{
  "task_id": "abcd1234efgh",
  "status": "queued"
}
```

```
{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}
```

---

## 获取视频生成任务状态 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/videos/getvideogeneration/

查询视频生成任务的状态和结果。

任务状态：

- `queued`: 排队中
- `in_progress`: 生成中
- `completed`: 已完成
- `failed`: 失败

GET `/v1/video/generations/{task_id}`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Path Parameters

task_id*

string

任务 ID

### Response Body

#### application/json

#### application/json

$?

```
curl -X GET "https://ai-tokens.space/v1/video/generations/string"
```

/$

```
{
  "task_id": "abcd1234efgh",
  "status": "completed",
  "url": "https://example.com/video.mp4",
  "format": "mp4",
  "metadata": {
    "duration": 5,
    "fps": 30,
    "width": 1280,
    "height": 720,
    "seed": 20231234
  },
  "error": {
    "code": 0,
    "message": "string"
  }
}
```

```
{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}
```

---

## 即梦视频生成 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/videos/jimeng/createjimengvideo/

即梦官方 API 格式的视频生成接口。

支持通过 Action 参数指定操作类型：

- `CVSync2AsyncSubmitTask`: 提交视频生成任务
- `CVSync2AsyncGetResult`: 获取任务结果

需要在查询参数中指定 Action 和 Version。

POST``/`jimeng`/``

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Query Parameters

Action*

string

API 操作类型

Value in

"CVSync2AsyncSubmitTask" | "CVSync2AsyncGetResult"

Version*

string

API 版本

### Request Body

application/json

req_key?

string

请求类型标识

prompt?

string

文本描述

binary_data_base64?

array<string>

Base64 编码的图片数据

### Response Body

#### application/json

#### application/json

$?

```
curl -X POST "https://ai-tokens.space/jimeng/?Action=CVSync2AsyncSubmitTask&Version=string" \  -H "Content-Type: application/json" \  -d '{}'
```

/$

```
{
  "code": 0,
  "message": "string",
  "data": {}
}
```

```
{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}
```

---

## Kling 图生视频 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/videos/kling/createklingimage2video/

使用 Kling 模型从图片生成视频。

支持通过 image 参数传入图片 URL 或 Base64 编码的图片数据。

POST``/`kling`/`v1`/`videos`/`image2video`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Request Body

application/json

model?

string

模型/风格 ID

prompt?

string

文本描述提示词

image?

string

图片输入 (URL 或 Base64)

duration?

number

视频时长（秒）

width?

integer

视频宽度

height?

integer

视频高度

fps?

integer

视频帧率

seed?

integer

随机种子

n?

integer

生成视频数量

response_format?

string

响应格式

user?

string

用户标识

metadata?

扩展参数 (如 negative_prompt, style, quality_level 等)

### Response Body

#### application/json

#### application/json

$?

```
curl -X POST "https://ai-tokens.space/kling/v1/videos/image2video" \  -H "Content-Type: application/json" \  -d '{}'
```

/$

```
{
  "task_id": "abcd1234efgh",
  "status": "queued"
}
```

```
{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}
```

---

## Kling 文生视频 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/videos/kling/createklingtext2video/

使用 Kling 模型从文本描述生成视频。

支持的模型：kling-v1, kling-v1-5 等

POST``/`kling`/`v1`/`videos`/`text2video`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Request Body

application/json

model?

string

模型/风格 ID

prompt?

string

文本描述提示词

image?

string

图片输入 (URL 或 Base64)

duration?

number

视频时长（秒）

width?

integer

视频宽度

height?

integer

视频高度

fps?

integer

视频帧率

seed?

integer

随机种子

n?

integer

生成视频数量

response_format?

string

响应格式

user?

string

用户标识

metadata?

扩展参数 (如 negative_prompt, style, quality_level 等)

### Response Body

#### application/json

#### application/json

$?

```
curl -X POST "https://ai-tokens.space/kling/v1/videos/text2video" \  -H "Content-Type: application/json" \  -d '{}'
```

/$

```
{
  "task_id": "abcd1234efgh",
  "status": "queued"
}
```

```
{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}
```

---

## 获取 Kling 图生视频任务状态 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/videos/kling/getklingimage2video/

查询 Kling 图生视频任务的状态和结果。

GET``/`kling`/`v1`/`videos`/`image2video`/`{task_id}`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Path Parameters

task_id*

string

任务 ID

### Response Body

#### application/json

#### application/json

$?

```
curl -X GET "https://ai-tokens.space/kling/v1/videos/image2video/string"
```

/$

```
{
  "task_id": "abcd1234efgh",
  "status": "completed",
  "url": "https://example.com/video.mp4",
  "format": "mp4",
  "metadata": {
    "duration": 5,
    "fps": 30,
    "width": 1280,
    "height": 720,
    "seed": 20231234
  },
  "error": {
    "code": 0,
    "message": "string"
  }
}
```

```
{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}
```

---

## 获取 Kling 文生视频任务状态 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/videos/kling/getklingtext2video/

查询 Kling 文生视频任务的状态和结果。

GET``/`kling`/`v1`/`videos`/`text2video`/`{task_id}`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Path Parameters

task_id*

string

任务 ID

### Response Body

#### application/json

#### application/json

$?

```
curl -X GET "https://ai-tokens.space/kling/v1/videos/text2video/string"
```

/$

```
{
  "task_id": "abcd1234efgh",
  "status": "completed",
  "url": "https://example.com/video.mp4",
  "format": "mp4",
  "metadata": {
    "duration": 5,
    "fps": 30,
    "width": 1280,
    "height": 720,
    "seed": 20231234
  },
  "error": {
    "code": 0,
    "message": "string"
  }
}
```

```
{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}
```

---

## 创建视频 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/videos/sora/createvideo/

OpenAI 兼容的视频生成接口。

参考文档: [https://platform.openai.com/docs/api-reference/videos/create](https://platform.openai.com/docs/api-reference/videos/create)

POST `/v1/videos`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Request Body

multipart/form-data

model?

string

模型/风格 ID

prompt?

string

文本描述提示词

image?

string

图片输入 (URL 或 Base64)

duration?

number

视频时长（秒）

width?

integer

视频宽度

height?

integer

视频高度

fps?

integer

视频帧率

seed?

integer

随机种子

n?

integer

生成视频数量

response_format?

string

响应格式

user?

string

用户标识

metadata?

扩展参数 (如 negative_prompt, style, quality_level 等)

### Response Body

#### application/json

#### application/json

$?

```
curl -X POST "https://ai-tokens.space/v1/videos"
```

/$

```
{
  "id": "string",
  "object": "string",
  "model": "string",
  "status": "string",
  "progress": 0,
  "created_at": 0,
  "seconds": "string",
  "completed_at": 0,
  "expires_at": 0,
  "size": "string",
  "error": {
    "message": "string",
    "code": "string"
  },
  "metadata": {}
}
```

```
{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}
```

---

## 获取视频任务状态 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/videos/sora/getvideo/

OpenAI 兼容的视频任务状态查询接口。

返回视频任务的详细状态信息。

GET `/v1/videos/{task_id}`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Path Parameters

task_id*

string

视频任务 ID

### Response Body

#### application/json

#### application/json

$?

```
curl -X GET "https://ai-tokens.space/v1/videos/string"
```

/$

```
{
  "id": "string",
  "object": "string",
  "model": "string",
  "status": "string",
  "progress": 0,
  "created_at": 0,
  "seconds": "string"
}
```

```
{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}
```

---

## 获取视频内容 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/ai-model/videos/sora/getvideocontent/

获取已完成视频任务的视频文件内容。

此接口会代理返回视频文件流。

GET `/v1/videos/{task_id}/content`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Path Parameters

task_id*

string

视频任务 ID

### Response Body

#### video/mp4

#### application/json

$?

```
curl -X GET "https://ai-tokens.space/v1/videos/string/content"
```

/$

```
"string"
```

```
{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}
```

---

# 八、管理接口（后台 API）

## 鉴权体系说明（Auth）

后台管理接口鉴权方式与权限级别说明

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/auth/

### 说明

后台管理接口采用多级鉴权机制，常见为：**公开**、**用户**、**管理员**、**Root**。

### 认证方式（二选一）

#### Session

通过登录接口获取 Session：

- `POST /api/user/login`

#### Access Token（推荐）

在请求头中携带：

```
Authorization: Bearer {token}
```

Token 可在「个人设置 - 安全设置 - 系统访问令牌」中生成。

### 必需请求头

部分接口要求携带用户标识请求头：

```
New-Api-User: {user_id}
```

其中 `{user_id}` 必须与当前登录用户匹配。

### 权限级别

- **公开（Public）**：无需鉴权
- **用户（User）**：需要登录或 Access Token
- **管理员（Admin）**：需要管理员权限
- **Root**：最高权限

---

## 批量删除渠道 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/channel-management/channel-batch-post/

👨‍💼 需要管理员权限（Admin）

POST``/`api`/`channel`/`batch`

### Request Body

application/json

ids?

array<integer>

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/channel/batch" \  -H "Content-Type: application/json" \  -d '{}'
```

/$
Empty

---

## 批量设置渠道标签 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/channel-management/channel-batch-tag-post/

👨‍💼 需要管理员权限（Admin）

POST``/`api`/`channel`/`batch`/`tag`

### Request Body

application/json

ids?

array<integer>

tag?

string

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/channel/batch/tag" \  -H "Content-Type: application/json" \  -d '{}'
```

/$
Empty

---

## 复制渠道 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/channel-management/channel-copy-id-post/

👨‍💼 需要管理员权限（Admin）

POST``/`api`/`channel`/`copy`/`{id}`

### Path Parameters

id*

integer

### Query Parameters

suffix?

string

reset_balance?

boolean

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/channel/copy/0"
```

/$
Empty

---

## 删除已禁用渠道 [`DELETE`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/channel-management/channel-disabled-delete/

👨‍💼 需要管理员权限（Admin）

DELETE``/`api`/`channel`/`disabled`

### Response Body

$?

```
curl -X DELETE "https://ai-tokens.space/api/channel/disabled"
```

/$
Empty

---

## 获取上游模型列表 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/channel-management/channel-fetch_models-id-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`channel`/`fetch_models`/`{id}`

### Path Parameters

id*

integer

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/channel/fetch_models/0"
```

/$
Empty

---

## 获取模型列表 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/channel-management/channel-fetch_models-post/

👨‍💼 需要管理员权限（Admin）

POST``/`api`/`channel`/`fetch_models`

### Request Body

application/json

base_url?

string

type?

integer

key?

string

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/channel/fetch_models" \  -H "Content-Type: application/json" \  -d '{}'
```

/$
Empty

---

## 修复渠道能力 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/channel-management/channel-fix-post/

👨‍💼 需要管理员权限（Admin）

POST``/`api`/`channel`/`fix`

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/channel/fix"
```

/$
Empty

---

## 获取所有渠道 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/channel-management/channel-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`channel`/``

### Query Parameters

p?

integer

page_size?

integer

id_sort?

boolean

tag_mode?

boolean

status?

string

type?

integer

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/channel/"
```

/$
Empty

---

## 删除渠道 [`DELETE`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/channel-management/channel-id-delete/

👨‍💼 需要管理员权限（Admin）

DELETE``/`api`/`channel`/`{id}`

### Path Parameters

id*

integer

### Response Body

$?

```
curl -X DELETE "https://ai-tokens.space/api/channel/0"
```

/$
Empty

---

## 获取指定渠道 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/channel-management/channel-id-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`channel`/`{id}`

### Path Parameters

id*

integer

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/channel/0"
```

/$
Empty

---

## 获取渠道密钥 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/channel-management/channel-id-key-post/

👑 需要超级管理员权限（Root）+ 安全验证

POST``/`api`/`channel`/`{id}`/`key`

### Path Parameters

id*

integer

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/channel/0/key"
```

/$
Empty

---

## 获取已启用模型列表 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/channel-management/channel-models_enabled-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`channel`/`models_enabled`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/channel/models_enabled"
```

/$
Empty

---

## 获取渠道模型列表 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/channel-management/channel-models-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`channel`/`models`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/channel/models"
```

/$
Empty

---

## 管理多密钥 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/channel-management/channel-multi_key-manage-post/

👨‍💼 需要管理员权限（Admin）

POST``/`api`/`channel`/`multi_key`/`manage`

### Request Body

application/json

channel_id?

integer

action?

string

Value in

"get_key_status" | "disable_key" | "enable_key" | "delete_key" | "delete_disabled_keys" | "enable_all_keys" | "disable_all_keys"

key_index?

integer

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/channel/multi_key/manage" \  -H "Content-Type: application/json" \  -d '{}'
```

/$
Empty

---

## 添加渠道 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/channel-management/channel-post/

👨‍💼 需要管理员权限（Admin）

POST``/`api`/`channel`/``

### Request Body

application/json

mode?

string

Value in

"single" | "batch" | "multi_to_single"

channel?

object

Unresolved $ref: #/definitions/224188811

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/channel/" \  -H "Content-Type: application/json" \  -d '{}'
```

/$
Empty

---

## 更新渠道 [`PUT`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/channel-management/channel-put/

👨‍💼 需要管理员权限（Admin）

PUT``/`api`/`channel`/``

### Request Body

application/json

### Response Body

$?

```
curl -X PUT "https://ai-tokens.space/api/channel/" \  -H "Content-Type: application/json" \  -d '{}'
```

/$
Empty

---

## 搜索渠道 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/channel-management/channel-search-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`channel`/`search`

### Query Parameters

keyword?

string

group?

string

model?

string

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/channel/search"
```

/$
Empty

---

## 禁用标签渠道 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/channel-management/channel-tag-disabled-post/

👨‍💼 需要管理员权限（Admin）

POST``/`api`/`channel`/`tag`/`disabled`

### Request Body

application/json

tag?

string

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/channel/tag/disabled" \  -H "Content-Type: application/json" \  -d '{}'
```

/$
Empty

---

## 启用标签渠道 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/channel-management/channel-tag-enabled-post/

👨‍💼 需要管理员权限（Admin）

POST``/`api`/`channel`/`tag`/`enabled`

### Request Body

application/json

tag?

string

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/channel/tag/enabled" \  -H "Content-Type: application/json" \  -d '{}'
```

/$
Empty

---

## 获取标签模型 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/channel-management/channel-tag-models-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`channel`/`tag`/`models`

### Query Parameters

tag*

string

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/channel/tag/models?tag=string"
```

/$
Empty

---

## 编辑标签渠道 [`PUT`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/channel-management/channel-tag-put/

👨‍💼 需要管理员权限（Admin）

PUT``/`api`/`channel`/`tag`

### Request Body

application/json

tag?

string

new_tag?

string

priority?

integer

weight?

integer

### Response Body

$?

```
curl -X PUT "https://ai-tokens.space/api/channel/tag" \  -H "Content-Type: application/json" \  -d '{}'
```

/$
Empty

---

## 测试所有渠道 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/channel-management/channel-test-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`channel`/`test`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/channel/test"
```

/$
Empty

---

## 测试指定渠道 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/channel-management/channel-test-id-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`channel`/`test`/`{id}`

### Path Parameters

id*

integer

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/channel/test/0"
```

/$
Empty

---

## 更新所有渠道余额 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/channel-management/channel-update_balance-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`channel`/`update_balance`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/channel/update_balance"
```

/$
Empty

---

## 更新指定渠道余额 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/channel-management/channel-update_balance-id-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`channel`/`update_balance`/`{id}`

### Path Parameters

id*

integer

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/channel/update_balance/0"
```

/$
Empty

---

## 使用兑换码 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/default/user-topup-post/

🔐 需要登录（User权限）

POST``/`api`/`user`/`topup`

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Request Body

application/json

key*

string

### Response Body

#### application/json

$?

```
curl -X POST "https://ai-tokens.space/api/user/topup" \  -H "Content-Type: application/json" \  -d '{    "key": "string"  }'
```

/$

```
{}
```

---

## 获取所有分组 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/groups/group-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`group`/``

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/group/"
```

/$
Empty

---

## 获取预填分组 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/groups/prefill_group-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`prefill_group`/``

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/prefill_group/"
```

/$
Empty

---

## 删除预填分组 [`DELETE`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/groups/prefill_group-id-delete/

👨‍💼 需要管理员权限（Admin）

DELETE``/`api`/`prefill_group`/`{id}`

### Path Parameters

id*

integer

### Response Body

$?

```
curl -X DELETE "https://ai-tokens.space/api/prefill_group/0"
```

/$
Empty

---

## 创建预填分组 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/groups/prefill_group-post/

👨‍💼 需要管理员权限（Admin）

POST``/`api`/`prefill_group`/``

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/prefill_group/"
```

/$
Empty

---

## 更新预填分组 [`PUT`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/groups/prefill_group-put/

👨‍💼 需要管理员权限（Admin）

PUT``/`api`/`prefill_group`/``

### Response Body

$?

```
curl -X PUT "https://ai-tokens.space/api/prefill_group/"
```

/$
Empty

---

## 删除历史日志 [`DELETE`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/logs/log-delete/

👨‍💼 需要管理员权限（Admin）

DELETE``/`api`/`log`/``

### Response Body

$?

```
curl -X DELETE "https://ai-tokens.space/api/log/"
```

/$
Empty

---

## 获取所有日志 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/logs/log-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`log`/``

### Query Parameters

p?

integer

page_size?

integer

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/log/"
```

/$
Empty

---

## 搜索日志 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/logs/log-search-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`log`/`search`

### Query Parameters

keyword?

string

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/log/search"
```

/$
Empty

---

## 获取个人日志 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/logs/log-self-get/

🔐 需要登录（User权限）

GET``/`api`/`log`/`self`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/log/self"
```

/$
Empty

---

## 搜索个人日志 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/logs/log-self-search-get/

🔐 需要登录（User权限）

GET``/`api`/`log`/`self`/`search`

### Query Parameters

keyword?

string

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/log/self/search"
```

/$
Empty

---

## 获取个人日志统计 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/logs/log-self-stat-get/

🔐 需要登录（User权限）

GET``/`api`/`log`/`self`/`stat`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/log/self/stat"
```

/$
Empty

---

## 获取日志统计 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/logs/log-stat-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`log`/`stat`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/log/stat"
```

/$
Empty

---

## 通过令牌获取日志 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/logs/log-token-get/

🔓 无需鉴权（通过令牌查询）

GET``/`api`/`log`/`token`

### Query Parameters

key?

string

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/log/token"
```

/$
Empty

---

## 获取所有模型元数据 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/model-management/models-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`models`/``

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/models/"
```

/$
Empty

---

## 删除模型 [`DELETE`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/model-management/models-id-delete/

👨‍💼 需要管理员权限（Admin）

DELETE``/`api`/`models`/`{id}`

### Path Parameters

id*

integer

### Response Body

$?

```
curl -X DELETE "https://ai-tokens.space/api/models/0"
```

/$
Empty

---

## 获取指定模型 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/model-management/models-id-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`models`/`{id}`

### Path Parameters

id*

integer

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/models/0"
```

/$
Empty

---

## 获取缺失模型 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/model-management/models-missing-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`models`/`missing`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/models/missing"
```

/$
Empty

---

## 创建模型元数据 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/model-management/models-post/

👨‍💼 需要管理员权限（Admin）

POST``/`api`/`models`/``

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/models/"
```

/$
Empty

---

## 更新模型元数据 [`PUT`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/model-management/models-put/

👨‍💼 需要管理员权限（Admin）

PUT``/`api`/`models`/``

### Response Body

$?

```
curl -X PUT "https://ai-tokens.space/api/models/"
```

/$
Empty

---

## 搜索模型 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/model-management/models-search-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`models`/`search`

### Query Parameters

keyword?

string

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/models/search"
```

/$
Empty

---

## 同步上游模型 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/model-management/models-sync_upstream-post/

👨‍💼 需要管理员权限（Admin）

POST``/`api`/`models`/`sync_upstream`

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/models/sync_upstream"
```

/$
Empty

---

## 预览上游模型同步 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/model-management/models-sync_upstream-preview-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`models`/`sync_upstream`/`preview`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/models/sync_upstream/preview"
```

/$
Empty

---

## Discord OAuth登录 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/oauth/oauth-discord-get/

🔓 无需鉴权（OAuth回调）

GET``/`api`/`oauth`/`discord`

### Query Parameters

code?

string

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/oauth/discord"
```

/$
Empty

---

## 绑定邮箱 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/oauth/oauth-email-bind-get/

🔓 无需鉴权

GET``/`api`/`oauth`/`email`/`bind`

### Query Parameters

email?

string

code?

string

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/oauth/email/bind"
```

/$
Empty

---

## GitHub OAuth登录 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/oauth/oauth-github-get/

🔓 无需鉴权（OAuth回调）

GET``/`api`/`oauth`/`github`

### Query Parameters

code?

string

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/oauth/github"
```

/$
Empty

---

## LinuxDO OAuth登录 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/oauth/oauth-linuxdo-get/

🔓 无需鉴权（OAuth回调）

GET``/`api`/`oauth`/`linuxdo`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/oauth/linuxdo"
```

/$
Empty

---

## OIDC登录 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/oauth/oauth-oidc-get/

🔓 无需鉴权（OAuth回调）

GET``/`api`/`oauth`/`oidc`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/oauth/oidc"
```

/$
Empty

---

## 生成OAuth State [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/oauth/oauth-state-get/

🔓 无需鉴权

GET``/`api`/`oauth`/`state`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/oauth/state"
```

/$
Empty

---

## 绑定Telegram [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/oauth/oauth-telegram-bind-get/

🔓 无需鉴权

GET``/`api`/`oauth`/`telegram`/`bind`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/oauth/telegram/bind"
```

/$
Empty

---

## Telegram登录 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/oauth/oauth-telegram-login-get/

🔓 无需鉴权（OAuth回调）

GET``/`api`/`oauth`/`telegram`/`login`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/oauth/telegram/login"
```

/$
Empty

---

## 绑定微信 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/oauth/oauth-wechat-bind-get/

🔓 无需鉴权

GET``/`api`/`oauth`/`wechat`/`bind`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/oauth/wechat/bind"
```

/$
Empty

---

## 微信OAuth登录 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/oauth/oauth-wechat-get/

🔓 无需鉴权（OAuth回调）

GET``/`api`/`oauth`/`wechat`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/oauth/wechat"
```

/$
Empty

---

## Creem Webhook [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/payment/creem-webhook-post/

🔓 无需鉴权（Webhook回调）

POST``/`api`/`creem`/`webhook`

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/creem/webhook"
```

/$
Empty

---

## Stripe Webhook [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/payment/stripe-webhook-post/

🔓 无需鉴权（Webhook回调）

POST``/`api`/`stripe`/`webhook`

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/stripe/webhook"
```

/$
Empty

---

## 获取支付金额 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/payment/user-amount-post/

🔐 需要登录（User权限）

POST``/`api`/`user`/`amount`

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/user/amount"
```

/$
Empty

---

## 发起Creem支付 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/payment/user-creem-pay-post/

🔐 需要登录（User权限）

POST``/`api`/`user`/`creem`/`pay`

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/user/creem/pay"
```

/$
Empty

---

## 易支付回调 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/payment/user-epay-notify-get/

🔓 无需鉴权（支付回调）

GET``/`api`/`user`/`epay`/`notify`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/user/epay/notify"
```

/$
Empty

---

## 发起易支付 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/payment/user-pay-post/

🔐 需要登录（User权限）

POST``/`api`/`user`/`pay`

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/user/pay"
```

/$
Empty

---

## 获取Stripe支付金额 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/payment/user-stripe-amount-post/

🔐 需要登录（User权限）

POST``/`api`/`user`/`stripe`/`amount`

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/user/stripe/amount"
```

/$
Empty

---

## 发起Stripe支付 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/payment/user-stripe-pay-post/

🔐 需要登录（User权限）

POST``/`api`/`user`/`stripe`/`pay`

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/user/stripe/pay"
```

/$
Empty

---

## 获取充值信息 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/payment/user-topup-info-get/

🔐 需要登录（User权限）

GET``/`api`/`user`/`topup`/`info`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/user/topup/info"
```

/$
Empty

---

## 获取用户充值记录 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/payment/user-topup-self-get/

🔐 需要登录（User权限）

GET``/`api`/`user`/`topup`/`self`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/user/topup/self"
```

/$
Empty

---

## 获取所有兑换码 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/redemption/redemption-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`redemption`/``

### Query Parameters

p?

integer

page_size?

integer

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/redemption/"
```

/$
Empty

---

## 删除兑换码 [`DELETE`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/redemption/redemption-id-delete/

👨‍💼 需要管理员权限（Admin）

DELETE``/`api`/`redemption`/`{id}`

### Path Parameters

id*

integer

### Response Body

$?

```
curl -X DELETE "https://ai-tokens.space/api/redemption/0"
```

/$
Empty

---

## 获取指定兑换码 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/redemption/redemption-id-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`redemption`/`{id}`

### Path Parameters

id*

integer

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/redemption/0"
```

/$
Empty

---

## 删除无效兑换码 [`DELETE`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/redemption/redemption-invalid-delete/

👨‍💼 需要管理员权限（Admin）

DELETE``/`api`/`redemption`/`invalid`

### Response Body

$?

```
curl -X DELETE "https://ai-tokens.space/api/redemption/invalid"
```

/$
Empty

---

## 创建兑换码 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/redemption/redemption-post/

👨‍💼 需要管理员权限（Admin）

POST``/`api`/`redemption`/``

### Request Body

application/json

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/redemption/" \  -H "Content-Type: application/json" \  -d '{}'
```

/$
Empty

---

## 更新兑换码 [`PUT`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/redemption/redemption-put/

👨‍💼 需要管理员权限（Admin）

PUT``/`api`/`redemption`/``

### Request Body

application/json

### Response Body

$?

```
curl -X PUT "https://ai-tokens.space/api/redemption/" \  -H "Content-Type: application/json" \  -d '{}'
```

/$
Empty

---

## 搜索兑换码 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/redemption/redemption-search-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`redemption`/`search`

### Query Parameters

keyword?

string

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/redemption/search"
```

/$
Empty

---

## 通用安全验证 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/security-verification/verify-post/

🔐 需要登录（User权限）

POST``/`api`/`verify`

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/verify"
```

/$
Empty

---

## 获取验证状态 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/security-verification/verify-status-get/

🔐 需要登录（User权限）

GET``/`api`/`verify`/`status`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/verify/status"
```

/$
Empty

---

## 获取所有额度数据 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/statistics/data-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`data`/``

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/data/"
```

/$
Empty

---

## 获取个人额度数据 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/statistics/data-self-get/

🔐 需要登录（User权限）

GET``/`api`/`data`/`self`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/data/self"
```

/$
Empty

---

## 获取关于信息 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/system/about-get/

🔓 无需鉴权

GET``/`api`/`about`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/about"
```

/$
Empty

---

## 获取首页内容 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/system/home_page_content-get/

🔓 无需鉴权

GET``/`api`/`home_page_content`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/home_page_content"
```

/$
Empty

---

## 获取模型列表 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/system/models-get/

🔐 需要登录（User权限）

GET``/`api`/`models`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/models"
```

/$
Empty

---

## 获取公告 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/system/notice-get/

🔓 无需鉴权

GET``/`api`/`notice`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/notice"
```

/$
Empty

---

## 获取定价信息 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/system/pricing-get/

🔓 无需鉴权（可选登录）

GET``/`api`/`pricing`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/pricing"
```

/$
Empty

---

## 获取隐私政策 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/system/privacy-policy-get/

🔓 无需鉴权

GET``/`api`/`privacy-policy`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/privacy-policy"
```

/$
Empty

---

## 获取倍率配置 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/system/ratio_config-get/

🔓 无需鉴权

GET``/`api`/`ratio_config`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/ratio_config"
```

/$
Empty

---

## 获取初始化状态 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/system/setup-get/

🔓 无需鉴权

GET``/`api`/`setup`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/setup"
```

/$
Empty

---

## 初始化系统 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/system/setup-post/

🔓 无需鉴权

POST``/`api`/`setup`

### Request Body

application/json

username?

string

password?

string

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/setup" \  -H "Content-Type: application/json" \  -d '{}'
```

/$
Empty

---

## 获取系统状态 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/system/status-get/

🔓 无需鉴权

GET``/`api`/`status`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/status"
```

/$
Empty

---

## 测试系统状态 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/system/status-test-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`status`/`test`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/status/test"
```

/$
Empty

---

## 获取Uptime Kuma状态 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/system/uptime-status-get/

🔓 无需鉴权

GET``/`api`/`uptime`/`status`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/uptime/status"
```

/$
Empty

---

## 获取用户协议 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/system/user-agreement-get/

🔓 无需鉴权

GET``/`api`/`user-agreement`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/user-agreement"
```

/$
Empty

---

## 获取系统选项 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/system-settings/option-get/

👑 需要超级管理员权限（Root）

GET``/`api`/`option`/``

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/option/"
```

/$
Empty

---

## 迁移控制台设置 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/system-settings/option-migrate_console_setting-post/

👑 需要超级管理员权限（Root）

POST``/`api`/`option`/`migrate_console_setting`

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/option/migrate_console_setting"
```

/$
Empty

---

## 更新系统选项 [`PUT`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/system-settings/option-put/

👑 需要超级管理员权限（Root）

PUT``/`api`/`option`/``

### Response Body

$?

```
curl -X PUT "https://ai-tokens.space/api/option/"
```

/$
Empty

---

## 重置模型倍率 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/system-settings/option-rest_model_ratio-post/

👑 需要超级管理员权限（Root）

POST``/`api`/`option`/`rest_model_ratio`

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/option/rest_model_ratio"
```

/$
Empty

---

## 获取可同步渠道 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/system-settings/ratio_sync-channels-get/

👑 需要超级管理员权限（Root）

GET``/`api`/`ratio_sync`/`channels`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/ratio_sync/channels"
```

/$
Empty

---

## 获取上游倍率 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/system-settings/ratio_sync-fetch-post/

👑 需要超级管理员权限（Root）

POST``/`api`/`ratio_sync`/`fetch`

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/ratio_sync/fetch"
```

/$
Empty

---

## 获取所有Midjourney任务 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/tasks/mj-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`mj`/``

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/mj/"
```

/$
Empty

---

## 获取个人Midjourney任务 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/tasks/mj-self-get/

🔐 需要登录（User权限）

GET``/`api`/`mj`/`self`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/mj/self"
```

/$
Empty

---

## 获取所有任务 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/tasks/task-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`task`/``

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/task/"
```

/$
Empty

---

## 获取个人任务 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/tasks/task-self-get/

🔐 需要登录（User权限）

GET``/`api`/`task`/`self`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/task/self"
```

/$
Empty

---

## 批量删除令牌 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/token-management/token-batch-post/

🔐 需要登录（User权限）

POST``/`api`/`token`/`batch`

### Request Body

application/json

ids?

array<integer>

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/token/batch" \  -H "Content-Type: application/json" \  -d '{}'
```

/$
Empty

---

## 获取所有令牌 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/token-management/token-get/

🔐 需要登录（User权限）

GET``/`api`/`token`/``

### Query Parameters

p?

integer

page_size?

integer

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/token/"
```

/$
Empty

---

## 删除令牌 [`DELETE`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/token-management/token-id-delete/

🔐 需要登录（User权限）

DELETE``/`api`/`token`/`{id}`

### Path Parameters

id*

integer

### Response Body

$?

```
curl -X DELETE "https://ai-tokens.space/api/token/0"
```

/$
Empty

---

## 获取指定令牌 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/token-management/token-id-get/

🔐 需要登录（User权限）

GET``/`api`/`token`/`{id}`

### Path Parameters

id*

integer

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/token/0"
```

/$
Empty

---

## 创建令牌 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/token-management/token-post/

🔐 需要登录（User权限）

POST``/`api`/`token`/``

### Request Body

application/json

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/token/" \  -H "Content-Type: application/json" \  -d '{}'
```

/$
Empty

---

## 更新令牌 [`PUT`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/token-management/token-put/

🔐 需要登录（User权限）

PUT``/`api`/`token`/``

### Request Body

application/json

### Response Body

$?

```
curl -X PUT "https://ai-tokens.space/api/token/" \  -H "Content-Type: application/json" \  -d '{}'
```

/$
Empty

---

## 搜索令牌 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/token-management/token-search-get/

🔐 需要登录（User权限）

GET``/`api`/`token`/`search`

### Query Parameters

keyword?

string

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/token/search"
```

/$
Empty

---

## 获取令牌使用情况 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/token-management/usage-token-get/

🔑 需要令牌认证（TokenAuth）

GET``/`api`/`usage`/`token`/``

### Authorization

BearerAuth

Authorization

Bearer <token>

使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

In: `header`

### Header Parameters

Authorization?

string

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/usage/token/"
```

/$
Empty

---

## 重新生成备用码 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/two-factor-auth/user-2fa-backup_codes-post/

🔐 需要登录（User权限）

POST``/`api`/`user`/`2fa`/`backup_codes`

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/user/2fa/backup_codes"
```

/$
Empty

---

## 禁用2FA [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/two-factor-auth/user-2fa-disable-post/

🔐 需要登录（User权限）

POST``/`api`/`user`/`2fa`/`disable`

### Request Body

application/json

code?

string

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/user/2fa/disable" \  -H "Content-Type: application/json" \  -d '{}'
```

/$
Empty

---

## 启用2FA [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/two-factor-auth/user-2fa-enable-post/

🔐 需要登录（User权限）

POST``/`api`/`user`/`2fa`/`enable`

### Request Body

application/json

code?

string

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/user/2fa/enable" \  -H "Content-Type: application/json" \  -d '{}'
```

/$
Empty

---

## 设置2FA [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/two-factor-auth/user-2fa-setup-post/

🔐 需要登录（User权限）

POST``/`api`/`user`/`2fa`/`setup`

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/user/2fa/setup"
```

/$
Empty

---

## 获取2FA统计 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/two-factor-auth/user-2fa-stats-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`user`/`2fa`/`stats`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/user/2fa/stats"
```

/$
Empty

---

## 获取2FA状态 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/two-factor-auth/user-2fa-status-get/

🔐 需要登录（User权限）

GET``/`api`/`user`/`2fa`/`status`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/user/2fa/status"
```

/$
Empty

---

## 发送密码重置邮件 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-auth/reset_password-get/

🔓 无需鉴权

GET``/`api`/`reset_password`

### Query Parameters

email*

string

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/reset_password?email=string"
```

/$
Empty

---

## 获取用户分组列表 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-auth/user-groups-get/

🔓 无需鉴权

GET``/`api`/`user`/`groups`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/user/groups"
```

/$
Empty

---

## 两步验证登录 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-auth/user-login-2fa-post/

🔓 无需鉴权（登录流程）

POST``/`api`/`user`/`login`/`2fa`

### Request Body

application/json

code?

string

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/user/login/2fa" \  -H "Content-Type: application/json" \  -d '{}'
```

/$
Empty

---

## 用户登录 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-auth/user-login-post/

🔓 无需鉴权

POST``/`api`/`user`/`login`

### Request Body

application/json

username?

string

password?

string

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/user/login" \  -H "Content-Type: application/json" \  -d '{}'
```

/$
Empty

---

## 用户登出 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-auth/user-logout-get/

🔓 无需鉴权

GET``/`api`/`user`/`logout`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/user/logout"
```

/$
Empty

---

## 开始Passkey登录 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-auth/user-passkey-login-begin-post/

🔓 无需鉴权

POST``/`api`/`user`/`passkey`/`login`/`begin`

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/user/passkey/login/begin"
```

/$
Empty

---

## 完成Passkey登录 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-auth/user-passkey-login-finish-post/

🔓 无需鉴权

POST``/`api`/`user`/`passkey`/`login`/`finish`

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/user/passkey/login/finish"
```

/$
Empty

---

## 用户注册 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-auth/user-register-post/

🔓 无需鉴权

POST``/`api`/`user`/`register`

### Request Body

application/json

username?

string

password?

string

email?

string

verification_code?

string

aff_code?

string

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/user/register" \  -H "Content-Type: application/json" \  -d '{}'
```

/$
Empty

---

## 重置密码 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-auth/user-reset-post/

🔓 无需鉴权

POST``/`api`/`user`/`reset`

### Request Body

application/json

email?

string

token?

string

password?

string

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/user/reset" \  -H "Content-Type: application/json" \  -d '{}'
```

/$
Empty

---

## 发送邮箱验证码 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-auth/verification-get/

🔓 无需鉴权

GET``/`api`/`verification`

### Query Parameters

email*

string

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/verification?email=string"
```

/$
Empty

---

## 转换邀请额度 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-management/user-aff_transfer-post/

🔐 需要登录（User权限）

POST``/`api`/`user`/`aff_transfer`

### Request Body

application/json

quota?

integer

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/user/aff_transfer" \  -H "Content-Type: application/json" \  -d '{}'
```

/$
Empty

---

## 获取邀请码 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-management/user-aff-get/

🔐 需要登录（User权限）

GET``/`api`/`user`/`aff`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/user/aff"
```

/$
Empty

---

## 获取所有用户 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-management/user-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`user`/``

### Query Parameters

p?

integer

page_size?

integer

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/user/"
```

/$
Empty

---

## 管理员禁用用户2FA [`DELETE`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-management/user-id-2fa-delete/

👨‍💼 需要管理员权限（Admin）

DELETE``/`api`/`user`/`{id}`/`2fa`

### Path Parameters

id*

integer

### Response Body

$?

```
curl -X DELETE "https://ai-tokens.space/api/user/0/2fa"
```

/$
Empty

---

## 删除用户 [`DELETE`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-management/user-id-delete/

👨‍💼 需要管理员权限（Admin）

DELETE``/`api`/`user`/`{id}`

### Path Parameters

id*

integer

### Response Body

$?

```
curl -X DELETE "https://ai-tokens.space/api/user/0"
```

/$
Empty

---

## 获取指定用户 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-management/user-id-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`user`/`{id}`

### Path Parameters

id*

integer

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/user/0"
```

/$
Empty

---

## 管理员重置用户Passkey [`DELETE`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-management/user-id-reset_passkey-delete/

👨‍💼 需要管理员权限（Admin）

DELETE``/`api`/`user`/`{id}`/`reset_passkey`

### Path Parameters

id*

integer

### Response Body

$?

```
curl -X DELETE "https://ai-tokens.space/api/user/0/reset_passkey"
```

/$
Empty

---

## 管理用户状态 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-management/user-manage-post/

👨‍💼 需要管理员权限（Admin）

POST``/`api`/`user`/`manage`

### Request Body

application/json

id?

integer

action?

string

Value in

"disable" | "enable" | "delete" | "promote" | "demote"

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/user/manage" \  -H "Content-Type: application/json" \  -d '{}'
```

/$
Empty

---

## 获取用户可用模型 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-management/user-models-get/

🔐 需要登录（User权限）

GET``/`api`/`user`/`models`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/user/models"
```

/$
Empty

---

## 删除Passkey [`DELETE`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-management/user-passkey-delete/

🔐 需要登录（User权限）

DELETE``/`api`/`user`/`passkey`

### Response Body

$?

```
curl -X DELETE "https://ai-tokens.space/api/user/passkey"
```

/$
Empty

---

## 获取Passkey状态 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-management/user-passkey-get/

🔐 需要登录（User权限）

GET``/`api`/`user`/`passkey`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/user/passkey"
```

/$
Empty

---

## 开始注册Passkey [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-management/user-passkey-register-begin-post/

🔐 需要登录（User权限）

POST``/`api`/`user`/`passkey`/`register`/`begin`

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/user/passkey/register/begin"
```

/$
Empty

---

## 完成注册Passkey [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-management/user-passkey-register-finish-post/

🔐 需要登录（User权限）

POST``/`api`/`user`/`passkey`/`register`/`finish`

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/user/passkey/register/finish"
```

/$
Empty

---

## 开始验证Passkey [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-management/user-passkey-verify-begin-post/

🔐 需要登录（User权限）

POST``/`api`/`user`/`passkey`/`verify`/`begin`

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/user/passkey/verify/begin"
```

/$
Empty

---

## 完成验证Passkey [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-management/user-passkey-verify-finish-post/

🔐 需要登录（User权限）

POST``/`api`/`user`/`passkey`/`verify`/`finish`

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/user/passkey/verify/finish"
```

/$
Empty

---

## 创建用户 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-management/user-post/

👨‍💼 需要管理员权限（Admin）

POST``/`api`/`user`/``

### Request Body

application/json

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/user/" \  -H "Content-Type: application/json" \  -d '{}'
```

/$
Empty

---

## 更新用户 [`PUT`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-management/user-put/

👨‍💼 需要管理员权限（Admin）

PUT``/`api`/`user`/``

### Request Body

application/json

### Response Body

$?

```
curl -X PUT "https://ai-tokens.space/api/user/" \  -H "Content-Type: application/json" \  -d '{}'
```

/$
Empty

---

## 搜索用户 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-management/user-search-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`user`/`search`

### Query Parameters

keyword?

string

group?

string

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/user/search"
```

/$
Empty

---

## 注销当前用户 [`DELETE`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-management/user-self-delete/

🔐 需要登录（User权限）

DELETE``/`api`/`user`/`self`

### Response Body

$?

```
curl -X DELETE "https://ai-tokens.space/api/user/self"
```

/$
Empty

---

## 获取当前用户信息 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-management/user-self-get/

🔐 需要登录（User权限）

GET``/`api`/`user`/`self`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/user/self"
```

/$
Empty

---

## 获取当前用户分组 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-management/user-self-groups-get/

🔐 需要登录（User权限）

GET``/`api`/`user`/`self`/`groups`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/user/self/groups"
```

/$
Empty

---

## 更新当前用户信息 [`PUT`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-management/user-self-put/

🔐 需要登录（User权限）

PUT``/`api`/`user`/`self`

### Request Body

application/json

username?

string

display_name?

string

password?

string

original_password?

string

### Response Body

$?

```
curl -X PUT "https://ai-tokens.space/api/user/self" \  -H "Content-Type: application/json" \  -d '{}'
```

/$
Empty

---

## 更新用户设置 [`PUT`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-management/user-setting-put/

🔐 需要登录（User权限）

PUT``/`api`/`user`/`setting`

### Request Body

application/json

notify_type?

string

quota_warning_threshold?

number

webhook_url?

string

notification_email?

string

### Response Body

$?

```
curl -X PUT "https://ai-tokens.space/api/user/setting" \  -H "Content-Type: application/json" \  -d '{}'
```

/$
Empty

---

## 生成访问令牌 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-management/user-token-get/

🔐 需要登录（User权限）

GET``/`api`/`user`/`token`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/user/token"
```

/$
Empty

---

## 管理员完成充值 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-management/user-topup-complete-post/

👨‍💼 需要管理员权限（Admin）

POST``/`api`/`user`/`topup`/`complete`

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/user/topup/complete"
```

/$
Empty

---

## 获取所有充值记录 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/user-management/user-topup-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`user`/`topup`

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/user/topup"
```

/$
Empty

---

## 获取所有供应商 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/vendors/vendors-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`vendors`/``

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/vendors/"
```

/$
Empty

---

## 删除供应商 [`DELETE`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/vendors/vendors-id-delete/

👨‍💼 需要管理员权限（Admin）

DELETE``/`api`/`vendors`/`{id}`

### Path Parameters

id*

integer

### Response Body

$?

```
curl -X DELETE "https://ai-tokens.space/api/vendors/0"
```

/$
Empty

---

## 获取指定供应商 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/vendors/vendors-id-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`vendors`/`{id}`

### Path Parameters

id*

integer

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/vendors/0"
```

/$
Empty

---

## 创建供应商 [`POST`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/vendors/vendors-post/

👨‍💼 需要管理员权限（Admin）

POST``/`api`/`vendors`/``

### Response Body

$?

```
curl -X POST "https://ai-tokens.space/api/vendors/"
```

/$
Empty

---

## 更新供应商 [`PUT`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/vendors/vendors-put/

👨‍💼 需要管理员权限（Admin）

PUT``/`api`/`vendors`/``

### Response Body

$?

```
curl -X PUT "https://ai-tokens.space/api/vendors/"
```

/$
Empty

---

## 搜索供应商 [`GET`]

文档链接：https://ai-tokens.space/v1/zh/docs/api/management/vendors/vendors-search-get/

👨‍💼 需要管理员权限（Admin）

GET``/`api`/`vendors`/`search`

### Query Parameters

keyword?

string

### Response Body

$?

```
curl -X GET "https://ai-tokens.space/api/vendors/search"
```

/$
Empty

---

# 九、帮助支持

## 帮助支持

文档链接：https://ai-tokens.space/v1/zh/docs/support/

### 获取帮助

邮箱 / Email：[myieker@gmail.com](mailto:myieker@gmail.com)

---

# 十、合规与可接受使用政策

## 合规与可接受使用政策

AI-Tkoens 项目的合规声明与可接受使用政策

文档链接：https://ai-tokens.space/v1/zh/docs/legal/acceptable-use/

在使用 AI-Tkoens 之前，请仔细阅读并理解本政策。

### 项目定位

AI-Tkoens 是面向合法授权场景的 AI API 网关与用量管理系统，默认面向自用、团队内部和企业私有化部署。核心能力包括：

- 企业内部统一鉴权与多模型路由
- 组织内用量统计与权限控制
- 成本分摊与企业客户账务管理
- 私有化部署与开发测试

### 合法授权要求

用户在使用 AI-Tkoens 时，必须满足以下要求：

- 合法取得上游 API Key、模型服务、支付服务和其他第三方服务授权
- 遵守上游服务条款和平台规则
- 遵守所在地法律法规和监管要求
- 遵守适用的 AI 治理框架和内容安全要求

### 使用边界

使用本项目时，应确保相关场景合法授权、合规可审计，并符合以下要求：

- 遵守上游服务条款和平台规则
- 遵守所在地法律法规和监管要求
- 遵守内容安全、公共安全、网络安全和权益保护要求
- 遵守上游内容政策和适用的 AI 治理要求

### 公众服务义务

如用户面向不特定公众提供生成式 AI 服务，应自行完成所在地法律法规要求的合规义务，包括但不限于：

- 备案与资质要求
- 内容安全审核与治理机制
- 身份管理与日志留存
- 税务与支付合规
- 消费者保护
- 上游授权与服务条款遵循

本项目默认面向自用、团队内部和企业私有化部署场景。对外提供服务所涉及的合规义务，由部署方自行承担。

### 密钥与渠道要求

- 上游渠道必须是部署方合法拥有或已获授权的账号、API Key、模型服务或企业合约
- 多密钥管理、负载均衡、故障切换等功能仅用于高可用和企业多账号管理
- 使用上述能力时，应遵守上游服务条款、平台规则和监管要求

### 支付与账务管理

支付、充值、兑换码、邀请等功能仅用于合法授权场景下的内部结算、企业客户账务或合规服务收费。部署方应确保相关服务、收费、推广和上游授权均符合所在地法律法规、上游服务条款和平台规则。

收款主体的税务、发票、消费者保护、支付风控等合规义务由部署方自行承担。

### 内容安全

部署方有义务确保通过本项目提供的服务符合内容安全要求。屏蔽词、日志记录、监控等功能应服务于内容安全、滥用治理和合规审计。面向公众服务应建立滥用举报、日志审计和处置机制。

### 社区治理

本项目社区讨论应围绕合法授权、合规部署和正当工程问题展开。issue、PR、discussion 应符合项目合规要求和社区规则，维护者将按规则处理不符合要求的内容。

### 维护者立场

AI-Tkoens 按"原样"提供，不提供任何形式的保证。维护者仅为合法合规使用场景提供技术讨论和社区支持，并可按社区规则处理不符合项目合规要求的 issue、PR、讨论和教程链接。开发者和维护者对使用本软件产生的任何损害或法律问题不承担责任。

---