在聚合站上第一次调 Qwen：能证明路由打通的最小请求

为什么需要最小请求

在聚合站上第一次调用某个模型时，最忌讳一上来就写复杂的业务逻辑。一旦出错，你很难判断是路由配置、密钥权限、参数格式还是模型本身的问题。构造一个最小化的请求，只保留必要的字段，可以快速验证「从你的代码到目标模型」这条链路是否通畅。

本文以 Qwen 为例，演示如何用最少的代码发出请求，并通过响应字段确认调用确实落在 Qwen 后端。

准备：模型别名与端点

聚合站通常为每个模型提供一个别名，例如 qwen-max、qwen-plus 等。具体别名列表请查阅你所用站点的模型文档。端点一般与 OpenAI 兼容，即 /v1/chat/completions。

请求头需要包含：

• Authorization: Bearer <你的 API Key>
• Content-Type: application/json

最小请求体

一个能证明路由打通的最小请求体只需要两个字段：model 和 messages。

{
  "model": "qwen-max",
  "messages": [
    { "role": "user", "content": "Hello" }
  ]
}

说明：

• model 使用聚合站文档中给出的 Qwen 别名，不要臆造。
• messages 至少包含一条 user 消息。内容可以极短，目的是触发一次真实的模型推理。
• 不要添加 temperature、max_tokens 等可选参数，减少变量。

发送请求

用 curl 发送：

curl -X POST https://api.example.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-max",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

如果返回 HTTP 200 且响应体包含 choices 数组，说明链路基本打通。但还不能完全确定调用落在 Qwen 上，需要进一步检查响应字段。

解读响应字段：确认落在 Qwen

一个典型的响应结构如下（字段名可能因聚合站实现略有差异）：

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "created": 1710000000,
  "model": "qwen-max",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Hello! How can I help you?" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 5, "completion_tokens": 7, "total_tokens": 12 }
}

关键字段解读：

• model：响应中的 model 字段应与请求中的模型别名一致。如果聚合站返回的是实际后端模型名（如 qwen-max 或带版本号的名称），也能佐证路由目标。若该字段为空或与请求不符，需要警惕。
• id：请求 ID 通常由聚合站生成，可用于后续排查。部分站点会在 ID 中嵌入模型标识或路由信息，但不要依赖此规律。
• choices[0].message.content：内容非空且语义合理，说明模型确实被执行。
• usage：包含 token 计数，表明请求被正常计量。

此外，部分聚合站会在响应头中返回 X-Model-Backend 或类似字段，明确指示实际调用的后端。请查阅你所用站点的文档确认。

常见问题与排查

响应中 model 字段与请求不一致

可能原因：

• 请求的模型别名不存在，聚合站回退到默认模型。
• 聚合站配置了别名映射，实际后端模型名与别名不同。

建议：核对站点文档中的模型别名列表，确保拼写正确。如果别名正确但 model 字段仍不一致，联系站点支持确认路由策略。

返回 4xx 错误

• 401：API Key 无效或未正确传递。
• 404：端点路径错误，检查是否遗漏 /v1。
• 400：请求体格式错误，常见于 messages 不是数组或缺少 role/content。

返回 5xx 错误

可能是上游模型服务暂时不可用。稍后重试，或尝试同一提供商的其他模型别名以判断是否影响面。

响应内容为空

检查 finishreason。若为 length，可能是 maxtokens 设置过小（但最小请求未设置该参数，一般不会出现）。若为 content_filter，说明内容被安全策略拦截。

进阶验证：用已知答案确认模型身份

如果对路由仍有疑虑，可以发送一个简单的事实性问题，例如「中国的首都是哪里？只回答城市名。」然后检查回答是否为「北京」。这不能 100% 证明是 Qwen，但可以排除完全错误的路由。更严谨的方式是查阅聚合站是否提供模型指纹或后端标识字段。

小结

最小请求的核心是只保留 model 和 messages，减少干扰因素。通过检查响应中的 model 字段、id、usage 以及响应头中的后端标识（如有），可以确认调用是否真正落在 Qwen 上。遇到不一致时，优先核对模型别名和站点文档，再联系支持。