接口信息
Api Halo 提供 OpenAI 兼容接口,适用于支持自定义 Base URL 的 SDK、客户端和自动化程序。
Base URL:
API Key:在 Api Halo 控制台创建令牌
模型:从模型广场复制当前准确名称
https://apihalo.cn/v1API Key:在 Api Halo 控制台创建令牌
模型:从模型广场复制当前准确名称
接入前准备
- 注册并登录 Api Halo。
- 在令牌管理中创建独立令牌,并选择需要的模型分组。
- 打开模型广场确认模型名称、价格和可用分组。
不要把 API Key 写入公开仓库、截图或前端网页。生产环境应使用环境变量或密钥管理服务。
curl 最小请求
curl https://apihalo.cn/v1/chat/completions \
-H "Authorization: Bearer 你的_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.4",
"messages": [{"role":"user","content":"请回复:接入成功"}]
}'HTTP 200、响应包含模型回复,并且控制台日志出现成功记录,才代表完整接入成功。
Python 与 Node.js
Python
from openai import OpenAI
client = OpenAI(api_key="你的_API_KEY", base_url="https://apihalo.cn/v1")
r = client.chat.completions.create(
model="gpt-5.4",
messages=[{"role":"user","content":"你好"}]
)
print(r.choices[0].message.content)Node.js
import OpenAI from "openai";
const client = new OpenAI({apiKey: process.env.OPENAI_API_KEY, baseURL: "https://apihalo.cn/v1"});
const r = await client.chat.completions.create({model:"gpt-5.4", messages:[{role:"user",content:"你好"}]});
console.log(r.choices[0].message.content);
常见问题
为什么返回 401?
检查令牌是否完整、有效,Authorization 是否使用 Bearer 格式。
为什么返回 403?
通常是令牌分组不包含所选模型,或模型名不准确。
为什么返回 404?
检查是否错误拼成 /v1/v1。会自动追加 /v1 的客户端应填写根域名。
配套在线工具
无需手写模板,可生成 cURL、Python 或 JavaScript 示例,再执行最小连接测试。