基本概念 - 令牌 🔑

令牌（也可以理解为 API Key）是调用 We-AI 接口时使用的访问凭证。程序在请求接口时携带令牌，平台会据此判断：这次请求是否允许访问、归属于哪个账号，以及应消耗哪一部分额度。

一句话理解：账号用于登录平台，令牌用于程序调用接口。

令牌有什么用 🧭

令牌是 API 调用链路中最关键的身份信息。平台通常会围绕令牌完成这些处理：

• 身份识别：确认请求来自哪个用户、团队或应用。
• 请求鉴权：判断令牌是否有效、是否有权限调用对应接口。
• 额度扣除：根据请求消耗，从账号或令牌额度中扣除用量。
• 模型限制：限制令牌可调用的模型或渠道范围。
• 日志统计：记录请求时间、消耗量、状态码、失败原因等信息。

如果请求未携带令牌，或令牌无效，接口通常会返回未授权错误。

管理端入口 🧩

令牌控制台

什么时候会用到令牌 ⏰

当你在自己的项目中接入 We-AI 时，就会用到令牌。常见场景包括：

• 在 OpenAI SDK、兼容 SDK 或请求库中配置 API Key。
• 在后端服务中调用 We-AI 接口。
• 为不同项目、成员、环境分配独立调用凭证。
• 通过令牌统计某个业务的接口消耗。

不建议把令牌直接写在网页前端代码中。前端代码会暴露给用户，一旦令牌泄露，其他人就可能盗用你的额度发起请求。

如何在请求中使用令牌 🛠️

大多数兼容 OpenAI 格式的接口，会通过 Authorization 请求头传递令牌：

Authorization: Bearer YOUR_TOKEN

其中 YOUR_TOKEN 需要替换为你在平台中创建的真实令牌。

例如，一个完整请求通常会同时包含 API 地址与令牌：

curl https://we-ai.cc/v1/chat/completions \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      { "role": "user", "content": "你好" }
    ]
  }'

令牌额度 💳

令牌可以关联额度限制。额度用于控制该令牌最多可消耗多少资源，避免单个项目异常调用时影响整个账号。

常见额度策略包括：

• 不限制额度，直接使用账号可用余额。
• 设置总额度，用完后令牌不可继续调用。
• 设置周期额度，例如每日或每月限制。
• 设置单次请求或并发限制，降低异常请求风险。

创建令牌的建议 ✅

创建令牌时，建议按用途拆分，不要让所有项目共用同一个令牌。

推荐命名方式：

project-a-production
project-a-testing
team-b-bot

这样做有几个好处：

• 日志中可以快速看出请求来源。
• 某个项目停用后，可单独禁用对应令牌。
• 某个令牌消耗异常时，更容易定位来源。
• 不同环境可配置不同额度，减少误操作成本。

安全注意事项 🔒

令牌属于敏感信息，请务必妥善保管：

• 不要提交到 GitHub、Gitee 等公开代码仓库。
• 不要贴在公开文档、截图、群聊或工单中。
• 不要在浏览器前端暴露高权限令牌。
• 建议通过环境变量或密钥管理服务保存令牌。
• 一旦怀疑泄露，应立即禁用旧令牌并创建新令牌。

常见问题 ❓

令牌和账号密码有什么区别？

账号密码主要用于登录平台后台；令牌主要用于程序调用接口。令牌通常不需要用户手动输入登录页面，而是由代码、SDK 或服务端配置读取。

一个账号可以创建多个令牌吗？

通常可以，也推荐这样做。你可以为不同项目、环境、成员分别创建令牌，便于管理权限、统计消耗、处理泄露风险。

令牌泄露了怎么办？

应先立即禁用或删除泄露令牌，再创建新令牌替换项目配置。随后检查调用日志，确认泄露期间是否出现异常消耗。

为什么明明填了令牌，还是提示无权限？

常见原因包括：令牌填错、令牌已禁用、额度不足、缺少对应模型权限、API 地址配置错误，或请求头格式不正确。可以先确认是否使用了 Authorization: Bearer YOUR_TOKEN 这一格式。