跳到主要内容

认证

模型接口使用独立的 YiJue.ai API Key 认证。控制台登录会话与模型 API Key 作用域分离:登录 Cookie 不能调用 /v1/*,模型 Key 也不能管理账号。

邀请制注册​

生产环境开放注册入口,但必须提交有效的一次性邀请码:

  • 没有邀请码不能注册;每个邀请码只能成功兑换一次。
  • 注册成功时账户获得 8.00 USD 试用额度,试用期从兑换成功时起持续 7 天。
  • 试用账户只能调用管理员配置的全局试用白名单模型;普通上架模型不会自动开放 给试用账户。

邀请码只用于创建账户,不是模型 API Key。注册并登录后,仍需在控制台单独创建 API Key。本次邀请制试用不包含 Stripe Checkout、在线支付或自动充值;余额入口 只用于联系管理员。

Bearer 认证​

OpenAI 兼容接口使用:

Authorization: Bearer 你的_YIJUE_API_KEY
curl https://yijue.ai/v1/models \
-H "Authorization: Bearer ${YIJUE_API_KEY}"

Anthropic 认证​

/v1/messages 接受以下任一种形式:

x-api-key: 你的_YIJUE_API_KEY

或:

Authorization: Bearer 你的_YIJUE_API_KEY

如果同时发送两个头,它们必须包含同一个 Key。YiJue 的 Claude Code 一键配置 使用 ANTHROPIC_AUTH_TOKEN,因此发送 Bearer 认证。

Key 生命周期​

  1. 在控制台创建 Key,完整值只显示一次。
  2. 按设备或应用分别创建,便于定位和撤销。
  3. 服务端仅保存不可逆摘要。
  4. 不再使用或怀疑泄露时,在控制台立即吊销。

不要这样传递 Key​

  • 不要放在 URL 查询参数中。
  • 不要写入 Git 仓库或 Docker 镜像。
  • 不要作为命令行参数传递。
  • 不要粘贴到客服工单、截图或群聊。

推荐通过进程环境变量、部署平台的 Secret 管理器,或使用 Claude Code 一键配置。一键配置会把 Key 写入权限为 0600 的本机 Claude 设置,以兼容启动阶段的动态模型发现。

常见认证错误​

HTTP错误说明
401invalid_api_key / authentication_errorKey 缺失、错误或已吊销
403permission_error当前凭据没有请求所需的权限
400invalid_request_errorAnthropic 双鉴权头不一致或请求格式错误