记录请求标识用于排查

当 API 请求失败、响应变慢或结果需要复核时，先记录响应头中的 traceresponse 和响应体中的 id。这两个值用于定位同一次请求；它们不表示模型版本、后端配置版本，也不是防篡改签名。

获取响应头和响应体

使用 --dump-header 保存响应头，使用 --output 保存响应体。不要把带有 Authorization 请求头的 verbose 日志直接发送给他人。

先按您使用的终端选择命令。以下示例都会把响应头写入 response-headers.txt，把响应体写入 response.json。

在 macOS、Linux、WSL 或 Git Bash 中保存响应

以下命令适用于 bash/zsh 等 POSIX 风格 Shell：

curl --silent --show-error \
  --dump-header response-headers.txt \
  --output response.json \
  --url "https://cloud.infini-ai.com/maas/v1/chat/completions" \
  --header "Authorization: Bearer $API_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '{
    "model": "kimi-k2.6",
    "messages": [
      {
        "role": "user",
        "content": "你是谁"
      }
    ]
  }'

在 PowerShell 中保存响应

PowerShell 中请使用 curl.exe，避免把命令解析为 PowerShell 的 curl 别名。

$body = @'
{
  "model": "kimi-k2.6",
  "messages": [
    {
      "role": "user",
      "content": "你是谁"
    }
  ]
}
'@

curl.exe --silent --show-error `
  --dump-header response-headers.txt `
  --output response.json `
  --url "https://cloud.infini-ai.com/maas/v1/chat/completions" `
  --header "Authorization: Bearer $env:API_KEY" `
  --header "Content-Type: application/json" `
  --data-raw $body

在 CMD 中保存响应

CMD 中使用 %API_KEY% 读取环境变量，并用 ^ 换行：

curl.exe --silent --show-error ^
  --dump-header response-headers.txt ^
  --output response.json ^
  --url "https://cloud.infini-ai.com/maas/v1/chat/completions" ^
  --header "Authorization: Bearer %API_KEY%" ^
  --header "Content-Type: application/json" ^
  --data-raw "{\"model\":\"kimi-k2.6\",\"messages\":[{\"role\":\"user\",\"content\":\"你是谁\"}]}"

执行成功后，终端通常不会显示响应内容；响应头已写入 response-headers.txt，响应体已写入 response.json。如果请求返回错误，也先保留这两个文件。排查时需要把请求标识、错误响应和请求时间放在一起看。

记录 traceresponse

在 response-headers.txt 中查找 traceresponse：

traceresponse: 00-2605091906134c4421797807457ee045-fd3bf3deadfe4cdc-01

联系技术支持时提供该值。平台可据此定位对应的后端请求链路。

记录响应 id

在 response.json 中记录 id、model 和 usage：

{
  "id": "15b1845672c7410db3c3157ca8554dff",
  "object": "chat.completion",
  "model": "kimi-k2.6",
  "usage": {
    "prompt_tokens": 9,
    "completion_tokens": 116,
    "total_tokens": 125
  }
}

将 id 与请求时间、模型 ID、HTTP 状态码、耗时和 Token 用量一起写入业务日志。这样可以在排查时把业务侧记录、API 响应和平台侧请求链路对应起来。

提供排查信息

联系技术支持前，先整理以下信息：

• 请求时间和时区。
• 请求端点和模型 ID。
• HTTP 状态码和错误响应。
• 响应头中的 traceresponse。
• 响应体中的 id。
• 客户端、SDK 或工具名称。
• 已脱敏的请求参数。

不要发送 API Key、完整密钥日志或包含敏感信息的原始输入。如果已经把密钥写入日志、截图或工单，请立即停用并重新创建 API Key。