完成第一次 API 请求

第一次请求只验证四件事：API 地址、Key、模型和分组是否匹配。先用简短文本测试，成功后再配置客户端或运行长任务。

请求前准备

确认以下项目已经完成：

• 账户有可用余额或匹配的有效订阅。
• 已从“可用渠道”复制准确模型名称。
• API Key 的分组包含目标模型。
• 已保存完整 API Key，且 Key 当前启用。

不要把真实 Key 直接写进公开脚本

本文先把 Key 放到当前终端的临时环境变量中。关闭终端后变量会消失，适合完成第一次测试，也能减少 Key 被复制到代码仓库的风险。

1. 设置当前终端的临时 Key

Windows PowerShell

$env:LUNORA_API_KEY = "你的_Lunora_API_Key"

只检查长度，不输出完整内容：

$env:LUNORA_API_KEY.Length

macOS 或 Linux

export LUNORA_API_KEY="你的_Lunora_API_Key"

只检查长度：

echo ${#LUNORA_API_KEY}

2. 发送最小文本请求

Lunora OpenAI 兼容文本端点是：

https://api.uselunora.com/v1/chat/completions

把“控制台显示的模型名称”替换为“可用渠道”中的真实名称。

Windows PowerShell

$headers = @{
  Authorization = "Bearer $env:LUNORA_API_KEY"
}

$body = @{
  model = "控制台显示的模型名称"
  messages = @(
    @{ role = "user"; content = "请只回复：连接成功" }
  )
} | ConvertTo-Json -Depth 5

$request = @{
  Uri = "https://api.uselunora.com/v1/chat/completions"
  Method = "Post"
  Headers = $headers
  ContentType = "application/json"
  Body = $body
}

Invoke-RestMethod @request

macOS 或 Linux

curl -sS "https://api.uselunora.com/v1/chat/completions" \
  -H "Authorization: Bearer $LUNORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "控制台显示的模型名称",
    "messages": [
      {"role": "user", "content": "请只回复：连接成功"}
    ]
  }'

客户端地址不一定使用这个完整端点

本页直接测试 Chat Completions，所以使用完整 /v1/chat/completions。Claude Code、Codex 和 WorkBuddy 的配置字段不同，必须按各自教程填写，不能把本页地址复制到所有客户端。

3. 判断请求是否成功

成功响应通常包含模型回复、模型名称和用量信息。字段结构可能随协议兼容层变化，但需要同时满足：

1. 命令返回 JSON，而不是网页 HTML。
2. 返回内容中有模型回复，不是错误对象。
3. 控制台请求记录出现本次调用。
4. 记录中的模型、Key 分组和状态正确。
5. 余额或订阅用量变化与一次短请求相符。

4. 用控制台记录复核

返回 Lunora 控制台的请求或用量记录，按刚才的时间核对：

• 请求状态是否成功。
• 使用的模型是否与命令一致。
• 调用来源或 API Key 是否正确。
• 输入、输出和最终消耗是否合理。

命令有回复但控制台完全没有记录时，先确认请求是否真的发往 api.uselunora.com，以及本地代理或客户端是否改写了地址。

5. 清除临时 Key

测试完成后可以清除当前终端变量。

Windows PowerShell：

Remove-Item Env:LUNORA_API_KEY

macOS 或 Linux：

unset LUNORA_API_KEY

收到错误怎么办

状态或现象	优先检查
401	Key 是否完整、启用，环境变量是否在当前终端中
403	Key 分组是否包含目标模型，账户是否有对应权限
404	地址是否完整，是否重复添加 /v1 或接口路径
429	并发、余额、订阅额度和当前限制
502 / 503	可用渠道和上游是否暂时异常
返回 HTML	请求地址填成了控制台网页地址，而不是 API 地址
模型不存在	模型名称与“可用渠道”当前值不一致

不要在失败时高速重复请求。先保存完整错误文字、发生时间、模型和 Key 名称，再按常见问题排查。

下一步

最小请求成功后，选择实际使用方式：

• CC Switch 一键导入
• Codex 接入
• Claude Code 接入
• WorkBuddy 接入
• AI 生图工作台
• 在 Codex 中生图
• 直接调用生图 API

开始正式使用后，阅读余额、订阅与用量记录，学会按请求时间核对消耗。