注册和登录账号

本文适合第一次使用 OpenSky API 的用户。按下面步骤操作，可以完成从注册账号到第一次调用的完整流程。

1. 打开控制台

访问控制台：

https://api.oskyi.com

如果你还没有账号，请先注册。注册完成后登录控制台，确认账号状态正常。

2. 购买或充值额度

本站注册即有赠送体验额度，可先行使用体验额度进行测试。

进入控制台后，查看是否有可用余额。如果余额不足，请先完成充值。

充值后建议确认两件事：

• 控制台余额是否已经更新。
• 当前账号是否能看到可用模型。

如果充值后长时间没有到账，请保留订单信息并联系管理员。

3. 创建 API Key

1. 进入「控制台」-「API 密钥」页面，新建一个密钥。
2. 点击右上角的「创建API密钥」
3. 按实际情况填写/选择以下内容：
   • 名称（必填项，给你自己看的）
   • 分组（必选项，选择对应分组）
   • 跨分组重试（非必开，只有当分组选择“auto”时需要打开）
   • 过期时间（非必选，无相应需求默认即可）
   • 数量（无相应需求默认即可）
   • 额度设置（无限配额打开即对这条密钥不设额度上限，关闭则需要填写这条密钥额度上限）
   • 模型限制（非必填，留空则该分组支持哪些模型就可以调用哪些模型）
   • IP白名单（非必填，填写后该条密钥仅支持白名单中已有的IP进行访问）
4. 点击右下角的「保存更改」即可看到新建完成的API 密钥，点击密钥边上的复制图标即可复制完整密钥。

注意：请保管好生成的API密钥，切勿泄露 以免造成损失。

4. 配置客户端

大多数 OpenAI 兼容客户端只需要填写两项：

配置项	填写内容
API Key	你在控制台创建的密钥
API Base URL	https://api.oskyi.com/v1

部分客户端可能把 API Base URL 叫做「接口地址」「代理地址」「自定义 OpenAI 地址」或「Endpoint」。

5. 选择模型

进入「模型广场」查看当前可用模型。不同模型的能力、速度和价格倍率可能不同，请以控制台显示为准。

首次测试建议选择成本较低、响应稳定的文本模型，确认配置无误后再切换到更高能力模型。

6. 发起第一次请求

如果你使用代码测试，可以运行下面的 curl 示例：

curl https://api.oskyi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 你的API Key" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {
        "role": "user",
        "content": "你好，请用一句话介绍你自己。"
      }
    ]
  }'

请把 你的API Key 替换成你自己的 API Key，把 model 替换成控制台中可用的模型名称。

7. 查看调用记录

请求完成后，可以回到控制台查看：

• 请求是否成功。
• 使用了哪个模型。
• 消耗了多少额度。
• 失败时返回了什么错误信息。

如果请求失败，优先检查 API Key、接口地址、模型名称和账号余额。