认证与密钥
认证方式
所有 API 请求都要在请求头里带上令牌：
http
Authorization: Bearer sk-你的密钥除此之外不需要额外签名、不需要时间戳、不需要 IP 白名单。
和 OpenAI 完全一致
因为协议一致，任何支持自定义 OpenAI 接口的库或软件都能直接用。
令牌管理
登录控制台 →「令牌」页面：
| 字段 | 说明 |
|---|---|
| 名称 | 自己看的备注，建议按用途分（生产、测试、某某项目） |
| 额度 | 这个令牌最多能消耗多少，留空表示跟随账号总额度 |
| 过期时间 | 可选。到期自动失效，适合发给临时合作方 |
| 模型限制 | 可选。只允许调用指定模型，防止令牌泄露后被拿去跑别的 |
| 分组 | 决定可用模型范围和价格倍率，默认 default |
| IP 限制 | 可选。只允许指定 IP 使用该令牌 |
一个用途一个令牌
不要所有项目共用一个令牌。按项目拆开的好处：某个令牌泄露时只影响那一个项目，删掉重建就行；用量也能分开看。
密钥安全
- 服务端只存哈希，管理后台也看不到完整密钥，所以丢了找不回来，只能删除重建
- 不要把密钥写进前端代码、git 仓库、公开的 issue 或截图
- 用环境变量或密钥管理服务注入：
bash
export CYAN_API_KEY="sk-..."python
import os
api_key = os.environ["CYAN_API_KEY"]密钥泄露了怎么办
立刻去控制台把那个令牌删除（不是禁用，是删除），然后重新建一个。已泄露的令牌在删除前产生的消耗不退还，所以发现越早越好。
额度与计费
额度怎么算
- 账号有一个总额度，
1 美元 = 500000 额度单位（以控制台实际显示为准） - 每次调用按 token 数扣费：输入 token 按输入价，输出 token 按输出价
- 不同模型价格不同，控制台「模型价格」页面可以查
用完了会怎样
额度耗尽后调用返回 403，提示额度不足。充值后立即恢复，不用等。
怎么查用了多少
bash
curl "https://api.blueworkshop.top/api/data/self" \
-H "Authorization: Bearer <控制台登录后拿到的 access token>"这需要另一套凭证
/v1 下的接口用 API 令牌（sk- 开头）； /api 下的管理接口用登录后的会话 access token。两者不是一回事，别混用。
日常看用量建议直接看控制台的「数据看板」，能按天/小时看趋势，也能导出明细。
分组与模型可见性
账号属于某个分组（默认 default），分组决定：
- 你能调用哪些模型
- 这些模型的计费倍率
如果你的账号看不到某个模型，通常是分组权限问题，联系我们调整。