夯炸了AI API Docs
主页 控制台
OpenAI Compatible API Gateway

夯炸了AI API 文档中心

这里整理了从创建密钥、配置客户端到代码调用的完整接入路径。所有示例默认使用 https://api.hangzhale.com/v1,适用于支持 OpenAI 兼容协议的客户端、插件和 SDK。

API 根地址 https://api.hangzhale.com/v1
聊天补全端点 https://api.hangzhale.com/v1/chat/completions
密钥格式 sk-你的真实API-Key

Quick Start

新手必读:三步完成首次调用

1

创建 API Key

进入夯炸了AI控制台,打开 API Key 管理页,创建一个用于文档测试的新密钥。建议为不同客户端分别创建密钥,便于后续统计和停用。

2

确认 Base URL

在客户端的提供商类型中选择 OpenAIOpenAI Compatible,API 地址填写 https://api.hangzhale.com/v1

3

测试模型响应

选择当前密钥有权限的模型并发送一条简单消息。如果返回 401、403 或模型不存在,请优先检查密钥权限和模型 ID。

接入原则:客户端能自定义 OpenAI 接口地址时,通常只需要替换 Base URL 和 API Key;模型名称以控制台实际可见列表为准。

Clients

主流客户端接入教程

CC-Switch 一键导入

如果你的控制台提供 CC-Switch 导入按钮,可直接将接口地址、密钥和模型配置写入本地工具。导入后建议重启编辑器或相关插件,确保新配置被重新加载。

  1. 安装并启动 CC-Switch 客户端。
  2. 在夯炸了AI控制台创建专用 API Key。
  3. 点击密钥旁边的导入按钮,确认 CC-Switch 已识别到 https://api.hangzhale.com/v1
  4. 重启 VSCode、Cursor、Codex、Cline 或 Continue 等调用方。
自动导入本质上是改写本地配置。若需要恢复旧配置,请在对应插件的配置目录中备份或删除自动生成的配置文件。

Cherry Studio 详解配置

Cherry Studio 支持 OpenAI 兼容提供商,适合作为桌面统一入口管理多个模型。

提供商名称 夯炸了AI
类型 OpenAI Compatible
API 地址 https://api.hangzhale.com/v1
API Key sk-你的真实API-Key

保存后点击刷新模型列表。若无结果,先检查地址末尾是否包含 /v1,再检查密钥是否多复制了空格。

NextChat / LobeChat 配置

这类网页客户端通常在模型供应商设置里提供自定义接口地址。启用 OpenAI 代理地址后填入以下信息即可。

接口代理地址 https://api.hangzhale.com/v1
API Key sk-你的真实API-Key

如果某个客户端测试连通性时返回 404,可尝试把地址临时改为 https://api.hangzhale.com,实际对话请求仍建议使用带 /v1 的地址。

沉浸式翻译配置

沉浸式翻译的 OpenAI 服务通常需要填写完整的聊天补全端点,而不是只填 Base URL。

自定义 API URL https://api.hangzhale.com/v1/chat/completions
API Key sk-你的真实API-Key
模型名称 请填写控制台可用模型 ID

OpenClaw 部署配置

OpenClaw 可通过 JSON 配置接入 OpenAI 兼容接口。请将下方片段中的密钥和模型 ID 换成你控制台里的真实值。

~/.openclaw/openclaw.json
{
  "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 兼容写法。

Python
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)
Node.js
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 连通性测试
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

模型填写建议

不同密钥可用的模型由账户套餐和后台权限决定。文档站不硬编码承诺模型,避免用户复制到无权限模型后误判接口异常。

在控制台复制模型 ID 客户端刷新模型列表 按套餐权限选择模型 报错时核对大小写
如需展示固定模型清单,可直接在本节维护实际支持的模型 ID,例如高性能模型、轻量模型、代码模型、翻译模型等分组。

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 给多个客户端使用?

可以,但不建议。为不同客户端创建独立密钥更容易定位异常,也能在泄露或不再使用时单独停用。