5 分钟快速开始

Allen API 的网关地址是 https://api.allenyeahger.xyz。

1. 创建 API Key

1. 登录 Allen API 控制台。
2. 打开 API 密钥 页面。
3. 点击 创建密钥，选择站点为你开放的分组。
4. 复制新密钥并妥善保存。完整密钥通常只在创建时展示一次。

不要泄露密钥

不要把真实 API Key 提交到 Git、截图、前端代码或聊天记录中。

2. 检查可用模型

curl https://api.allenyeahger.xyz/v1/models \
  -H "Authorization: Bearer sk-your-key"

返回 200 和模型数组，说明域名、密钥和分组配置均已生效。

3. 发送第一条请求

使用 OpenAI Chat Completions 兼容接口：

curl https://api.allenyeahger.xyz/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-id",
    "messages": [{"role": "user", "content": "请只回复：接入成功"}]
  }'

将 your-model-id 替换成上一步返回的实际模型 ID。

也可以用 Responses 兼容接口：

curl https://api.allenyeahger.xyz/v1/responses \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-id",
    "input": "请只回复：接入成功"
  }'

4. 查看用量

回到控制台的 日志 页面，确认刚才的请求已经出现。这里可以查看模型、Token、耗时、时间和请求状态；钱包 页面查看余额变化。

关于 Base URL 的 /v1

不同客户端对 Base URL 的处理不同，二选一即可：

客户端行为	Base URL 填
客户端自己拼 /v1/chat/completions	https://api.allenyeahger.xyz
客户端要求在地址里写死 /v1	https://api.allenyeahger.xyz/v1

判据：请求返回 404 且路径里出现 /v1/v1/，说明重复了，去掉一个。

下一步

• 配置 Codex
• 配置 Claude Code
• 使用 OpenAI SDK
• 排查常见错误