夯炸了AI API 文档中心
这里整理了从创建密钥、配置客户端到代码调用的完整接入路径。所有示例默认使用
https://api.hangzhale.com/v1,适用于支持 OpenAI 兼容协议的客户端、插件和 SDK。
https://api.hangzhale.com/v1
https://api.hangzhale.com/v1/chat/completions
sk-你的真实API-Key
Quick Start
新手必读:三步完成首次调用
创建 API Key
进入夯炸了AI控制台,打开 API Key 管理页,创建一个用于文档测试的新密钥。建议为不同客户端分别创建密钥,便于后续统计和停用。
确认 Base URL
在客户端的提供商类型中选择 OpenAI 或 OpenAI Compatible,API 地址填写 https://api.hangzhale.com/v1。
测试模型响应
选择当前密钥有权限的模型并发送一条简单消息。如果返回 401、403 或模型不存在,请优先检查密钥权限和模型 ID。
Clients
主流客户端接入教程
CC-Switch 一键导入
如果你的控制台提供 CC-Switch 导入按钮,可直接将接口地址、密钥和模型配置写入本地工具。导入后建议重启编辑器或相关插件,确保新配置被重新加载。
- 安装并启动 CC-Switch 客户端。
- 在夯炸了AI控制台创建专用 API Key。
- 点击密钥旁边的导入按钮,确认 CC-Switch 已识别到
https://api.hangzhale.com/v1。 - 重启 VSCode、Cursor、Codex、Cline 或 Continue 等调用方。
Cherry Studio 详解配置
Cherry Studio 支持 OpenAI 兼容提供商,适合作为桌面统一入口管理多个模型。
夯炸了AI
OpenAI Compatible
https://api.hangzhale.com/v1
sk-你的真实API-Key
保存后点击刷新模型列表。若无结果,先检查地址末尾是否包含 /v1,再检查密钥是否多复制了空格。
NextChat / LobeChat 配置
这类网页客户端通常在模型供应商设置里提供自定义接口地址。启用 OpenAI 代理地址后填入以下信息即可。
https://api.hangzhale.com/v1
sk-你的真实API-Key
如果某个客户端测试连通性时返回 404,可尝试把地址临时改为 https://api.hangzhale.com,实际对话请求仍建议使用带 /v1 的地址。
沉浸式翻译配置
沉浸式翻译的 OpenAI 服务通常需要填写完整的聊天补全端点,而不是只填 Base URL。
https://api.hangzhale.com/v1/chat/completions
sk-你的真实API-Key
请填写控制台可用模型 ID
OpenClaw 部署配置
OpenClaw 可通过 JSON 配置接入 OpenAI 兼容接口。请将下方片段中的密钥和模型 ID 换成你控制台里的真实值。
{
"agents": {
"models": {
"providers": {
"openai": {
"api": "openai-completions",
"baseUrl": "https://api.hangzhale.com/v1",
"apiKey": "sk-你的真实API-Key",
"headers": {
"User-Agent": "OpenClaw/JS"
},
"models": [
{ "id": "请填写控制台可用模型ID", "contextWindow": 128000 }
]
}
}
},
"defaults": {
"model": {
"primary": "请填写控制台可用模型ID"
}
}
}
}
部分网关会拒绝没有常规请求头的流量。保留 User-Agent 可减少 403 类问题。
Cursor / VSCode / Codex 接入
在代码编辑器和 AI 编程插件中,优先选择 OpenAI 兼容模式。若你通过 CC-Switch 写入配置,完成导入后请完整退出编辑器再重新打开。
- Base URL:
https://api.hangzhale.com/v1 - API Key:控制台创建的真实密钥。
- Model:选择当前套餐已授权的模型 ID。
SDK
官方 SDK 原生开发示例
开发侧只需要把 SDK 的默认地址覆盖为夯炸了AI的 Base URL,其余调用方式保持 OpenAI 兼容写法。
from openai import OpenAI
client = OpenAI(
api_key="sk-你的真实API-Key",
base_url="https://api.hangzhale.com/v1"
)
response = client.chat.completions.create(
model="请填写控制台可用模型ID",
messages=[
{"role": "user", "content": "用一句话介绍夯炸了AI API"}
]
)
print(response.choices[0].message.content)
import OpenAI from "openai";
const openai = new OpenAI({
apiKey: "sk-你的真实API-Key",
baseURL: "https://api.hangzhale.com/v1"
});
const completion = await openai.chat.completions.create({
model: "请填写控制台可用模型ID",
messages: [
{ role: "user", content: "Say hello to 夯炸了AI API" }
]
});
console.log(completion.choices[0].message.content);
curl https://api.hangzhale.com/v1/chat/completions \
-H "Authorization: Bearer sk-你的真实API-Key" \
-H "Content-Type: application/json" \
-d '{
"model": "请填写控制台可用模型ID",
"messages": [
{ "role": "user", "content": "ping" }
]
}'
Models
模型填写建议
不同密钥可用的模型由账户套餐和后台权限决定。文档站不硬编码承诺模型,避免用户复制到无权限模型后误判接口异常。
Troubleshooting
常见错误与排查顺序
| 现象 | 优先检查 | 处理建议 |
|---|---|---|
| 401 Unauthorized | API Key 是否完整 | 重新复制密钥,确认没有空格、换行或旧密钥。 |
| 403 Forbidden | 密钥权限、请求头、网络环境 | 确认账户状态正常;开发工具可补充常规 User-Agent。 |
| 404 Not Found | Base URL 路径 | 多数客户端应填写 https://api.hangzhale.com/v1。 |
| model not found | 模型 ID 与套餐权限 | 从控制台复制模型名,不要手动猜测或混用别家模型 ID。 |
| 请求超时 | 本地网络与模型响应时间 | 降低上下文长度,切换轻量模型,或稍后重试。 |
FAQ
常见问题
夯炸了AI API 能直接替换 OpenAI 官方地址吗?
支持 OpenAI 兼容协议的工具通常可以直接替换 Base URL。少数工具会把完整端点和 Base URL 分开配置,请按上方对应教程填写。
API 根地址应该带不带 /v1?
绝大多数客户端和 SDK 应填写 https://api.hangzhale.com/v1。如果工具明确要求填写域名或代理地址,可按工具提示尝试不带 /v1。
是否可以把同一个 API Key 给多个客户端使用?
可以,但不建议。为不同客户端创建独立密钥更容易定位异常,也能在泄露或不再使用时单独停用。