基本概念 - 令牌
令牌，也就是 API Key，是你访问 VLX FLUX 接口时使用的身份凭证。程序在请求中附带这个令牌后，平台才能识别请求来源，并执行鉴权、计费、限流与日志记录。
一句话理解：账号用于登录平台，令牌用于程序调用接口。
令牌有什么用
- 身份鉴权：确认请求来自哪个用户。
- 请求授权：判断该令牌是否有权限调用对应接口或模型。
- 额度扣除：根据请求消耗扣除额度。
- 模型限制：限制可访问的模型或能力范围。
- 日志统计：记录请求时间、消耗量和状态码，便于排错。
如果请求未携带令牌，或令牌无效，接口通常会返回无权限错误。
管理入口
什么时候会用到令牌
当你把项目接入 VLX FLUX 时，就会用到令牌。常见场景包括：
- 在 OpenAI SDK 或兼容 SDK 中配置 API Key。
- 在服务器、脚本或终端工具中调用 VLX FLUX 接口。
- 为不同项目、团队成员、环境分配独立调用凭证。
- 按令牌统计某个业务的消耗情况。
不要把主令牌直接写在前端代码里，也不要泄露给终端用户。
如何在请求中使用令牌
大多数兼容 OpenAI 规范的接口会要求在 Authorization 请求头中传递令牌：
text
Authorization: Bearer YOUR_TOKEN例如，一个完整请求通常包含 API 地址和令牌：
bash
curl https://api.vlxflux.io/v1/chat/completions -H "Authorization: Bearer YOUR_TOKEN" -H "Content-Type: application/json" -d '{
"model": "gpt-3.5-turbo",
"messages": [
{ "role": "user", "content": "你好 / Hello" }
]
}'令牌额度
令牌可以单独设置额度或限制，用于控制该令牌最多可以消耗多少资金或资源。
常见策略包括：
- 不限制额度，直接使用账号可用余额。
- 设置总额度，用完后令牌自动停止调用。
- 设置周期额度，例如每日或每月上限。
- 设置单次请求或并发限制，降低异常风险。
创建令牌的建议
建议按用途拆分令牌，不要让所有项目共用同一个令牌。
推荐命名方式：
text
project-a-production
project-a-testing
team-b-bot这样做的好处：
- 快速定位请求来源。
- 某个项目停用时可以单独禁用对应令牌。
- 某个令牌泄露时更容易定位和隔离。
- 不同环境可以配置不同额度。
安全注意事项
- 不要提交到 GitHub、Gitee 等公开仓库。
- 不要发在公开文档、群聊或工单中。
- 不要写在浏览器前端代码中。
- 建议通过环境变量或加密服务注入后端。
- 一旦怀疑泄露，请立即禁用并重新创建新令牌。
常见问题
令牌和账号密码有什么区别？
账号密码用于登录平台，令牌用于程序调用接口。
一个账号可以创建多少个令牌？
通常可以创建多个，建议按项目、环境、用途拆分。
令牌泄露了怎么办？
请立即在管理页面禁用旧令牌，然后创建新令牌替换配置。
为什么我提供了令牌还是提示无权限？
常见原因包括令牌填错、已禁用、额度耗尽、缺少模型权限、API 地址配置错误或请求头格式不正确。