认证鉴权
天鸿智算 API 采用 Bearer Token 鉴权方式。所有请求都需要在 HTTP 请求头中携带有效的 API Key，否则将返回 401 Unauthorized。
请求头格式
每次调用 API 时，必须在请求头中加入以下字段：
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json其中 <YOUR_API_KEY> 替换为您从控制台获取的、以 sk- 开头的字符串。
获取 API Key
- 登录 天鸿智算控制台
- 进入「API Key 管理」页面
- 点击「创建 API Key」并填写名称
- 复制生成的 Key 并保存到安全位置（仅展示一次）
请勿将 API Key 写入前端代码、提交到公共代码仓库或在客户端暴露。建议存储在服务端环境变量中。
校验示例
使用 cURL 验证您的 API Key 是否有效：
curl https://api.thhtcloud.com/v1/models \
-H "Authorization: Bearer $YOUR_API_KEY"若返回模型列表 JSON，则说明鉴权成功；若返回 401，请检查 Key 是否正确、是否已被禁用。
常见错误
| HTTP 状态码 | 含义 | 排查建议 |
|---|---|---|
| 401 | 未携带 Key 或 Key 无效 | 检查请求头格式与 Key 是否正确 |
| 403 | Key 权限不足 | 到控制台为该 Key 开启对应模型/接口的权限 |
| 429 | 请求频率超过限额 | 增加 Key 限额或在客户端做限流退避 |