个人模型 API Key
进入开放控制台的 API 密钥页,完成登录与页面要求的联系方式绑定。为个人模型调用创建具有 models:chat 权限的 PAYG Key。密钥明文只显示一次,请保存在您的密钥管理工具中。
API Credits 与会员余额分开。创建 Key 不保证模型已经开放或账户余额足够;在模型目录确认状态,再按页面提示准备 API 余额。
# 在自己的终端安全设置,不提交到代码仓库。
export ACOSMI_API_KEY="YOUR_PERSONAL_PAYG_KEY"模型 HTTP 请求使用:
Authorization: Bearer YOUR_PERSONAL_PAYG_KEY
Content-Type: application/jsonx-api-key 属于独立的兼容认证开关;没有确认开放时使用上面的 Bearer 方式,不假定所有端点都接受所有认证头。
凭证用途
| 凭证 | 用途 | 注意 |
|---|---|---|
| 个人 PAYG Key | 个人按量模型 API | 使用 API Credits,须有对应 scope |
| 会员委托 Key | 服务端明确开放的会员委托调用 | 与 PAYG 不同,不自动获准 |
| 会员 OAuth / Acosmi SDK | 会员授权的 Agent、合规等能力 | 见独立教程 |
| 浏览器登录会话 | 控制台管理与本人记录 | 不复制会话 Token 充当模型 API Key |
保存、轮换与吊销
密钥仅放在应用服务端环境变量或密钥管理服务中,不嵌入前端 JavaScript、URL、截图或日志。控制台体验台只在当前页面内存使用粘贴的 Key,刷新或切换账户后需重新提供。
轮换后旧 Key 不再准入新请求;清空输入框不等于吊销。历史请求与费用仍可在本人记录中查询。丢失或暴露 Key 时在密钥页吊销,再创建替代凭证。
遇到 401/403 先检查密钥、有效期与权限,不自动重发付费 POST。错误处理说明了进一步动作。