API 接入

HHHUU / KKAI New API 提供 OpenAI 兼容的调用方式，适合已有 OpenAI SDK、HTTP 客户端和自动化脚本迁移接入。

请求地址

基础地址固定为：

http://ai.hhhuu.com/v1

常用接口：

用途	方法	地址
查看模型	GET	http://ai.hhhuu.com/v1/models
Chat Completions	POST	http://ai.hhhuu.com/v1/chat/completions
Responses	POST	http://ai.hhhuu.com/v1/responses

认证

所有 API 请求都应携带 Bearer Token：

Authorization: Bearer $HHHUU_API_KEY
Content-Type: application/json

请在控制面板创建和管理 API Key，不要把密钥写入前端代码、公开仓库或日志。

参数

最小请求通常包含：

参数	说明
model	模型名称。可用模型以控制面板实时显示为准。
messages 或 input	用户输入。Chat Completions 使用 messages，Responses 使用 input。
stream	是否开启流式输出。是否可用以所选模型和接口实际支持为准。

流式输出提示 部分模型当前以流式输出为准。命令行测试建议显式传入 "stream": true，并使用 curl -N 关闭缓冲。返回内容是 SSE 事件流，每行通常以 data: 开头，读取到 data: [DONE] 表示完成；如果客户端按普通 JSON 解析，可能会看到 Unexpected token 'd'。

示例

curl -N http://ai.hhhuu.com/v1/chat/completions \
-H "Authorization: Bearer $HHHUU_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "<model-from-panel>",
"stream": true,
"messages": [
{"role": "user", "content": "用一句话介绍 HHHUU API 的接入方式"}
]
}'

错误

常见问题包括密钥缺失或无效、模型名称不可用、余额不足、Base URL 写错、请求参数不被当前接口接受、触发频率限制。排查时先确认请求是否发送到 http://ai.hhhuu.com/v1，再检查控制面板中的模型、余额、额度和用量记录。

计费说明

价格、可用模型、上下文能力、额度、频率限制和账单统计均以控制面板实时显示为准。示例中的模型名和参数只展示接入格式，不代表固定可用或固定价格。