完成第一次请求

首次请求的目标不是测试复杂能力，而是确认四件事：网络可达、密钥有效、分组正确、模型可用。

1. 设置密钥

macOS 或 Linux：

export SPRELAY_API_KEY="sk-your-key"

Windows PowerShell：

$env:SPRELAY_API_KEY = "sk-your-key"

2. 发送最小请求

下面使用当前模型广场中的示例模型。若该模型已调整，请替换为模型广场或 GET /v1/models 返回的可用名称。

macOS / Linux

curl https://sprelaytoken.com/v1/chat/completions \
  -H "Authorization: Bearer $SPRELAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      {"role": "user", "content": "只回复：连接成功"}
    ]
  }'

Windows PowerShell

$headers = @{
  Authorization = "Bearer $env:SPRELAY_API_KEY"
  "Content-Type" = "application/json"
}

$body = @{
  model = "gpt-5.4"
  messages = @(
    @{ role = "user"; content = "只回复：连接成功" }
  )
} | ConvertTo-Json -Depth 5

Invoke-RestMethod `
  -Uri "https://sprelaytoken.com/v1/chat/completions" `
  -Method Post `
  -Headers $headers `
  -Body $body

3. 判断是否成功

成功响应通常包含：

{
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "连接成功"
      }
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 3,
    "total_tokens": 15
  }
}

不同上游和模型返回的附加字段可能不同，业务代码不应依赖未在协议中约定的临时字段。

失败时按顺序检查

1. 请求地址是否完整且没有重复 /v1。
2. Authorization 是否为 Bearer 加一个空格再加密钥。
3. 密钥是否启用、未过期且还有额度。
4. 密钥分组是否支持请求中的模型。
5. 模型名称是否与模型列表完全一致。

完整说明见 API 错误码。

下一步：选择客户端配置或开发者接入。