🚀 API 使用文档
大模型 API 统一中转服务 - 一个接口调用所有主流 AI 模型
⚡ 三步开始使用
1
创建代理 Token
登录后访问 Token 管理页面，选择路由并创建 Token
前往创建→2
替换 API 域名
将原始 API 地址替换为我们的中转地址，无需修改其他代码
3
开始调用
使用代理 Token 替换原始 API Key，立即开始使用
🔑 两种使用模式
🏢
托管你的大模型Key在平台
将您的 API Key 托管到平台，享受负载均衡和安全管理
✓自动负载均衡
✓多 Key 轮询使用
✓Key 安全存储 全程加密保护
✓统一管理 免服务费
推荐：适合需要高可用和负载均衡的场景
👤
Key自己管理
每次请求时携带您的 API Key，Key 不存储在平台
✓Key 不离手
✓完全控制
✓灵活切换
适合对 Key 安全有特殊要求的场景
📝 如何使用
🔑 两种调用方案
🌐
通用模式
URL 中包含服务商名称,一个 Token 可以访问所有服务商
https://api.aihenkuai.cn/openai/v1/...✓一个 Token 支持所有服务商
✓切换服务商只需更换 URL
✓管理简单,推荐使用
🔐
专用模式
URL 中不包含服务商,每个服务商需要独立的 Token
https://api.aihenkuai.cn/v1/...•每个服务商独立 Token
•更精细的权限控制
•适合多团队场景
🚀 支持的服务商
正在加载服务商列表...
💡 使用示例
示例:OpenAI
🌐 通用模式
base_url = "https://api.aihenkuai.cn/openai/v1"
api_key = "YOUR_PROXY_TOKEN"
💡 切换到 Gemini:只需改为 /gemini/v1
🔐 专用模式
base_url = "https://api.aihenkuai.cn/v1"
api_key = "OPENAI_TOKEN"
💡 需要为 OpenAI 创建专用 Token
示例:Google Gemini
🌐 通用模式
base_url = "https://api.aihenkuai.cn/gemini"
api_key = "YOUR_PROXY_TOKEN"
💡 同一个 Token,切换到 OpenAI:改为 /openai/v1
🔐 专用模式
base_url = "https://api.aihenkuai.cn"
api_key = "GEMINI_TOKEN"
💡 需要为 Gemini 创建专用 Token
💻 完整代码示例
🏢托管您的大模型key到平台
只需提供一个请求头:Authorization: Bearer YOUR_PROXY_TOKEN
📋 需要的请求头
✓
Authorization: Bearer YOUR_PROXY_TOKEN您的代理 Token
cURL
Bash
curl https://your-domain.com/openai/v1/chat/completions \
-H "Authorization: Bearer YOUR_PROXY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4",
"messages": [{"role": "user", "content": "Hello!"}]
}'需要替换: YOUR_PROXY_TOKEN
需要替换: your-domain.com
👤自带 Key 模式
需要提供两个请求头
📋 需要的请求头
✓
Authorization: Bearer YOUR_PROXY_TOKEN您的代理 Token
✓
X-API-Key: YOUR_ORIGINAL_API_KEY您自己的 API Key (如 sk-...)
cURL
Bash
curl https://your-domain.com/openai/v1/chat/completions \
-H "Authorization: Bearer YOUR_PROXY_TOKEN" \
-H "X-API-Key: sk-..." \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4",
"messages": [{"role": "user", "content": "Hello!"}]
}'需要替换: YOUR_PROXY_TOKEN
需要替换: your-domain.com
需要替换: sk-... (您的Key)
📋 请求头说明
| 请求头 | 托管 Key 模式 | 自带 Key 模式 |
|---|---|---|
| Authorization | ✓ 必需Bearer YOUR_PROXY_TOKEN | ✓ 必需Bearer YOUR_PROXY_TOKEN |
| X-API-Key | - 不需要 | ✓ 必需您的原始 API Key |
⚠️ 错误处理
| 状态码 | 说明 |
|---|---|
| 200 | 请求成功 |
| 400 | 请求参数错误 / 自带 Key 模式缺少 X-API-Key |
| 401 | 代理 Token 无效或已过期 |
| 402 | 余额不足（托管 Key 模式） |
| 403 | 路由已禁用或 Token 不适用于当前路由 |
| 500 | 服务器内部错误 |
✨ 最佳实践
✅ 托管 Key 享受负载均衡
将多个 API Key 托管到平台，自动实现负载均衡和故障转移，提高服务可用性
🔒 Key 全程加密保护
托管的 API Key 采用 AES-256 军事级加密存储，传输过程使用 TLS 1.3 加密。您的密钥安全由业界最高标准保护，平台不会泄露或滥用您的 Key
✅ 妥善保管代理 Token
代理 Token 具有完整的 API 调用权限，请勿泄露给他人
✅ 监控使用情况
定期查看 使用统计，了解 API 调用情况和费用
需要帮助？
如果您在使用过程中遇到问题，欢迎联系我们的技术支持团队
🔑立即创建 Token