Qwen 3.7 API 接入:Max 与 Plus 怎么选

先说结论:三个字符串,一个 base_url

任何 OpenAI 兼容客户端把 base_url 指向 https://api.kkaiapi.com/v1,model 选 qwen3.7-plus、qwen3.7-max 或 qwen3.6-plus 里的一个,请求格式都是标准的 /v1/chat/completions,不需要阿里云账号。多数场景默认用 qwen3.7-plus,任务需要家族里最强推理时再上 qwen3.7-max,qwen3.6-plus 只留给还没在新版本上重新跑过评测的存量项目。 三个 ID 拼写各不相同,以 /v1/models 返回的列表为准,打错字直接返回模型不存在。

curl https://api.kkaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的kkaiapi密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3.7-plus",
    "messages": [{"role": "user", "content": "用两句话说清楚 Qwen 3.7 Max 和 Plus 的区别"}]
  }'

三个 ID 到底是什么

Qwen3.7-Max 是阿里的文本旗舰,今年 5 月 20 日在阿里云峰会上公布,API 从 5 月 19 日就已经上线,面向最难的文本任务:复杂代码生成、多步 Agent 规划、长程执行。 Qwen3.7-Plus 在 6 月 1 日全量上线,是在 3.7 文本底座上加了视觉和视频理解能力的走量款,发布定价明显低于 Max。这里要提醒一句:kkaiapi 目录里这个 ID 是作为纯文本的 chat completions 模型提供的,如果你的场景需要图片输入能力,先用一次小请求验证一下再往上搭。 Qwen3.6-Plus 是上一代,4 月发布。有个事实要说清楚:kkaiapi 目录里 qwen3.6-plus 的价格比 qwen3.7-plus 更高,厂商自己在 3.7 发布时就是这么定价的,所以没有成本上的理由继续用 3.6,它存在的意义是给还没在 3.7 上重跑评测、需要行为稳定性的存量场景当过渡,尽快把评测跑到 3.7 上才是该做的事。 三个 ID 在 kkaiapi 目录里都是 100 万 token 上下文,和阿里官方公布的 3.7 系列窗口一致。

Python 与 JavaScript 快速接入

两个官方 OpenAI SDK 都支持自定义 base_url,model 字段原样传字符串,一个客户端对象可以在 qwen3.7-plus 和 qwen3.7-max 之间随时切换,方便做成本和质量的权衡实验。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KKAIAPI_KEY"],
    base_url="https://api.kkaiapi.com/v1",
)

resp = client.chat.completions.create(
    model="qwen3.7-plus",
    messages=[
        {"role": "system", "content": "你是一个简洁的助手。"},
        {"role": "user", "content": "从这段会议记录里提取行动项:..."},
    ],
    max_tokens=2000,
)
print(resp.choices[0].message.content)
print(resp.usage)

Max 和 Plus 具体怎么选

不确定选哪个的时候,最快的办法是同一批 prompt 分别在 qwen3.7-plus 和 qwen3.7-max 上跑一遍,看输出质量和 completion_tokens,两项都占优的一档赢下这个位置。

• qwen3.7-plus 是默认档:抽取、摘要、分类、日常对话、大批量 Agent 步骤,发布定位就是量大质量够
• qwen3.7-max 留给硬骨头:多步 Agent 规划、复杂代码生成,厂商把最强推理能力放在这一档,价格也最高
• 规划者与执行者分工很自然:qwen3.7-max 出规划,qwen3.7-plus 按规划执行,两个字符串一个循环
• 单次响应超过约 3 万 token 的场景优先考虑 qwen3.7-max,厂商发布的输出上限规格里 Max 明显高于 Plus
• qwen3.6-plus 只用于还没重跑评测的存量项目,价格比 3.7-plus 更高,当成过渡而不是终点

按 100 万 token 上下文做预算

三个 Qwen ID 在这里都是 100 万 token 上下文,意味着整仓库级别的提问、大文档集合、超长 Agent 会话不会被截断卡住。但这不代表不花钱:上下文里的每个 token 都按输入计费,一个携带 30 万 token 状态的循环,每一步都要重新为这些状态付费。 实操上把窗口当成上限而不是目标:prompt 按任务实际需要的范围裁剪,长期状态尽量用摘要代替原文携带,真正配得上超大上下文的请求(全仓库审查、全文档集合提问)才值得把窗口用满。用量日志里的 prompt_tokens 一栏,一天之内就能告诉你上下文纪律有没有守住。

价格对照

按量计费,实时价格以 /pricing 为准。

验证接入与排查首次调用

先查一次模型列表,确认三个 Qwen ID 都能调到,拼写以列表为准。 401 多半是 Key 没导出到当前 shell;404 常见于 base_url 漏了 /v1;模型不存在多是漏了点或连字符,qwen3.7-plus 和 qwen3.7-max 是精确字符串;finish_reason 是 length 说明 max_tokens 设小了,先调大再评判输出质量。

curl -s https://api.kkaiapi.com/v1/models \
  -H "Authorization: Bearer sk-你的kkaiapi密钥" | grep qwen

常见问题