接口地址与鉴权

Base URL

OpenSky API 的 OpenAI 兼容接口地址为：

https://api.oskyi.com/v1

如果客户端要求填写完整接口地址，可以按实际接口填写：

https://api.oskyi.com/v1/chat/completions
https://api.oskyi.com/v1/models
https://api.oskyi.com/v1/images/generations

请求头

所有需要鉴权的接口都需要携带 API Key：

Authorization: Bearer sk-xxxxxxxx
Content-Type: application/json

请注意：

• Bearer 与 API Key 之间有一个空格。
• API Key 不要加引号。
• 不要把 API Key 写到浏览器前端代码中。

测试模型列表

可以先请求模型列表验证 API Key 是否可用：

curl https://api.oskyi.com/v1/models \
  -H "Authorization: Bearer sk-your-api-key"

如果返回模型列表，说明接口地址和鉴权基本正常。

常见错误

现象	可能原因
401 Unauthorized	API Key 错误、缺少 Bearer、密钥已删除
403 Forbidden	没有模型或分组权限
404 Not Found	接口路径填写错误
429 Too Many Requests	请求过快、额度不足或触发限制
500/502/503	服务繁忙、上游异常或网络波动