客服控制台

HEIAPI 使用文档

HEIAPI 是一个 OpenAI 兼容的 API 代理服务，提供统一的接口访问多种大语言模型。只需一个 API Key，即可调用所有支持的模型。

快速开始

三步接入，与 OpenAI SDK 完全兼容。

1. 获取 API 密钥

登录后进入 API 密钥 页面，点击「创建密钥」。密钥仅创建时显示一次，请妥善保存。

2. 设置 Base URL

将客户端中的 API 地址替换为 HEIAPI 的端点：

https://heiapi.com/v1

3. 发送第一个请求

curl https://heiapi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [{"role": "user", "content": "你好！"}]
  }'

认证方式

所有 API 请求均需在 HTTP Header 中携带 API Key 进行认证：

Authorization: Bearer sk-your-api-key

API Key 可在 API 密钥 页面创建和管理。每个 Key 可设置额度上限和有效期。

安全提示
请勿将 API Key 硬编码在前端代码或公开仓库中。建议通过后端代理转发请求，或使用环境变量存储密钥。

模型列表

以下模型均支持 /v1/chat/completions 端点，兼容 OpenAI SDK。列表与首页定价表一致，由后台配置实时驱动。

模型品牌说明
加载中…

完整模型列表与实时在线率请查看模型页，定价明细见首页定价表。

定价说明

HEIAPI 采用倍率定价：您支付的价格 = 官方价格 × 本站倍率。倍率越低越省钱，所有价格在首页与模型页公开透明，登录前即可查看。

计费单位

项目计费方式
输入 token按模型官方输入价格 × 倍率
输出 token按模型官方输出价格 × 倍率
缓存命中按模型官方缓存价格 × 倍率（部分模型支持）
峰谷定价
部分模型支持峰谷双价：高峰时段按官方价，闲时享更低价格。具体以模型页与首页定价表为准。

代码示例

Python（OpenAI SDK）

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://heiapi.com/v1"
)

response = client.chat.completions.create(
    model="gpt-5.6-sol",
    messages=[
        {"role": "user", "content": "用 Python 写一个快速排序"}
    ]
)

print(response.choices[0].message.content)

JavaScript（OpenAI SDK）

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-your-api-key",
  baseURL: "https://heiapi.com/v1"
});

const response = await client.chat.completions.create({
  model: "gpt-5.6-sol",
  messages: [
    { role: "user", content: "解释一下量子计算" }
  ]
});

console.log(response.choices[0].message.content);

流式输出

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://heiapi.com/v1"
)

stream = client.chat.completions.create(
    model="gpt-5.6-sol",
    messages=[{"role": "user", "content": "讲个故事"}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

兼容客户端

任何支持 OpenAI 兼容 API 的客户端均可接入 HEIAPI，只需修改 Base URL 和 API Key。

客户端类型配置方式
ChatBox桌面/移动设置 → 模型提供商 → OpenAI 兼容 → 填入 Base URL 和 Key
NextChat (ChatGPT-Next-Web)Web设置 → 自定义接口 → 填入地址和 Key
LobeChatWeb/桌面设置 → 语言模型 → OpenAI 兼容 → 填入地址和 Key
Open WebUI自托管管理面板 → 连接 → OpenAI API → 填入地址和 Key
CursorIDE设置 → Models → OpenAI API Key → 填入 Base URL
Continue (VS Code)插件config.json → provider: openai → apiBase + apiKey
API 直接调用任何 OpenAI SDK（Python/JS/Go/Java 等）

常见问题

是否支持 OpenAI SDK？

完全兼容。只需将 base_url 指向 https://heiapi.com/v1，其余代码无需修改。

如何查看余额和使用量？

登录后进入 钱包 查看余额，进入 使用量 查看调用明细。

支持哪些模型？

支持 OpenAI、DeepSeek、通义千问（Qwen）等主流模型，完整模型列表与实时在线率请查看模型页。

API 调用失败怎么办？

常见原因：API Key 无效或过期、余额不足、模型名称拼写错误。检查后仍无法解决，可通过「客服」联系我们。

是否支持流式输出？

支持。设置 stream: true 即可，与 OpenAI 用法完全一致。