API 参考

模型调用路径、认证方式与普通及流式请求示例。

REST API v2.0 OpenAPI 3.0

Base URL: https://minglu.zihua.org.cn/v1

模型调用使用 /v1/...。/api/v1/... 是账户与管理接口，不是模型 Base URL。客户端自动添加 /v1 时，仅填写服务根地址。

请求认证

模型调用需要 API Key。以下是认证头格式示例，请在本机或可信服务端配置密钥。

Header

Authorization: Bearer YOUR_API_KEY

不要将密钥放进前端、公开仓库或截图。登录凭据不能代替模型调用密钥。

模型接口

GET /v1/models 查询可用模型

POST /v1/chat/completions Chat Completions

POST /v1/responses Responses

POST /v1/messages Messages

路径已与当前部署版本核对，未认证请求返回 401。实际调用权限取决于密钥分组；Responses、Messages 的请求结构不同，不能只替换 URL。示例尚未使用真实密钥进行端到端验收。

普通与流式请求

普通请求 · 示例

cURL 普通请求 · 示例

curl https://minglu.zihua.org.cn/v1/chat/completions \
  -H "Authorization: Bearer ${MINGLU_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_AVAILABLE_MODEL",
    "messages": [{"role":"user","content":"你好"}],
    "stream": false
  }'

SSE 流式请求 · 示例

cURL SSE 流式请求 · 示例

curl -N https://minglu.zihua.org.cn/v1/chat/completions \
  -H "Authorization: Bearer ${MINGLU_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_AVAILABLE_MODEL",
    "messages": [{"role":"user","content":"你好"}],
    "stream": true
  }'

将 YOUR_AVAILABLE_MODEL 替换为分组支持的真实模型名称。stream: true 请求流式响应；curl -N 关闭终端输出缓冲，客户端应按 SSE 事件逐步读取。

常见错误排查

实际原因以接口响应为准。不要将模板的示例限额当作账户额度。

状态码	检查方向	下一步
401	API Key 或认证头	检查密钥有效性
403	模型或分组权限	核对分组支持范围
429	调用频率或额度	查看响应与账户状态
404	路径或模型名称	避免重复 /v1
5xx	服务或上游异常	保留脱敏错误，避免密集重试