Developer docs
开发者快速开始
通过统一的 OpenAI 风格接口接入多家模型服务，并使用衡星路由策略控制稳定性、地域、数据留存与成本。
01
创建 API Key
为项目创建虚拟密钥并设置 RPM、TPM 和模型权限。
继续 →
02选择模型
比较初始化价格、上下文和能力；生产指标以状态中心接入结果为准。
继续 →
03发起请求
使用标准 SDK 或 HTTPS 请求访问统一接口。
继续 →
04工具集成
生成 Codex、Cursor、Dify、n8n 等工具配置。
继续 →
身份验证
所有 API 请求都必须在 Authorization 请求头中携带虚拟 Key。密钥继承所属企业、部门、项目和应用的策略。
Authorization: Bearer hx_prod_your_api_key第一个请求
以下请求使用统一对话接口。模型名称可以在模型广场中查询。
curl https://api.hengstar.top/v1/chat/completions \ -H "Authorization: Bearer $HENGXING_API_KEY" \ -H "Content-Type: application/json" \ -d '{
"model": "deepseek-v3-1",
"messages": [{"role": "user", "content": "你好"}]
}'统一接口
第一阶段开放文本与向量接口；图片、语音和视频使用异步任务格式。
POST
/v1/chat/completions对话补全，兼容主流 Chat Completions 格式
POST
/v1/responses统一文本、多模态与工具调用响应
POST
/v1/embeddings创建文本向量
POST
/v1/images/generations提交图片生成任务
GET
/v1/models查询模型目录与能力
Provider 路由
请求先经过鉴权、预冻结和策略检查，再按照能力、地域、数据政策、健康度与路由偏好选择上游。
{
"route": {
"priority": "stability",
"region": "cn",
"zero_data_retention": true,
"allow_fallbacks": true
}
}安全边界：回退线路必须继续满足客户策略和商业授权要求；不会为了成功率而放宽地域、数据政策或转售许可。
错误与排障
所有响应都返回平台 Request ID。401 表示虚拟 Key 无效或已撤销，403 表示企业策略拒绝，422 表示模型或能力不匹配，429 表示限额或上游容量不足，5xx 表示平台或合规候选线路暂不可用。
联系支持时仅提供 Request ID 或 Trace ID，不要发送完整 API Key、Prompt 正文或上游凭证。
BYOK
企业可以把自己的上游凭证限定到企业、项目和模型范围。凭证在入库前加密，列表和日志只显示脱敏提示，调用时才瞬时解密。
打开 BYOK 管理数据与安全
路由会先检查商业权利、地域、数据留存和模型能力，再比较健康度、延迟和成本。生产线路不会回退到 Sandbox、个人订阅或未获转售许可的账号。
计费与账本
同步请求先冻结最高可能费用，成功后按真实 usage 扣款并释放差额，失败则释放冻结。异步任务在提交时冻结，终态成功扣款，失败或取消后释放；所有变化都追加不可变账本分录。
查看账本