发起第一次 API 请求

用一个最小的 Responses 请求，验证地址、密钥和模型是否正确。

前置条件

准备有效密钥，确认其分组支持 Responses API，并对示例模型 gpt-6.1-sol 开放权限。该模型在文档整理时的公开目录中可见；可用性以当前分组为准。

这一步会发起真实请求

示例会调用模型，并按当前分组规则计费。请先确认额度，避免在失败时无间隔重复执行。

1. 设置密钥

macOS / Linux

export ACODE_API_KEY="sk-your-api-key"

Windows PowerShell

$env:ACODE_API_KEY="sk-your-api-key"

2. 发送请求

macOS / Linux

curl --fail-with-body --max-time 120 \
  https://acode.ink/v1/responses \
  -H "Authorization: Bearer $ACODE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "input": "请用一句话介绍你能帮我做什么。"
  }'

Windows PowerShell

$headers = @{
  Authorization = "Bearer $env:ACODE_API_KEY"
}
$body = @{
  model = "gpt-6.1-sol"
  input = "请用一句话介绍你能帮我做什么。"
} | ConvertTo-Json

$result = Invoke-RestMethod `
  -Uri "https://acode.ink/v1/responses" `
  -Method Post `
  -Headers $headers `
  -ContentType "application/json; charset=utf-8" `
  -Body ([System.Text.Encoding]::UTF8.GetBytes($body))

$result | ConvertTo-Json -Depth 20

3. 理解返回结果

Responses API 的返回通常包含请求 id、status、output 和 usage 等字段。文本位于输出消息的内容项中；不要把 reasoning 等非文本输出当作正文。

使用官方 SDK 时，可以通过 response.output_text 读取聚合后的文本，参见 Python 与 JavaScript。

HTTP 成功状态只是第一步，还应检查响应是否完成、是否含错误，以及是否收到预期输出。

4. 检查使用记录

在使用记录中核对时间、密钥与模型。若请求失败，保留状态码和响应中的错误信息。

现象	优先检查
401 / 403	密钥、权限、过期时间、所属分组
404	/v1/responses 路径、模型及接口支持
429	请求频率、并发和额度相关错误正文
5xx / 超时	渠道状态与是否已受理请求

更多处理方法见错误排查。