Api Halo 文档中心

OpenAI API 接入教程:使用 Api Halo 兼容接口

从创建令牌到 curl、Python 和 Node.js 调用,完整配置 Api Halo 的 OpenAI 兼容 API。

发布与更新:2026-07-12 · 中文技术教程

接口信息

Api Halo 提供 OpenAI 兼容接口,适用于支持自定义 Base URL 的 SDK、客户端和自动化程序。

Base URL:https://apihalo.cn/v1
API Key:在 Api Halo 控制台创建令牌
模型:从模型广场复制当前准确名称

接入前准备

  1. 注册并登录 Api Halo。
  2. 在令牌管理中创建独立令牌,并选择需要的模型分组。
  3. 打开模型广场确认模型名称、价格和可用分组。

不要把 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 示例,再执行最小连接测试。