跳至主要内容

API Key 与认证

为模型调用选择正确凭证,安全保存并管理密钥。

个人模型 API Key

进入开放控制台的 API 密钥页,完成登录与页面要求的联系方式绑定。为个人模型调用创建具有 models:chat 权限的 PAYG Key。密钥明文只显示一次,请保存在您的密钥管理工具中。

API Credits 与会员余额分开。创建 Key 不保证模型已经开放或账户余额足够;在模型目录确认状态,再按页面提示准备 API 余额。

sh
# 在自己的终端安全设置,不提交到代码仓库。
export ACOSMI_API_KEY="YOUR_PERSONAL_PAYG_KEY"

模型 HTTP 请求使用:

text
Authorization: Bearer YOUR_PERSONAL_PAYG_KEY
Content-Type: application/json

x-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。错误处理说明了进一步动作。