HAONODE DEVELOPER GUIDE

让第一次请求更简单。

这里保留最小可用的接入路径。页面中的地址会自动读取当前访问域名；部署到你的正式域名后，不需要手工重写示例。

先在控制台创建专用 API 令牌，再把密钥放入服务器环境变量。不要把令牌写进前端代码、截图或公开仓库。

快速开始

兼容常见的 OpenAI 风格请求。将 API_KEY 替换成你自己的令牌，将 your-model 换成模型目录中已启用的名称。

curl /chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model",
    "messages": [{"role":"user","content":"你好"}]
  }'

请求格式

路径	用途
`/v1/models`	查看当前可用模型
`/v1/chat/completions`	对话与流式响应
`/v1/embeddings`	文本向量接口（上游支持时）
`/v1/responses`	兼容响应式调用（按配置为准）

模型与渠道

模型能否调用取决于后台渠道配置、上游权限、令牌范围与模型名称。公开页面不展示你的密钥，也不会替你虚构某个厂商已接入。

安全建议

令牌最小权限

按应用拆分令牌，设置模型范围与用量限制；管理员密码只用于控制台，不用于业务请求。

生产环境

正式上线前配置域名 HTTPS、反向代理、防火墙、备份和 MFA。不要直接把后端管理端口暴露到公网。

域名上线

将域名指向服务器后，在反向代理层配置 HTTPS，并把网关的受信 Host 设置为你的域名。页面会自动以当前访问域名生成 API 地址；当前本机示例仅用于开发验证。