完成第一次请求

首次请求只验证四件事：网络可达、密钥有效、分组正确、模型可用。不要在这一步加入长提示词、图片、工具调用或流式输出。

1. 设置密钥

先把真实密钥放入当前终端的环境变量。命令执行后不会显示密钥，这是正常现象。

macOS / Linux

# 把 sk-your-key 替换为密钥页面复制的完整值。
# export 只对当前终端及其启动的程序生效。
export SPRELAY_API_KEY="sk-your-key"

Windows PowerShell

# 把 sk-your-key 替换为密钥页面复制的完整值。
# $env: 表示设置当前 PowerShell 窗口的环境变量。
$env:SPRELAY_API_KEY = "sk-your-key"

不要把真实密钥发给别人

本文出现的 sk-your-key 只是占位符。真实密钥不要写进截图、聊天记录、网页前端或 Git 仓库。

2. 发送最小请求

下面使用 gpt-5.6-sol。如果模型广场中已没有这个模型，请从模型广场或 GET /v1/models 复制一个当前密钥可用的模型 ID。

示例不会显示或判断模型回复的具体内容。只要服务器成功接受并完成请求，脚本就固定输出 --------返回成功--------；因此不需要安装 jq 等额外工具。

macOS / Linux

# --fail：HTTP 返回 4xx/5xx 时让命令失败。
# --silent --show-error：隐藏进度条，但失败时仍显示原因。
# --output /dev/null：丢弃模型响应正文，不在终端打印 JSON。
if curl --fail --silent --show-error \
  https://sprelaytoken.com/v1/chat/completions \
  -H "Authorization: Bearer $SPRELAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [
      {"role": "user", "content": "请回复 OK"}
    ]
  }' \
  --output /dev/null
then
  printf '%s\n' '--------返回成功--------'
else
  printf '%s\n' '--------请求失败--------' >&2
fi

Windows PowerShell

# Authorization 把当前终端中的密钥作为 Bearer Token 发送。
$headers = @{
  Authorization = "Bearer $env:SPRELAY_API_KEY"
  "Content-Type" = "application/json"
}

# PowerShell 哈希表会被转换成接口需要的 JSON。
# 提示词只用于发起最小生成，脚本不会显示模型回复。
$body = @{
  model = "gpt-5.6-sol"
  messages = @(
    @{ role = "user"; content = "请回复 OK" }
  )
} | ConvertTo-Json -Depth 5

# 请求成功时丢弃响应正文，只打印固定成功提示。
# 请求失败时进入 catch，并显示 PowerShell 返回的具体错误。
try {
  Invoke-RestMethod `
    -Uri "https://sprelaytoken.com/v1/chat/completions" `
    -Method Post `
    -Headers $headers `
    -Body $body | Out-Null

  Write-Output "--------返回成功--------"
}
catch {
  Write-Error "请求失败：$($_.Exception.Message)"
}

每个请求字段是什么意思

位置	作用	新手最容易出错的地方
请求地址	指定 Chat Completions 端点	不要写成重复的 /v1/v1
Authorization	证明请求属于你的账户	Bearer 后面必须有一个空格
Content-Type	告诉服务器正文是 JSON	不要删除或改成表单格式
model	指定要调用的模型	必须和模型列表中的 ID 完全一致
messages	提供对话消息	最外层必须是数组 []
role: user	表示这句话来自用户	不要把首次测试改成复杂角色结构
content	真正发送给模型的文字	这里只触发最小生成，不使用模型回复判断连接状态

3. 判断是否成功

命令行只应显示：

--------返回成功--------

看见这行文字，说明地址、密钥、分组和模型已经基本配置正确。成功提示由本地脚本在 HTTP 请求完成后输出，不依赖模型是否按照提示词回复；API 的原始响应正文会被丢弃。

失败时按顺序检查

1. 请求地址是否完整且没有重复 /v1。
2. Authorization 是否为 Bearer、一个空格、再加完整密钥。
3. 密钥是否启用、未过期且还有额度。
4. 密钥分组是否支持 gpt-5.6-sol。
5. 模型名称是否与模型列表完全一致。
6. macOS / Linux 显示 --------请求失败-------- 时，查看它前面的 curl 错误信息。

完整说明见 API 错误码。

完成后，请继续配置你实际使用的工具；右下角“下一篇”会直接进入客户端配置。