发送第一次 API 请求

这条路径适合你要自己写脚本或接程序的时候。完成后，你会看到两件事：当前 Token 真正可用的模型列表，以及一条实际返回的 OK。

准备

• 已创建一枚有限期限、有限额度的 Token。
• 电脑上可以使用 curl，或在 Windows 中使用 PowerShell。
• 选择一个不会包含私人数据的测试提示词。

Token 不应直接写进命令、脚本文件或浏览器 URL。先把它放入当前终端的临时环境变量。

macOS、Linux 或 Bash

运行后粘贴 Token 并按 Enter；输入不会显示：

read -s ZHIFLO_API_TOKEN
export ZHIFLO_API_TOKEN

PowerShell

运行后在安全输入中粘贴 Token：

$secureToken = Read-Host "Paste your ZhiFlo Token" -AsSecureString
$env:ZHIFLO_API_TOKEN = [System.Net.NetworkCredential]::new("", $secureToken).Password

1. 先列出可用模型

macOS、Linux 或 Bash

curl --silent --show-error \
  --config - \
  "https://api.zhiflo.com/v1/models" <<CURL_CONFIG
header = "Authorization: Bearer ${ZHIFLO_API_TOKEN}"
CURL_CONFIG

这里通过标准输入把认证头交给 curl，展开后的 Token 不会出现在 curl 的命令行参数中。

PowerShell

$headers = @{ Authorization = "Bearer $env:ZHIFLO_API_TOKEN" }
$models = Invoke-RestMethod -Uri "https://api.zhiflo.com/v1/models" -Headers $headers
$models.data | Select-Object -ExpandProperty id

PowerShell 会逐行显示可用模型 ID。

响应中的 data[].id 是当前 Token 可以使用的模型 ID：

{
  "data": [
    {
      "id": "<MODEL_FROM_ZHIFLO>",
      "object": "model"
    }
  ],
  "...": "..."
}

复制实际返回的完整 id。如果响应没有 data，先根据状态码查看 错误与恢复动作，不要继续猜模型名。

2. 再发送聊天请求

把下面的 <MODEL_FROM_ZHIFLO> 替换为刚才返回的完整模型 ID。

macOS、Linux 或 Bash

curl --silent --show-error \
  --request POST \
  --url "https://api.zhiflo.com/v1/chat/completions" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "<MODEL_FROM_ZHIFLO>",
    "messages": [
      {"role": "user", "content": "Reply with OK only."}
    ]
  }' \
  --config - <<CURL_CONFIG
header = "Authorization: Bearer ${ZHIFLO_API_TOKEN}"
CURL_CONFIG

PowerShell

$body = @{
  model = "<MODEL_FROM_ZHIFLO>"
  messages = @(
    @{ role = "user"; content = "Reply with OK only." }
  )
} | ConvertTo-Json -Depth 4

$request = @{
  Uri = "https://api.zhiflo.com/v1/chat/completions"
  Method = "Post"
  Headers = $headers
  ContentType = "application/json"
  Body = $body
}

$response = Invoke-RestMethod @request
$response.choices[0].message.content

PowerShell 应显示 OK 或等价的简短文本。

成功响应会包含 choices，其中助手消息的 content 为 OK 或等价的简短文本：

{
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "OK"
      }
    }
  ],
  "usage": {
    "...": "..."
  }
}

看到这段助手内容，说明这条 API 路径已经走通：Base URL 正确，Bearer Token 正确，模型 ID 正确，而且模型真的返回了内容。

如果模型列表成功而聊天失败，Token 的基础认证已经通过；优先核对模型 ID、请求路径和 JSON 形状。下一步查看 API 错误。