调用 Qwen3.7-Max 的 API 需要哪些参数？返回格式是什么？

调用 Qwen3.7-Max 模型的 API 所需参数及返回格式如下：

一、所需关键参数

1. Base URL
   • 若通过 按量计费 方式调用，使用地域对应的兼容 API 地址，例如华北2（北京）：

     https://dashscope.aliyuncs.com/compatible-mode/v1
     

   • 注意：Qwen3.7-Max 不支持 Token Plan 团队版和 Coding Plan，因此只能通过按量计费方式调用。

在阿里云百炼AI大模型官方平台查看精准报价：https://t.aliyun.com/U/fPVHqY

目前开通阿里云百炼AI大模型平台：https://t.aliyun.com/U/fPVHqY 可以免费领取超7000万Tokens，每个大模型100万Tokens，如下图：

1. API Key

   • 需使用与所选地域匹配的阿里云百炼 API Key（即 DashScope API Key）。

2. Model ID

   • 指定模型为 qwen3.7-max。

3. result_format（推荐设置）

   • Qwen3.7-Max 属于 Qwen3-Max 系列，必须将 result_format 设置为 message，否则可能无法正常返回多轮对话结构。
   • 该参数需放入请求体的 parameters 对象中（HTTP 调用时）。

4. response_format（可选）

   • 默认为 {"type": "text"}；若需结构化 JSON 输出，可设为 {"type": "json_object"}，但提示词中需明确要求模型输出 JSON。

二、返回格式

• 默认返回格式为 OpenAI 兼容的 message 格式（因 Qwen3.7-Max 强制要求 result_format=message），示例如下：

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

• 若启用 response_format: {"type": "json_object"} 且提示合规，则 content 字段为合法 JSON 字符串。

⚠️ 注意：Qwen3.7-Max 不在 Coding Plan 或 Token Plan 支持列表中，仅可通过按量计费调用，且免费额度仅适用于中国内地（北京）地域。