Developer Documentation

快速接入华霓 API

接口采用常见的 JSON 请求方式并预留统一聊天补全规范。正式上线前,请根据真实网关确认模型名称、鉴权方式和业务限制。

接口概览

所有正式请求应使用 HTTPS,并通过 Bearer Token 等服务器端鉴权方式保护 API 密钥。

https://api.huanikeji.com/v1

快速开始

  1. 进入用户控制台创建 API Key。
  2. 安装 Python requests 库或使用任意 HTTP 客户端。
  3. 将请求地址、模型名和密钥替换为控制台提供的真实参数。
pip install requests

Python 示例

import requests url = "https://api.huanikeji.com/v1/chat/completions" headers = { "Authorization": "Bearer sk-your-api-key", "Content-Type": "application/json" } payload = { "model": "deepseek-chat", "messages": [{"role": "user", "content": "你好"}] } response = requests.post(url, headers=headers, json=payload, timeout=60) print(response.json())

cURL 示例

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

模型列表

模型名称和版本应以控制台实时配置为准。正式 API 网关可提供模型列表接口,供客户端查询当前账户可用模型。

常见错误代码

状态码含义处理方式
401鉴权失败检查 API Key 是否正确、有效或已启用
429请求过于频繁降低并发或检查账户限额
500网关或模型服务异常稍后重试并查看平台状态