接入概览

OpenSky API 提供 OpenAI 兼容格式的接口。对于大多数客户端和代码项目，只需要替换 Base URL 与 API Key 即可接入。

基础信息

项目	内容
Base URL	https://api.oskyi.com/v1
鉴权方式	Authorization: Bearer <API Key>
数据格式	JSON
文档站	https://docs.oskyi.com

常用接口

能力	接口
模型列表	GET /v1/models
对话生成	POST /v1/chat/completions
文生图	POST /v1/images/generations
图生图	POST /v1/images/edits

具体支持哪些模型和接口能力，请以控制台模型广场为准。

调用流程

1. 登录控制台创建 API Key。
2. 选择模型分组。
3. 使用 Base URL 与 API Key 发起请求。
4. 根据响应结果处理成功或失败。
5. 在控制台查看调用记录和余额消耗。

兼容说明

OpenSky API 尽量保持与 OpenAI 格式兼容，但不同模型、不同上游能力可能存在参数差异。如果某个参数无效，请先简化请求，只保留 model 与必要内容进行测试。

推荐实践

• 生产环境请设置请求超时和重试。
• 不要在前端暴露 API Key。
• 批量任务先小规模测试成本。
• 对重要任务记录请求 ID、时间、模型和错误信息，方便排查。