身份验证

Arona API 使用 API Key 鉴权。所有网关请求都必须携带有效密钥。

鉴权方式

在 HTTP 请求头中加入：

Authorization: Bearer YOUR_API_KEY

获取 API Key

登录控制台
打开 API Keys / 密钥
点击创建，复制密钥并离线保存

不要把 API Key 写进前端页面、公开仓库、截图或聊天记录。推荐使用环境变量。

推荐的环境变量

变量名	用途
`ARONA_API_KEY`	通用客户端 / 脚本
`XAI_API_KEY`	部分 Grok 兼容客户端会读取
`OPENAI_API_KEY`	OpenAI SDK / Codex 常见读取名
`ANTHROPIC_AUTH_TOKEN`	Claude Code 常用

PowerShell 示例：

$env:ARONA_API_KEY = "sk-xxxxxxxx"

bash 示例：

export ARONA_API_KEY="sk-xxxxxxxx"

请求示例

curl https://sub2api.lingshichat.top/v1/chat/completions \
  -H "Authorization: Bearer $ARONA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.5",
    "messages": [{"role": "user", "content": "你好"}]
  }'

密钥与分组

API Key 通常绑定一个或多个分组。分组决定：

可访问的模型（例如 grok-4.5）
上游平台类型（Grok / OpenAI / Claude 等）
配额、并发与计费策略

如果请求返回模型不可用或权限错误，优先检查：

Key 是否有效
Key 所属分组是否包含 grok-4.5
账户余额 / 订阅是否可用

安全建议

为不同客户端创建不同 Key，方便吊销
定期轮换密钥
不要把 Key 写进 config.toml 后直接提交 Git；优先 env_key

开始使用

客户端配置（Grok 4.5）

使用指南

API 参考

身份验证

身份验证

鉴权方式

获取 API Key

推荐的环境变量

请求示例

密钥与分组

安全建议

​身份验证

​鉴权方式

​获取 API Key

​推荐的环境变量

​请求示例

​密钥与分组

​安全建议

身份验证

鉴权方式

获取 API Key

推荐的环境变量

请求示例

密钥与分组

安全建议