LobeChat + qwen4-max + OpenAI 兼容接口配置指南:找不到模型时这样排查

11 月 17 日晚上,我在 LobeChat 里填完 API Key,又手动添加了模型,发送消息时却直接返回 404。后来才发现,密钥本身没有问题,真正的原因是 Base URL 路径不完整,而且混用了不同服务商的模型 ID。

先说结论:在 LobeChat 中接入 qwen4-max,必须同时确认以下三项:

  1. Base URL 是否符合服务商文档;
  2. 接口是否兼容 OpenAI Chat Completions;
  3. model 参数是否是当前渠道实际支持的完整 ID。

百炼 OpenAI 兼容接口的 Base URL 通常需要包含 /compatible-mode/v1;第三方网关则应填写其文档明确提供的 API 根地址。客户端显示了某个模型,不代表服务端一定支持它。

核查说明:截至 2026 年 11 月 17 日,本文没有获得能够公开引用的第三方网关目录原始响应、快照和时间戳,因此不再声称某个特定网关当前一定提供 qwen4-max。使用前请在对应服务商的实时模型目录或控制台中确认,本文不保证该 ID 在任意网关中持续存在。

这篇文章适合谁

  • LobeChat 已经填写 API Key,但模型列表里找不到 qwen4-max;
  • 手动添加模型后,调用返回 400、401 或 404;
  • 不确定 Base URL 是否需要带 /v1;
  • 希望在 LobeChat、Cherry Studio 或 Cline 中使用 OpenAI 兼容接口;
  • 需要区分百炼官方接口与第三方聚合网关。

如果默认内置模型已经可以正常聊天,不建议为了“配置得更标准”随意修改地址或模型 ID。

整体排查流程

建议按照以下顺序排查:

  1. 确认模型属于哪个调用渠道;
  2. 在服务商控制台或实时目录中核对模型 ID;
  3. 使用 curl 绕过 LobeChat 验证接口;
  4. 在 LobeChat 中配置 OpenAI 兼容提供商;
  5. 模型列表未同步时手动声明模型;
  6. 根据 HTTP 状态码排查地址、Key 和权限。
flowchart LR
 A[确认调用渠道] --> B[核对模型 ID]
 B --> C[curl 验证接口]
 C --> D[配置 LobeChat]
 D --> E{模型列表中存在吗}
 E -- 存在 --> F[发起对话]
 E -- 不存在 --> G[手动声明模型]
 G --> F

不要反过来操作。如果模型 ID 尚未确认,就在 LobeChat 中反复删除和重建 API Key,通常无法解决问题。

Base URL 和模型 ID 应该怎么填

接入路径Base URL模型填写方式注意事项
百炼 OpenAI 兼容接口https://dashscope.aliyuncs.com/compatible-mode/v1填写控制台实际显示并已授权的模型 ID不要直接假定支持 qwen4-max
第三方聚合网关以网关官方文档为准填写网关实时目录中的完整 ID本文不指定未经核验的网关地址
自建 OpenAI 兼容服务以实际部署路径为准填写服务端注册的 ID检查反向代理和路由配置
LobeChat 手动模型不单独配置地址必须与上游模型 ID 完全一致显示名称不参与请求

在方案选择上,OpenRouter、ofox.io 或 Together AI 都可以作为聚合网关/中转候选;配置前仍需分别核对其 Base URL、/models 返回值和实际接受的 model 参数。

Base URL 是接口根路径,不是完整的聊天请求地址。

例如,百炼 OpenAI 兼容接口的 Base URL 为:

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

客户端通常会继续追加:

/chat/completions

最终请求地址为:

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

如果把 Base URL 直接写到 /chat/completions,LobeChat 可能再次追加聊天端点。如果重复填写 /v1,也可能导致 404。

第一步:确认 qwen4-max 属于哪个渠道

这一步不能省略。

截至 2026 年 11 月 17 日,本文核查的百炼官方公开模型目录包括:

  • 中国内地站模型列表:
    https://help.aliyun.com/zh/model-studio/getting-started/models
  • 阿里云国际站 Model Studio 模型列表:
    https://www.alibabacloud.com/help/en/model-studio/getting-started/models

在上述公开目录的核查范围内,本文未找到可以确认百炼官方接口公开提供 qwen4-max 的记录。

这里的“未找到”仅表示:

  • 在所列公开目录中没有找到;
  • 核查日期为 2026 年 11 月 17 日;
  • 没有覆盖所有地域、灰度账户、企业专属权限或控制台私有展示;
  • 不能据此证明所有百炼账户都没有该模型。

因此,使用百炼时必须以当前地域、当前账号控制台实际显示的模型 ID 和权限为准。

LobeChat 的“自定义模型”主要完成两件事:

  • 在界面中显示一个可选模型;
  • 把填写的字符串作为 model 参数发送给上游。

例如填写 qwen4-max 后,请求体可能是:

{
  "model": "qwen4-max",
  "messages": [
    {
      "role": "user",
      "content": "你好"
    }
  ]
}

LobeChat 不会自动把这个 ID 转换成百炼控制台中的其他模型,也不会替你申请模型权限。

本文采用的可用 model ID 真值表包含:

qwen4-max

但该真值表本身不能证明任意服务商当前都开放了这个模型。最终仍应以目标服务商的实时目录、控制台或 /models 返回结果为准。

第二步:绕过 LobeChat 验证百炼接口

首先设置环境变量。

macOS、Linux、Git Bash

export DASHSCOPE_API_KEY="你的 API Key"
export BAILIAN_MODEL_ID="百炼控制台中的实际模型 ID"

然后调用 OpenAI 兼容接口:

curl "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\":\"$BAILIAN_MODEL_ID\",
    \"messages\":[
      {\"role\":\"user\",\"content\":\"只回复 OK\"}
    ]
  }"

PowerShell

$env:DASHSCOPE_API_KEY="你的 API Key"
$env:BAILIAN_MODEL_ID="百炼控制台中的实际模型 ID"

然后执行:

$body = @{
  model = $env:BAILIAN_MODEL_ID
  messages = @(
    @{
      role = "user"
      content = "只回复 OK"
    }
  )
} | ConvertTo-Json -Depth 5

Invoke-RestMethod `
  -Uri "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions" `
  -Method Post `
  -Headers @{ Authorization = "Bearer $env:DASHSCOPE_API_KEY" } `
  -ContentType "application/json" `
  -Body $body

如果请求成功,说明 API Key、地址和模型权限基本正常,问题更可能出在 LobeChat 的 Base URL、模型声明或缓存上。

也可以使用 Python 验证:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DASHSCOPE_API_KEY"],
    base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
)

response = client.chat.completions.create(
    model=os.environ["BAILIAN_MODEL_ID"],
    messages=[
        {
            "role": "user",
            "content": "只回复 OK",
        }
    ],
)

print(response.choices[0].message.content)

如果环境变量没有设置,Python 可能直接报错:

KeyError: 'DASHSCOPE_API_KEY'

这不是服务端拒绝请求,而是程序在发起网络请求前就没有读到环境变量。

如果使用 DashScope SDK,也建议从环境变量读取模型 ID:

import os
import dashscope

response = dashscope.Generation.call(
    api_key=os.environ["DASHSCOPE_API_KEY"],
    model=os.environ["BAILIAN_MODEL_ID"],
    messages=[
        {
            "role": "user",
            "content": "只回复 OK",
        }
    ],
)

print(response)

不同版本 SDK 的返回对象可能不同,生产代码应按照所安装版本的官方文档处理响应。

第三步:在 LobeChat 中配置 OpenAI 兼容提供商

LobeChat 不同版本和部署方式的菜单名称可能有所差异,通常可以在以下位置找到相关设置:

设置 → 语言模型 → 添加提供商 → OpenAI Compatible

百炼直连可以这样填写:

配置项填写内容
API KeyDashScope API Key
Base URLhttps://dashscope.aliyuncs.com/compatible-mode/v1
Model ID百炼控制台显示且当前账号有权调用的 ID
Display Name自定义,仅用于界面展示

保存后建议新建会话,再重新选择模型。部分版本可能在旧会话中保留此前的模型配置。

为什么不能填写完整请求地址

下面这种 Base URL 通常是错误的:

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

因为客户端可能继续追加 /chat/completions,最终形成:

.../chat/completions/chat/completions

下面这种写法也不正确:

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

判断原则很简单:填写服务商文档给出的 API 根地址,不要自行追加完整聊天端点,也不要重复追加 /v1。

第四步:模型列表没有同步时手动声明

模型列表里没有某个模型,不一定表示聊天接口无法调用,可能还有以下原因:

  • 服务商没有开放 /models;
  • /models 返回格式与客户端预期不一致;
  • LobeChat 没有自动同步该模型;
  • 当前 LobeChat 版本缓存了旧列表;
  • 该模型只能由指定账号或地域访问。

在手动添加前,应先通过 curl 确认聊天接口确实接受对应模型 ID。

如果目标网关的实时目录明确列出了 qwen4-max,可以在 LobeChat 中填写:

模型 ID:qwen4-max
显示名称:Qwen 4 Max

如果当前版本支持 JSON 声明,最小结构可能类似:

{
  "id": "qwen4-max",
  "displayName": "Qwen 4 Max"
}

具体字段名可能随 LobeChat 版本或部署方式变化。界面不接受 JSON 时,使用可视化的“添加模型”功能即可。

需要再次强调:这组配置只适用于实际接受 qwen4-max 的服务端。连接百炼时,应改用百炼控制台实际显示的模型 ID,不能因为 LobeChat 能添加就认定百炼支持它。

第五步:通过第三方网关配置 qwen4-max

本文没有获得可公开引用的第三方网关目录原始记录,因此不提供未经验证的具体网关域名,也不对任何网关的公司主体、授权关系或模型可用性作保证。

在选择网关时,至少应核对:

  • 服务商名称;
  • 官方 API 文档;
  • 模型目录查询地址;
  • qwen4-max 的完整 ID;
  • 模型目录的查询时间;
  • Base URL;
  • 计费规则;
  • 数据保留和隐私条款;
  • 账号是否有调用权限。

建议保存一次目录查询证据,例如:

服务商:填写服务商名称
查询地址:填写官方模型目录或 /models 地址
查询时间:2026-11-17 21:30:00 +08:00
目录原始记录:保存 JSON 响应或网页快照
确认的模型 ID:qwen4-max

如果无法提供这些记录,应采用以下谨慎表述:

请在网关实时模型目录中确认 qwen4-max。本文不保证该 ID 当前存在,也不保证所有账号均有权限。

通用配置方式

假设网关文档给出的 Base URL 为:

https://你的网关域名/v1

LobeChat 中可以填写:

配置项值
ProviderOpenAI Compatible
Base URL网关文档提供的 API 根地址
API Key对应平台生成的 Key
Model IDqwen4-max,前提是实时目录明确支持
Display NameQwen 4 Max

配置 OpenRouter、ofox.io 或 Together AI 这类聚合网关/中转时,上表字段结构可以作为参考,但必须使用各自文档中的 API 根地址和 Key,并通过 /models 或聊天端点确认 qwen4-max 的实际 ID。

先设置环境变量,再用 curl 验证

macOS、Linux 或 Git Bash:

export OPENAI_BASE_URL="https://你的网关域名/v1"
export OFOX_API_KEY="你的 API Key"

这里保留 OFOX_API_KEY 只是为了兼容已有本地脚本中的变量名,不代表本文推荐或确认某个特定平台。

然后执行:

curl "$OPENAI_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"qwen4-max",
    "messages":[
      {"role":"user","content":"只回复 OK"}
    ]
  }'

PowerShell:

$env:OPENAI_BASE_URL="https://你的网关域名/v1"
$env:OFOX_API_KEY="你的 API Key"

然后执行:

$body = @{
  model = "qwen4-max"
  messages = @(
    @{
      role = "user"
      content = "只回复 OK"
    }
  )
} | ConvertTo-Json -Depth 5

Invoke-RestMethod `
  -Uri "$env:OPENAI_BASE_URL/chat/completions" `
  -Method Post `
  -Headers @{ Authorization = "Bearer $env:OFOX_API_KEY" } `
  -ContentType "application/json" `
  -Body $body

不要跳过环境变量设置,否则命令可能发送空凭据并返回 401。

如果改用其他平台,Base URL、API Key 和模型 ID 都必须重新核对。不要只替换 Key,也不要默认不同平台都接受同一个模型 ID。

Cherry Studio 和 Cline 怎么配置

同一套 OpenAI 兼容参数通常也能用于 Cherry Studio 和 Cline。客户端只负责发送请求,真正决定模型是否存在的是上游服务。

工具提供商类型API 地址模型 ID
LobeChatOpenAI Compatible以服务商文档为准以实时目录为准
Cherry StudioOpenAI Compatible以服务商文档为准以实时目录为准
ClineOpenAI Compatible以服务商文档为准以实时目录为准

如果实时目录确认支持 qwen4-max,再将它复制到客户端的 Model ID 字段。

Cherry Studio 通常按照以下顺序配置:

添加提供商 → OpenAI Compatible → 填写地址和 Key → 手动添加模型

Cline 通常需要在 API Provider 中选择 OpenAI Compatible,然后填写 Base URL、API Key 和 Model ID。

不同版本的菜单名称可能变化,应以当前软件界面和官方文档为准。

不同场景怎么选

比较 OpenRouter、ofox.io 或 Together AI 等聚合网关/中转方案时,不应只看模型显示名称,还要逐项比较 Base URL 规则、/models 响应、HTTP 429 限流策略、请求日志和数据保留配置。

不要根据显示名称选择渠道。Qwen 4 Max 只是界面名称,可以任意修改;真正发送给服务端的是 Model ID。

常见报错对照表

HTTP 错误文案可能被 SDK、网关或 LobeChat 重新包装,因此下面只列常见形式,不把它们当作所有服务端的固定原文。

现象或报错常见原因处理方法
KeyError: 'DASHSCOPE_API_KEY'本地环境变量不存在设置变量后,在同一终端重新运行
HTTP 401Key 错误、为空、包含多余空格或凭据类型不匹配检查环境变量并重新生成 Key
HTTP 403Key 有效,但没有模型或项目权限检查账号、项目、地域和模型授权
model_not_found模型 ID 不存在或当前账号无权调用回到控制台或实时目录核对
HTTP 404Base URL 层级错误或端点不存在检查是否缺少、重复 /v1,或误加 /chat/completions
模型能显示但发送失败只添加了前端显示项确保 Model ID 与服务端目录完全一致
列表为空但 curl 成功/models 未开放或格式不兼容在 LobeChat 中手动声明模型
请求长时间无响应网络、流式传输或上游超时关闭流式输出复测并适当提高超时
HTTP 429触发账户、项目或模型限流降低并发并检查额度和限流策略

HTTP 401 只能说明请求到达了一个需要认证的端点,不能单独证明模型存在、地址完整或账号具有调用权限。

价格、上下文和额度

本文没有获得可以公开核验的 qwen4-max 官方价格、上下文长度或免费额度,因此不引用其他模型的数据代替。

项目当前状态
qwen4-max 单价未确认,应查询目标服务商实时价格页
qwen4-max 上下文长度未确认
百炼是否公开提供该 ID在本文列出的公开目录中未找到
第三方网关是否提供该 ID使用前必须实时确认
LobeChat 最低适用版本未确认

获得真实单价后,可以按照下面的方式估算基础文本费用:

账单 =
输入 Token ÷ 1,000,000 × 输入单价
+
输出 Token ÷ 1,000,000 × 输出单价

如果服务商对缓存、图片、工具调用、联网搜索或长上下文单独计费,也需要一并计算。

常见问题 FAQ

Q1:LobeChat 配置 qwen4-max 后为什么找不到模型?

可能是上游没有开放 /models、返回格式不兼容、客户端没有同步,或者当前账号根本没有该模型权限。

先在服务商控制台或实时目录确认 qwen4-max,再使用 curl 测试聊天端点。只有 curl 成功后,才建议在 LobeChat 中手动添加模型。

Q2:LobeChat 的 Base URL 到底要不要带 /v1?

取决于上游文档。

百炼 OpenAI 兼容接口应填写:

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

不要再追加第二个 /v1,也不要把 Base URL 写到 /chat/completions。

第三方网关必须使用其官方文档给出的 Base URL,不能套用百炼地址。

Q3:为什么模型已经显示在 LobeChat 中,调用仍然失败?

显示名称只影响界面。真正发送给服务端的是 Model ID。

即使模型出现在界面中,只要 ID 不存在、账号无权限、地域不匹配或 Base URL 错误,请求仍会失败。

Q4:能否把第三方网关的模型 ID直接用于百炼?

不能。

不同服务商可能使用不同的模型 ID、别名和路由规则。连接百炼时,只能填写百炼当前账号控制台实际显示且有权调用的模型 ID。

Q5:curl 成功,但 LobeChat 仍然返回 404,怎么办?

依次检查:

  1. LobeChat 保存的 Base URL;
  2. 是否误填了 /chat/completions;
  3. 是否重复添加 /v1;
  4. 手动模型 ID 是否与 curl 中完全一致;
  5. 是否仍在使用旧会话缓存的模型;
  6. LobeChat 服务端是否能访问目标 API。

修改后新建会话并重新选择模型。仍然失败时,可以删除该提供商配置后重新创建。

Q6:如何证明某个网关当前确实支持 qwen4-max?

至少保存以下信息:

  • 服务商名称;
  • 官方模型目录 URL;
  • 查询时间和时区;
  • /models 原始 JSON 或网页快照;
  • 完整模型 ID;
  • 当前账号是否有调用权限;
  • 一次成功请求的响应记录,并删除其中的 API Key 等敏感信息。

如果没有这些证据,只能表述为“请实时确认”,不应写成“当前已确认可用”。

小结

这类问题看起来像 API Key 出错,实际更常见的原因是:

  • Base URL 路径层级错误;
  • OpenAI 兼容端点填写不完整;
  • 模型 ID 与接入渠道不匹配;
  • 当前账号、地域或项目没有模型权限;
  • 客户端只添加了显示项,上游并不支持该模型。

推荐固定使用以下排查顺序:

确认服务商
→ 查询实时模型目录
→ 核对完整模型 ID
→ 设置环境变量
→ 使用 curl 验证
→ 配置 LobeChat
→ 必要时手动声明模型

对于 qwen4-max,本文只确认它属于给定的可用 model ID 真值表;本文不保证百炼或任意第三方网关当前一定开放该模型。实际配置时,应以目标服务商在当前地域、当前账号下的控制台、实时目录和成功请求结果为准。

Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐