Integration center

把统一模型接入你的工具链

选择工具、公开模型与线路档位，自动生成可复制配置。密钥始终通过环境变量注入，不写入示例文件。

独立集成指南

OpenAI SDK

推荐模型线路档位

设置密钥

在终端中设置环境变量；不要把真实 Key 提交到代码仓库。

$env:HENGXING_API_KEY = "hx_your_key"

写入配置

将下面配置放入工具的 OpenAI Compatible Provider 设置。

from openai import OpenAI
import os

client = OpenAI(api_key=os.environ["HENGXING_API_KEY"], base_url="https://api.hengstar.top/v1")
print(client.chat.completions.create(model="deepseek/deepseek-v3.1", messages=[{"role":"user","content":"ping"}], extra_body={"route_tier":"standard"}))

连通性测试

先调用 /v1/models，再发送一个短请求；确认响应中的 model、usage 与 request ID 完整。

curl https://api.hengstar.top/v1/models -H "Authorization: Bearer $HENGXING_API_KEY"

常见错误：401 检查 Key 与环境变量；404 检查 Base URL 是否包含 /v1；422 检查模型能力；429 降低并发或切换合适档位；流式中断请确认客户端支持 SSE。