快速开始
本页演示从登录控制台到完成一次 API 请求的最短路径。
1. 登录控制台
打开 https://ai.enodot.shop/，使用你的账号登录。
如果你还没有账号，根据页面开放的登录方式完成注册。注册后请先进入控制台确认余额、订阅或可用额度。
2. 创建 API Key
进入“API Keys”页面：
- 点击“创建 API Key”。
- 选择一个可用分组。
- 设置 Key 名称、额度上限和过期时间。
- 保存后复制 Key。
API Key 只会完整展示一次。泄露后请立即删除并重新创建。
3. 选择调用协议
根据你的客户端选择协议：
| 客户端或 SDK | 推荐协议 | 推荐端点 |
|---|---|---|
| Codex CLI、OpenAI SDK | OpenAI | /v1/responses 或 /v1/chat/completions |
| Claude Code、Anthropic SDK | Anthropic | /v1/messages |
| Gemini SDK、Gemini CLI | Gemini | /v1beta/models/{model}:generateContent |
| 通用 OpenAI 兼容客户端 | OpenAI | /v1/chat/completions |
4. 发起测试请求
设置环境变量：
bash
export ENODOT_API_KEY="你的 API Key"
export ENODOT_BASE_URL="https://api.enodot.shop"使用 OpenAI Responses API：
bash
curl "$ENODOT_BASE_URL/v1/responses" \
-H "Authorization: Bearer $ENODOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.1-codex",
"input": "用一句话说明 Enodot 是什么。"
}'使用 Anthropic Messages API：
bash
curl "$ENODOT_BASE_URL/v1/messages" \
-H "x-api-key: $ENODOT_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"max_tokens": 512,
"messages": [
{ "role": "user", "content": "用一句话说明 Enodot 是什么。" }
]
}'5. 查看用量
请求成功后进入控制台：
- “Dashboard”查看汇总。
- “Usage Records”查看请求明细。
- “Key Usage”按 API Key 查看调用趋势。
- “Available Channels”确认当前可用渠道和模型。
常见接入错误
| 错误 | 常见原因 | 处理方式 |
|---|---|---|
| 401 Invalid API key | Key 写错、Key 已删除、请求头格式错误 | 重新复制 Key，优先使用 Authorization: Bearer |
| 403 Insufficient balance | 余额不足或订阅不可用 | 充值或切换有额度的分组 |
| 429 quota exceeded | Key、订阅或上游账号额度用尽 | 等待窗口重置或更换分组 |
| 404 not supported | 端点与分组协议不匹配 | 切换到正确协议或使用 Mixed 分组 |
| 502 upstream failed | 上游暂时失败或链路不稳定 | 稍后重试；管理员可检查账号池和运行日志 |