发送第一条 API 请求

用终端发送一条短请求，确认接口地址、API 密钥和模型配置正确。还没有密钥？先完成首次接入。

1. 设置密钥、模型和接口地址

从当前密钥可用列表选择一个支持目标接口的模型，把 YOUR_MODEL_ID 替换为准确 ID。选择终端类型后设置变量；关闭终端后，需要重新设置。

macOS / Linux / WSL

export OPENAI_API_KEY="sk-your-api-key"
export OPENAI_BASE_URL="https://1a1api.top/v1"
export OPENAI_MODEL="YOUR_MODEL_ID"

Windows PowerShell

$env:OPENAI_API_KEY="sk-your-api-key"
$env:OPENAI_BASE_URL="https://1a1api.top/v1"
$env:OPENAI_MODEL="YOUR_MODEL_ID"

将 sk-your-api-key 替换为自己的密钥，仅在本机操作；终端历史也可能保存输入，不要在共享设备上粘贴密钥，也不要公开截图或提交仓库。

2. 发送 Responses 请求

以下请求读取第 1 步的 OPENAI_MODEL。确认已替换占位符且模型支持 Responses，再发送一次；测试会消耗实际额度。

macOS / Linux / WSL · Responses API

curl "$OPENAI_BASE_URL/responses" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\": \"$OPENAI_MODEL\",
    \"input\": \"Reply with exactly: ok\"
  }"

Windows PowerShell · Responses API

$body = @{
  model = $env:OPENAI_MODEL
  input = "Reply with exactly: ok"
} | ConvertTo-Json

Invoke-RestMethod `
  -Method Post `
  -Uri "$env:OPENAI_BASE_URL/responses" `
  -Headers @{ Authorization = "Bearer $env:OPENAI_API_KEY" } `
  -ContentType "application/json" `
  -Body $body

使用 Chat Completions 的项目

项目或客户端要求 Chat Completions 时，确认 OPENAI_MODEL 对应模型支持该接口，再使用所用终端的完整示例。完整接口路径只用于请求，不填入 Base URL。

macOS / Linux / WSL · Chat Completions

curl "$OPENAI_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\": \"$OPENAI_MODEL\",
    \"messages\": [
      {\"role\": \"user\", \"content\": \"Reply with exactly: ok\"}
    ]
  }"

Windows PowerShell · Chat Completions

$body = @{
  model = $env:OPENAI_MODEL
  messages = @(
    @{ role = "user"; content = "Reply with exactly: ok" }
  )
} | ConvertTo-Json -Depth 5

Invoke-RestMethod `
  -Method Post `
  -Uri "$env:OPENAI_BASE_URL/chat/completions" `
  -Headers @{ Authorization = "Bearer $env:OPENAI_API_KEY" } `
  -ContentType "application/json" `
  -Body $body

3. 核对回复和调用日志

响应中应能读到 ok。再到控制台按测试时间查找对应请求，核对模型、状态、耗时和费用。

401环境变量未生效、密钥复制不完整，或自定义 HTTP 客户端没有发送 Authorization: Bearer ...。

403当前 API 密钥所属分组没有该模型权限，或余额、订阅条件不满足。

404接口根地址与接口路径重复，例如误写成 /v1/v1/responses。

429 / 超时先读错误代码和日志，区分限流、额度限制及连接超时。按 429 排查或 522 / 524 排查处理，不自动重复测试。

如果你还没有 API 密钥，或不知道该选哪个客户端，请回到首次接入。SDK 代码示例请看 OpenAI SDK 接入。