用户指南

欢迎使用 Tokence 一站式 AI API 聚合网关平台。本文档将帮助您快速了解并上手 Tokence 的各项功能，从注册登录到 API 调用，从配额管理到账单查询，全方位指引您高效使用平台服务。

💡 提示：您可以通过左侧导航快速跳转到对应章节，也可以直接向下滚动浏览全部内容。

注册与登录

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

登录

账号密码登录

  1. 打开平台首页，点击右上角「登录」按钮，或直接访问 /login
  2. 在登录页输入用户名和密码
  3. 点击「登录」完成登录

第三方 OAuth 登录

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

忘记密码

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

注册

注册流程

  1. 在登录页点击「注册」链接，或直接访问 /register
  2. 填写用户名、密码
  3. 填写邮箱地址，点击「发送验证码」，将收到的验证码填入输入框
  4. 点击「注册」完成账号创建，注册成功后自动跳转至首页
⚠️ 请使用真实有效的邮箱注册，以便接收验证码、找回密码及接收重要通知。

个人设置

登录后，点击右上角头像进入「个人中心」，可管理您的账户信息、安全设置与偏好配置。

基础资料

  • 昵称与头像：自定义显示名称与头像，展示在控制台与工单系统中
  • 邮箱与手机号：绑定的联系方式，用于安全验证与通知推送
  • 密码修改：定期更换密码，提升账户安全性

安全设置

  • 两步验证（2FA）：开启后登录需输入动态验证码，大幅提升账户安全
  • 登录日志：查看近期所有登录记录，识别异常登录行为
  • API 密钥权限：配置密钥的访问 IP 白名单、模型权限与速率限制

个性化设置

  • 系统名称：自定义控制台显示的系统标题
  • 主题模式：支持浅色 / 深色 / 跟随系统三种显示模式
  • 语言：切换简体中文、英文等界面语言

关于页面

在「关于」页面可查看当前 Tokence 系统版本、更新日志与官方联系方式。

令牌管理

API 令牌（Token）是您调用 Tokence 接口的身份凭证，请妥善保管，切勿泄露给他人。

创建令牌

  1. 进入控制台 → 令牌管理 → 点击「新建令牌」
  2. 填写令牌名称（便于识别用途，如「生产环境」「测试环境」）
  3. 设置过期时间（可选，建议定期轮换）
  4. 选择可用模型范围与速率限制
  5. 点击「创建」，复制并保存令牌值
⚠️ 令牌仅在创建时显示一次，关闭后无法再次查看。请立即保存到安全的位置。如不慎泄露，请立即删除该令牌并重新创建。

令牌权限控制

  • 模型白名单：指定该令牌可调用的模型，未勾选的模型将被拒绝
  • IP 白名单：限制仅指定 IP 地址可使用该令牌调用接口
  • 速率限制：设置每分钟 / 每秒最大请求次数，防止异常消耗
  • 额度限制：设置该令牌的累计最大消耗额度

令牌管理操作

  • 编辑：修改令牌名称、权限与过期时间
  • 禁用 / 启用：临时停用令牌，不删除配置
  • 删除：永久销毁令牌，删除后不可恢复

使用 API

Tokence 兼容 OpenAI 格式的 API 接口，您只需将原有的接口地址与密钥替换为 Tokence 的地址，即可一键接入所有支持的模型。

接口地址

API 基准地址：https://ai.tokence.co/v1

快速调用示例

curl https://ai.tokence.co/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxx" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "你好"}
    ]
  }'

支持的接口

  • 对话补全：/v1/chat/completions
  • 文本补全：/v1/completions
  • 图像生成：/v1/images/generations
  • 嵌入向量：/v1/embeddings
  • 语音合成：/v1/audio/speech
  • 语音识别：/v1/audio/transcriptions
  • 模型列表：/v1/models

模型名称

在控制台「模型列表」页面可查看所有已上线模型的名称、定价与状态。调用时请使用完整的模型 ID。

💡 如果您的原有代码对接的是 OpenAI 官方接口，只需修改 base_url 和 api_key 两处即可无缝切换到 Tokence，无需修改其他逻辑。

定价

Tokence 采用按量计费模式，按实际 Token 消耗量扣费，无最低消费，无月费门槛。

计费规则

  • 计费单位：千 Token（1000 tokens）
  • 区分输入（Prompt）与输出（Completion）分别计费
  • 计费精度保留 4 位小数，实时扣减账户余额
  • 调用失败、报错、被风控拦截的请求不收取费用

价格查询

您可以通过以下方式查看最新定价：

  1. 控制台首页「定价」页面
  2. 模型列表中每个模型对应的单价标注
  3. 调用接口返回的 Header 中包含本次消耗信息

价格调整

Tokence 有权根据上游成本变化调整服务定价，调整前将通过站内公告提前通知。价格调整后，新产生的调用按新价格计费，已充值的余额不受影响。

使用记录

在「使用记录」页面，您可以查询所有 API 调用明细，实时掌握消费情况。

记录内容

  • 调用时间：精确到秒的请求时间戳
  • 模型名称：本次调用使用的具体模型
  • Token 消耗：输入、输出及总 Token 数量
  • 费用：本次调用扣除的金额
  • 令牌标识：使用的 API 密钥名称
  • 状态：成功 / 失败及对应的错误码

筛选与导出

  • 支持按时间范围、模型、令牌、状态等维度筛选
  • 支持导出 CSV 格式账单，便于对账与财务核算
  • 支持按日 / 周 / 月查看用量统计趋势图
💡 调用日志默认保留 30 天，如需长期留存请及时导出备份。

配额与充值

Tokence 采用预付费模式，您需要先向账户充值额度，调用时实时从余额中扣减。

余额查询

控制台顶部实时显示当前账户可用余额，点击可查看近期充值与消费明细。

在线充值

  1. 进入「钱包」页面，点击「充值」
  2. 输入充值金额（支持自定义金额）
  3. 选择支付方式，完成支付
  4. 支付成功后额度实时到账

充值规则

  • 充值额度为虚拟服务资源，充值成功后自动绑定至您的账户
  • 额度不可转让、不可兑现、不可转移至其他账户
  • 账户额度自充值到账之日起有效期 12 个月，逾期未使用将自动清零
  • 除法律法规另有规定外，充值成功后不支持退款

欠费处理

当账户余额不足时，API 调用将自动停止。请及时充值以避免服务中断。如产生欠费，您需结清欠款后方可继续使用；逾期未结清的，我们有权按日收取万分之五的违约金。

⚠️ 由于网络延迟或并发请求原因，账户余额可能出现短暂负数，属于正常现象，系统会在稍后自动结算。

订阅计划

除按量计费外，Tokence 提供多种包月订阅计划，适合稳定用量的企业用户，性价比更高。

计划等级

  • 基础版：适合个人开发者与小型项目，包含固定额度与标准速率
  • 专业版：适合中小团队，更高并发限额与优先响应支持
  • 企业版：适合企业级用户，专属线路、SLA 保障与一对一技术支持

订阅权益

  • 每月固定 Token 额度，当月有效，过期清零
  • 更高的并发请求数与 QPS 上限
  • 优先使用稳定线路，延迟更低
  • 企业版支持定制模型、专属部署与合同发票

开通与续费

在「订阅」页面选择对应计划开通，支持按月 / 按年付费。订阅到期前自动续费，您也可以随时取消自动续费。

任务管理

对于异步类任务（如图像生成、批量处理、微调训练等），您可以在「任务管理」页面查看任务状态与结果。

任务类型

  • 图像生成任务：AI 绘图、图片扩图、图生图等
  • 批量处理任务：批量文本 embedding、批量内容审核等
  • 模型微调任务：自定义模型训练与微调作业

任务状态

  • 排队中：任务已提交，等待执行
  • 处理中：任务正在运行
  • 已完成：任务执行成功，可下载结果
  • 失败：任务执行失败，可查看失败原因并重试

结果保存

任务完成后，结果文件默认保留 7 天，请及时下载保存。逾期文件将被自动清理，无法恢复。

💡 长时间未完成的任务可能已异常终止，您可以提交工单联系客服排查处理。
最后更新于 2026 年 7 月