5 分钟完成第一次请求

用一条最小的文本请求，同时验证请求地址、API Key 和模型名称。完成后，你就拥有了一条可继续扩展的调用链路。

完成标准： 请求返回有效 JSON，其中包含模型信息和一条正常的回复内容或结果对象。

开始前确认

需要准备	如何确认
完整 API Key	来自创建成功弹窗，而不是列表页中的密钥前缀。
Base URL	使用 `https://api.ggpu.ai`。
可用模型名称	与账号当前可调用的模型保持一致。

还没有访问凭证时，先完成 API Key 创建。

发起请求

准备环境变量

在终端中设置请求地址、完整 API Key 和模型名称：


export BASE_API_URI="https://api.ggpu.ai"
export GGPU_API_KEY="<你的完整 API Key>"
export GGPU_MODEL="<你的模型名称>"

真实密钥只应保存在当前终端会话或安全的密钥管理工具中，不要写入代码、截图或提交到 Git 仓库。

发送最小文本请求

复制下面的命令并执行。这个请求只包含一条用户消息，便于排除额外参数带来的干扰。


curl "${BASE_API_URI}/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${GGPU_API_KEY}" \
  -d '{
    "model": "'"${GGPU_MODEL}"'",
    "messages": [
      { "role": "user", "content": "你好" }
    ]
  }'

检查返回结果

不同模型的字段可能略有差异，但成功响应通常包含请求 ID、实际模型和回复内容。例如：


{
  "id": "chatcmpl_...",
  "model": "<实际返回的模型>",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "你好！"
      }
    }
  ]
}

失败时按顺序排查

先确认错误属于地址、鉴权、模型还是额度问题，再修改配置。不要同时替换所有参数，否则很难判断是哪一项生效。

现象	优先检查
无法连接或路径不存在	Base URL 是否为 `https://api.ggpu.ai`，路径是否为 `/v1/chat/completions`。
提示鉴权失败	是否使用完整 Key，请求头是否包含 `Authorization: Bearer ...`。
提示模型不可用	模型名称是否拼写正确，账号是否具备该模型的使用权限。
提示额度或限流	账户总额度、单 Key 额度以及当前限流状态。

调用成功后

现在可以在这条最小请求上逐步加入流式输出、更多消息和业务参数。每次只增加一类变化，出现问题时更容易定位。