API Key
API Key 用于让你的代码调用 hxa.net。可以创建多个 key，例如每个应用或环境一个，并分别设置限额。
创建 key
- 在控制台打开 API 密钥，点击 创建密钥。
- 按下表填写后保存。
- 点击 key 旁的复制按钮复制。列表中的 key 部分隐藏显示，复制按钮复制的是完整 key。
| 字段 | 说明 |
|---|---|
| 名称 | 便于自己识别，例如 prod-backend。 |
| 分组 | 必选。决定 key 可用的模型和费率。按要调用的厂商（Anthropic 或 OpenAI）选择对应分组。 |
| 自定义密钥 | 可选。自行指定 key 的值（至少 16 个字符，仅限字母、数字、_ 和 -）。留空则自动生成。 |
| IP 限制 | 可选。IP 白名单或黑名单，每行一个 IP 或 CIDR。设置白名单后，其他地址的请求会被拒绝。 |
| 额度金额 (USD) | 可选。此 key 可消费的最大金额，0 表示不限。可点 重置 重新计算。 |
| 速率限制 | 可选。按 5 小时、1 天、7 天设置的消费上限（USD）。 |
| 有效期 | 预设天数、自定义日期或永不过期。 |
使用 key
把 key 放在 Authorization: Bearer 请求头（OpenAI 格式）或 x-api-key 请求头（Anthropic 格式）中。放在 URL 查询参数里的 key 会被拒绝。详见 API 参考。
点击 key 上的 使用密钥，可获得各编程工具的现成配置，包括 Claude Code、Codex CLI、Gemini CLI 和 OpenCode，并区分 macOS/Linux 与 Windows。例如 Claude Code：
export ANTHROPIC_BASE_URL="https://hxa.net"
export ANTHROPIC_AUTH_TOKEN="YOUR_HXA_API_KEY"Codex CLI 在 ~/.codex/config.toml 中设置 base_url = "https://hxa.net/v1"；完整配置见 使用密钥 对话框。
管理 key
- 编辑：修改名称、分组、限额和有效期，key 的值不变。
- 禁用：key 停止工作，重新启用后恢复。key 过期或额度用完后也会停止工作。
- 删除：永久删除 key，使用它的请求立即失败。
- 列表显示每个 key 今日和近 30 天的用量、额度、上次使用时间和最近使用 IP。
保护好你的 key
任何拿到 key 的人都可以消耗你的余额。不要把 key 写进前端代码或公开仓库。如怀疑 key 泄露，请删除并新建。
- 每个应用使用单独的 key，便于单独撤销而不影响其他应用。
- 测试用或交给第三方的 key，设置额度或速率限制。
- 服务器地址固定时，使用 IP 白名单。