模型与 AI 提供商
NewMax Gateway 充值即用,或接入 15+ 模型提供商;订阅 OAuth 登录、生图视频、智能路由与故障转移。
模型是 NewMax 的引擎。新手用 NewMax Gateway 充值即用、无需 API Key;进阶可接入 15+ 提供商、用订阅账号 OAuth 登录、或跑本地 Ollama 离线模型。还能配置生图、视频、语音模型,一个入口管好全部 AI 能力。

模型设置分类
英文界面的「Settings → Models」使用 Chat、Images、Video、Text to speech、Speech to text 和 Usage 分类;Text to speech 用于生成语音,Speech to text 用于语音识别与转录。中文分类保持不变。设置搜索结果中的分类名称与顶部标签一致。
各模型页左侧仅保留列表标题和添加入口,不再显示拖拽排序说明;仍可拖动调整顺序,首位仍为默认配置。
国际版可在「Settings → Models → Chat」右上角点击 configuration guide,在应用内阅读配置教程,无需打开网页。教程按订阅登录、API Key 和本地模型分别说明接入方式,配有提供商目录、密钥输入框、模型优先级三张真实英文界面截图,图片离线可用且不展示真实密钥;提供商、模型和连接状态以你的设备为准。之后介绍模型 ID、默认顺序、连接测试和常见错误排查;使用自己的服务商不要求先登录 NewMax 或开启云同步。教程不会自动授权、修改配置或发起测试;实际点击连接测试会发送真实模型请求,服务商可能收费。点击右上角关闭、底部 Got it、遮罩或按 Esc 仅关闭教程,保留设置页。国内版此入口继续打开原外部配置指南。
英文图像模型添加页的模板分为 Direct APIs(厂商直连接口)和 API aggregators(聚合接口);视频、语音与转录配置中的 Custom provider → Provider name 对应中文「自定义渠道 → 渠道名称」。只是显示名称不同,API 格式、密钥和模型 ID 的配置方式不变。
直接通过对话制作视频
在普通对话说明想做的产品宣传片、功能演示或多镜头视频,给出产品、用途、时长、横竖画幅及可使用的素材。无需安装或选择视频 Skill,AI 可按需读取内置制作方法和模板,组织分镜、确定镜头方式、剪辑与验收。让 AI “加长到一分钟”“换风格”“调整节奏”时,可继续修改原视频工程并保留已认可片段。
- 只生成一个短片段:配置好自己的视频渠道后直接描述画面即可,不必走完整宣传片流程。
- 制作多镜头成片:先明确分镜和素材;真实产品界面、精确文字与 logo 不用生成画面冒充。需要模型生成片段时,在「设置 → 模型 → 视频生成 → 添加视频模型」完成本人渠道的配置或账号授权,可能消耗该渠道额度。
- 没有视频渠道:仍可规划分镜或使用已有授权素材,不代表模型生成已启用;AI 不会借用其他人的账号。
- 片型:可按宣传片、发布会长片、社交竖屏、功能讲解或无声首屏循环组织制作;循环片不默认添加片尾落版,讲解片先考虑配音和字幕。
- 制作依赖:代码动画、剪辑、字幕和混音可能需要 Node、Python、FFmpeg、ffprobe 或渲染依赖。AI 应先检查并说明缺项,获准后在独立视频工程内准备;内置指南及初始化模板不会自动安装这些软件。3D 模板仍需在实际环境验证。
- 素材与工程:只上传获准外发的参考素材;生成失败或结果不明时先核对已有结果,避免重复消耗。视频任务提交后若查询或下载中途断网,NewMax 会自动按原任务继续查询;仍未取回时,报错会给出任务 ID,让 AI 按原任务续取下载,不会重新提交或再次计费。最终 MP4、分镜、原片及检查记录保存在视频工程中。
- 先看样片再扩展:整片批量制作前先检查有前后语境的代表性动态样片。技术报告与实际原速观看分开记录;无法完成画面或声音检查时,应交待审样片并列出未验证项,不把工具成功或播放结束当成质量通过。
模型选择

在对话中可以随时切换 AI 模型。
如果显示「请重新选择模型」,说明保存的模型配置格式异常:请明确选择有效模型,或在「设置 → 模型」修正对应列表。NewMax 不会把异常对象或数字当作模型 ID,也不会因此自动切换到其它模型。若启动停在「应用程序发生异常」页,可使用「修复模型配置 → 备份并修复」,成功后重新加载;原设置先在本机备份,密钥、服务地址与历史保留。详细步骤见 settings.md。
操作步骤:在对话中切换模型
- 在对话输入框右侧找到模型选择器(显示当前模型名称和提供商 Logo)
- 点击下拉菜单 — 一级菜单显示提供商列表
- 鼠标移到提供商上,右侧弹出该提供商的模型二级菜单
- 点击目标模型即可切换;Opus 5.5 等长上下文模型会标注 (1M) 表示百万上下文
模型切换按对话隔离:在当前对话中切换模型不影响其他对话,也不会修改全局默认模型或后台任务的默认配置。每个对话独立记忆自己的模型和提供商;重新加载窗口不会把该对话的临时配置保存成全局设置。
在「默认 (Claude)」提供商下,Default (Opus 5.5) 这类名称表示跟随 Claude 当前的默认档,括号内是当前实际型号。直接选择 Opus 5.5 等型号则是显式选择对应模型档位;两者即使暂时指向相同型号,也会保留为两个选项。具体名称以模型列表实际返回为准。
模型选择器旁的圆环按钮会显示当前模型的上下文窗口占用。把鼠标移到圆环上停留约半秒,即可展开占用明细面板;快速划过不会弹出,点击圆环或用键盘聚焦则立即展开。面板显示已用量 / 上下文窗口上限和已用比例,压缩上下文的按钮在面板底部。新对话尚未发送内容、在历史对话中切换模型后尚未用当前模型继续对话,或当前模型没有已知窗口大小时,圆环可能不会显示。
占用明细面板会按类别列出这些 token 花在了哪里:系统提示词、系统工具、MCP 工具、记忆文件、Skills、对话消息、剩余空间。点击带箭头的类别可以展开看得更细——
- 对话消息:工具结果、附件、助手回复、工具调用、用户消息各占多少
- Skills / MCP 工具 / 记忆文件:逐个条目的占用,按大小排序
标着「按需加载,暂不占用窗口」的类别是当前没有占用窗口的工具说明,列出来只是让你知道它们有多大,不计入已用量。
两类模型的明细来路不同:
- 默认 Claude 模型:明细由 Claude 命令行工具实测得出,可以看到记忆文件、Skills、MCP 工具的逐条占用
- 其他服务商的模型:服务商返回
usage时,面板标注「总占用由模型实报,分类明细按发送内容估算」;如果请求被中断、服务商或中转接口没有返回usage,面板会改为标注总占用和分类明细均为估算。分类占比由本次发送内容推算,因此只有系统提示词、系统工具、对话消息这几类,看不到记忆文件和 Skills 的单独占用,图片附件也不单列
关于圆环数值的几点说明:
- 数值代表当前主对话的上下文占用,不是单条消息的大小,也不是历次请求累加的计费量。第三方模型以最近一次主对话请求返回的完整输入量为准,包含缓存读取与写入;命中缓存并不代表这部分内容不占窗口
- Anthropic 与 OpenAI 格式会统一换算完整输入量,不会重复叠加缓存,也不会仅因切换格式就改变已配置的窗口上限。如果两条接口实际发送的内容或服务商返回的用量不同,显示仍可能不同;缺少有效用量时不会伪造实报值
- AI 在后台并行执行子任务时,圆环稳定显示主对话的占用,不受子任务影响
- 使用联网搜索的回合,搜索到的网页内容会临时计入当轮占用,圆环可能瞬时升高、下一轮自动回落——这是正常现象,对话内容没有丢失
- 接近上下文上限时,NewMax 会自动压缩较早上下文;压缩真正开始时才显示提示,完成后上下文统计会一次更新。如果当前任务还需要继续,压缩完成后会自动恢复后续回复
操作步骤:配置规划与执行模型
- 打开设置 → 模型 → 配置
- 在左侧列表中点击「规划 & 执行模型」
- 开启「规划 & 执行模型」开关
- 分别点击「规划模型(出方案)」和「执行模型(落地)」的模型选择器
- 在一级菜单选择提供商,鼠标移到提供商上后,在右侧模型二级菜单中点击目标模型
- 展开任一阶段的模型菜单,在菜单底部打开「思考强度」子菜单;默认使用「自动」,也可为规划和执行分别选择目标模型实际支持的档位
未配置对应阶段模型,或所选模型已停用 / 失效时,会自动沿用当前对话顶部选中的模型。规划和执行模型的思考强度相互独立,旧配置未保存档位时按「自动」处理;不支持可控思考档位的模型会显示「由模型自动控制」。普通对话不受规划与执行模型设置影响。
默认可用模型
- Opus:最强综合能力,适合复杂任务
- Sonnet:更快速的响应,能力与速度平衡
- Haiku:最快速、适合轻量级任务
- 其他已配置提供商的模型
使用 NewMax Gateway 的 DeepSeek Flash 1017
打开「设置 → 模型 → NewMax Gateway」,在推荐模型中启用 deepseek-flash,然后在对话模型菜单中选择它。该入口已固定使用 DeepSeek V4.1 Flash 1017,支持图片理解与 1M 上下文;目录说明会标注 1017。新用户首次接入时会将它作为推荐默认模型,已有用户的当前模型、启用集合和手动顺序不会被此次版本更新重置。模型 ID 保持 deepseek-flash,无需重新添加供应商或修改已有对话。
展开下方「全部模型」后,DeepSeek 厂商列表中也会显示当前的 DeepSeek Flash,开关状态与推荐区一致;从任一处启用或停用都会同步更新。完整目录和搜索均包含推荐模型,不会因为已经推荐就隐藏。收起的厂商行最多显示两个已启用模型名称,更多型号用 +数量 表示。
此更新只针对 NewMax Gateway;DeepSeek 官方 API、百炼或其他中转渠道的版本由各自服务商决定。
使用 Gemini 4 Argon(Gemini API)
- 打开「设置 → 模型」,添加或选中 Gemini API,填写有 Argon 使用权限的 Google AI Studio API Key。
- 在模型优先级列表中找到
gemini-4-argon;已有配置如未显示,可通过「添加模型」填入这个 ID,或从服务商拉取模型列表后加入。必要时将它拖到前五项,完成测试/激活后再到对话模型菜单选择。升级不会替你更换当前默认模型。 - 思考强度建议先用「自动」或「中」;需要降低等待和消耗时可选「低」。Argon 支持图片输入,输出为文字,不是生图模型。
Argon 需要付费 API 权限,不使用 Gemini 免费额度或 Google AI Pro 套餐额度。Antigravity 订阅是另一条通道,应以该账号实际返回的模型和权限为准。
困难任务可能只有思考而暂时没有正文,NewMax 会按上游要求继续生成。达到调用方设置的输出上限时仍会停止,不会自动增加预算;续接失败会明确报错,不把半截答案标为完成。输入、思考和输出共享约 1M 上下文,思考 Token 也计费;多段生成的累计计费用量可能大于当前上下文占用。
使用 Gemini 4 Argon(Antigravity 订阅)
- 打开「设置 → 模型 → Antigravity 订阅」,登录具备 Argon 权限的 Google 账号,不需要另外填写 Gemini API Key。
- 加载本次更新并重新启动后,NewMax 会自动同步该账号的模型目录;有权限时可返回
gemini-4-argon-low、gemini-4-argon-medium、gemini-4-argon-high,以实际目录为准。 - 在对话的订阅模型菜单中选择对应档位。档位已包含在模型名里,不再另设思考强度开关;原有当前模型不会被本次接入直接替换。
个人订阅现已支持 Google AI Pro(非试用的付费订阅)和 Google AI Ultra;Google AI Pro 试用订阅、Google AI Plus 和免费账号不包含 Argon 权限。NewMax 以该账号实际返回的模型目录和权限为准,目录返回的禁用项不会加入可选列表;若账号没有返回 Argon,请先核对是否登录了正确账号及订阅状态,不要把 Gemini 网页 / App 或 API 直连可用当作 Antigravity 订阅通道可用。
订阅通道同样支持长推理续接,保持同一账号和项目;遇到已生成后的续接失败会明确报错,不从头重发或临时换账号。思考与输出都会消耗该订阅的额度,不能拿 Gemini API 美元单价推算订阅实际扣费。
思考档位
模型选择器会在模型名称旁显示当前思考档位;展开模型菜单后,可从底部的「思考强度」子菜单切换。菜单会按当前模型动态显示已确认有效的档位,不再对所有模型固定展示同一组选择。普通对话用「自动」即可;模型不支持关闭时不会显示「关闭」,只有两档的模型也不会显示无效的中间档位。若上游明确支持 minimal,菜单会在「低」之前显示「极低」;它会保留最低限度推理,速度和消耗通常低于「低」,但不同于完全关闭。若接入测试只能确认模型会思考、但无法确认关闭或分级强度,未知模型只显示「自动」,避免发送未经上游确认的参数;对于已经按厂商协议确认档位的模型,这类低信息量结果不会覆盖已知档位。自定义提供商填写的 OpenAI 兼容中转站(如自建 New API),会按模型名沿用与 NewMax Gateway 相同的档位规则:DeepSeek、GLM、Kimi、Qwen、MiniMax、Step 等已确认的模型族直接显示对应档位,模型名无法识别时仍只显示「自动」或不显示档位,可在「编辑模型」中手动声明思考协议和档位。用户在「编辑模型」中手动设置的协议和档位始终优先。Antigravity 是例外:官方模型 ID 本身已经包含 low、medium 或 high 档位,选择模型后不会再显示独立的思考强度开关。
当前已按厂商协议适配的常见模型包括:
- Claude:按具体型号使用原生强度或思考预算,并展示对应档位。Anthropic API 预设提供 Sonnet 5.5、Haiku 5.5;两者可选自动、关闭、低、中、高、超高和极限。Sonnet 5.5 的「关闭」表示关闭回答前的思考,工具之间仍会有简短思考更新;旧 Haiku 4.5 保持原有思考预算方式。更新不会强制替换当前主模型,第三方提供商是否提供新型号以该渠道模型列表为准
- OpenAI GPT-5 / Codex:按具体型号展示关闭、极低、低、中、高、超高或极限
- OpenAI GPT-6 Astra:自动 / 低 / 中 / 高 / 超高 / 极限,不能关闭思考
- OpenAI GPT-6 Sol / Luna:自动 / 关闭 / 低 / 中 / 高 / 超高 / 极限
- Gemini 4 Argon(Gemini API):自动 / 低 / 中 / 高,不能关闭思考;「自动」沿用模型默认中档。高档更适合困难推理,但可能增加等待和用量
- Gemini 3:使用模型原生思考级别;Gemini 2.5 使用动态或 token 预算
- Antigravity 订阅:可用模型由官方
agy目录自动同步,有权限的账号可返回 Gemini 4 Argon 三档,同时可包含 Gemini 3.8 Flash、Gemini 3.6 Flash、较早的 Gemini、Claude 与 GPT-OSS。Gemini 与 GPT-OSS 的low、medium、high档位直接体现在模型 ID 中,选择对应模型即固定使用该档位,不再提供额外的思考强度切换 - GLM 5.3:使用自动 / 低 / 高 / 极限;模型始终保留思考,旧配置若仍传入关闭会按官方规则转为低
- DeepSeek V4 / V4.1 Flash、GLM 5.2:按上游有效语义展示高 / 极限及可用的开关
- Grok 4.5:低 / 中 / 高,不显示关闭
- Step 3.5 Flash:低 / 高
- Kimi:Coding Plan 中的 K3、K3-256K 与
kimi-for-coding(K2.8 Preview)提供自动及 low / high / max 三档;HighSpeed 仍只显示自动。Moonshot 渠道的 K2.6 可关闭思考,K2.7 Code 只显示自动 - MiniMax:Token Plan 中的 M3.1 Flash Preview 提供自动及 low / medium / high / xhigh / max 五档,不能关闭思考;M3 使用自动 / 关闭;M2.x 只显示自动
- OpenCode Go:GLM 5.3 / 5.3 Flash、Kimi K3 使用自动 / 低 / 高 / 极限;GLM 5.2、DeepSeek V4 / V4.1 Flash 使用自动 / 关闭 / 高 / 极限;GLM 5.1 与 Kimi K2.6 使用自动 / 关闭;Kimi K2.7 Code、MiMo 只显示自动。Anthropic 通道中的 MiniMax / Qwen 按各自开关能力显示
- Cerebras GPT-OSS 120B:自动 / 低 / 中 / 高
- OpenRouter:切到 OpenAI 格式后,优先使用模型目录返回的推理参数能力;目录只声明
reasoning_effort时保守显示自动 / 低 / 中 / 高,不推断关闭、超高或极限;带厂商前缀的 GPT / Grok 等模型会沿用对应模型档位 - 自定义供应商:使用百炼、OpenRouter、DeepSeek、Moonshot、Cerebras、MiniMax 或智谱官方 Base URL 时,会按端点自动识别协议族,并为其中已知模型显示对应思考档位;未知中转地址仍以模型目录或单模型测试结果为准。若测试响应明确返回
minimal,会显示并转发「极低」档位 - SiliconFlow:OpenAI 格式下,官方支持的 Qwen 3、DeepSeek V3.x、GLM 视觉等模型可使用开关与思考预算
- 火山方舟:OpenAI 格式下,Doubao Seed 2.0 / 2.1 使用「自动 / 关闭」开关,不会发送未经上游确认的强度档位;Agent Plan 会直接按内置模型能力显示思考强度,其中 GLM 5.3、Kimi K3 支持「自动 / 低 / 高 / 极限」,DeepSeek V4.1 Flash / V4 Pro / V4 Flash 支持「自动 / 关闭 / 高 / 极限」,Kimi K2.7 Code 固定为自动思考,MiniMax M3 支持「自动 / 关闭」
- NewMax Gateway:GLM 5.3 支持「自动 / 低 / 高 / 极限」;DeepSeek V4 与 GLM 5.2 支持「自动 / 关闭 / 高 / 极限」;Doubao Seed 2.0 和 2.1 支持「自动 / 关闭」
对于允许独立选择思考强度的模型,切换模型后如果原来保存的档位不受新模型支持,当前模型会安全回退到「自动」,不会改写原来的选择。Antigravity 则始终以所选官方模型 ID 中的档位为准。
Fast 模式(ChatGPT 订阅):登录 ChatGPT 订阅后,展开输入框的模型菜单并悬停「ChatGPT 订阅」,二级模型列表顶部有一行 Fast 设置:左侧是闪电图标和「Fast 模式」,右侧是开关,下方用分隔线与模型列表隔开;鼠标悬停在这一行上会提示「更快,消耗更多额度」。打开开关后文字会变成品牌色的「Fast 模式已启用」,再点一次关闭。开启后响应更快,但会消耗更多订阅额度;它是全局开关,不会同步到其他设备,切换后从下一条消息开始生效,对话中已发出的回复不受影响。只有官方模型目录标明支持 Fast 的账号才会显示该行,API Key 渠道和其他服务商不显示。已登录的账号如果看不到这一行,先到 设置 → 模型 刷新一次 ChatGPT 订阅的模型列表。
回答因输出上限或内容过滤而停止
ChatGPT 订阅及其他 Responses 格式渠道明确返回不完整响应时,NewMax 会保留已收到的内容,并说明是达到输出上限、内容过滤还是其他终止原因;不会自动重试、续写或切换模型。这与普通网络断流不同,也不表示模型配置或登录失效。
- 达到输出上限:先检查已有结果,再缩小任务范围,或明确要求从中断处继续。
- 内容过滤:检查请求内容与已有结果后再决定下一步,不反复自动重试。
- 已经执行过操作:若涉及写文件、发送消息等,先确认是否完成,避免重复执行。
- 上游报告的有效消耗仍会计入用量;回答不完整不代表此次请求免费。
AI 提供商
NewMax 支持多个 AI 服务提供商,用户可以根据需要添加和切换。
默认 Claude 账号池与故障接续
账号卡片最上方显示当前选中账号,点击其他账号切换后,该账号会显示在顶部;不再额外显示对勾、「首选」或「当前账号」标签。下方「账号额度」始终展示该账号的订阅额度,冷却或额度耗尽时也不会消失;无读数时会提示加载或查询失败,不把其它账号的额度显示在这里。手动切换后额度同步切换;自动换号成功完成请求后,设置里的选中账号和额度也会更新,新会话使用该账号,原账号恢复后不主动切回。普通请求限流显示「请求暂时受限 · 约 2 分钟后可重试」这样的简短提示,较长等待按小时或天显示,不足一分钟显示「即将可重试」,到期显示「可重试」。额度已经用尽时不显示这类本地倒计时,只展示服务商确认的预计重置时间;未知或已过该时间则显示「额度已用尽 · 等待恢复」,真实请求成功后才恢复可用状态。未获得限流等待时间时会明确提示。
打开「设置 → 模型 → 默认 Claude」,「账号」区域默认只显示选中账号,点击账号名称或右侧箭头展开,与 Antigravity 等订阅使用同一种展开式管理卡片。点击列表底部「添加账号」,NewMax 会以「Claude 账号 1」等不重复名称创建隔离账号,并直接打开登录终端,无需先填写名称。新增隔离账号用于 claude.ai 订阅登录,不把无 API Key 的 Console 登录作为独立备用账号。在终端完成登录并返回 NewMax 后,只验证该账号一次;验证成功才切换到新账号并收起列表。终端打开不等于登录完成,失败时保留原选择和待登录条目,可从该行「登录」或「更多 → 验证」重试,不必重复添加。
- 展开列表后,点击已验证且启用的备用账号即可切换并收起,无需再到菜单指定首选;待登录、未验证和停用的账号不能直接切换。冷却中的已验证账号也能点击或按 Enter/空格手动切换,顶部账号与下方额度同步更新,允许下一次请求重试但不保证额度恢复,不额外启动验证。每行最多一个主操作:未验证显示「验证」,待登录显示「登录」;再次验证、重新登录、启停和移出仍在该行的「更多」菜单中。
- 修改账号备注:点击账号行右侧「更多 → 修改备注名」,输入 1–80 个字符后点击「保存」或按 Enter;取消或按 Escape 不会保存。本机登录与新增账号都可修改备注,仅影响显示名称,不改变登录资料、验证状态、额度、账号选择或会话归属。
- 账号邮箱:账号验证成功后,列表会记住该账号登录的邮箱。账号没有自定义备注名时,标题直接显示邮箱;有备注名时标题仍是备注名,邮箱单独一行,状态描述(如「已验证」)另起下一行。本机登录将名称和邮箱合并为标题「本机登录 · 邮箱」,下方只显示状态;自定义本机备注也与邮箱放在同一标题行,没有邮箱时只显示名称。邮箱只用来区分账号,不代表仍可用:登录失效时下一行会显示「待登录」,是否可用仍以状态描述为准。标题或邮箱过长时,末尾会渐隐而不是显示省略号,鼠标悬停邮箱可看完整内容。邮箱只保存在本机。
- 旧账号尚无验证记录时显示「待验证」,不代表已失效;成功后显示「已验证」。明确缺少或被拒绝的凭据显示「待登录」;网络问题会提示「暂无法验证」,不要求无条件重登。
- 确认 Claude 的 5 小时或周额度已耗尽后,账号行复用下方额度卡的官方读数,显示「额度已用尽 · 1 小时 47 分后重置」这样的剩余时间;多个窗口都耗尽时,以最晚的重置时间为准,未耗尽的周窗口不会干扰会话窗口。点击额度卡刷新也会同步更新账号行,不为此额外查询。每个账号只使用自己的读数,尚无读数时可切换到该账号查看其额度;未知或已过重置时间显示「额度已用尽 · 等待恢复」。不需要重新登录或手动验证。退避到期后仍保留额度已用尽提示;下一条消息或主动继续会自动尝试,真实请求成功才恢复「已验证」,仍限额则继续等待。未知重置时间时短暂退避后也可自动重试,不保证官方额度已恢复。到期后的启用账号可作为备用候选或手动选中;停用或登录失效的账号不会自动恢复。不会仅因时间到期就自动发送消息或重放中断任务,额度已用尽的账号不再显示行内「验证」按钮,想提前确认可在「更多 → 验证」手动验证。普通限流只提示验证请求暂时受限,不等于身份验证成功。
- 「账号不可用时自动切换」位于账号列表下方的设置卡片中,左侧是标题和说明,右侧是开关,默认关闭。账号总数不足两个时开关置灰并显示关闭,不清除已保存的偏好;添加至两个账号后恢复可操作和保存值。至少准备两个已验证且启用的账号才有可用备用;未满足时仍会显示提示。
- 开启后,明确认证失效或额度受限时会尝试备用账号,在同一对话中沿用已确认进度继续。切换到新账号时,设置中的选中账号和额度卡立即跟随,不必等待回答完成;连续切换会逐次同步。切换前取消不会改选,已经切换后即使请求失败或取消,也不会自动退回旧账号。若你在请求期间手动选择其他账号、停用或移出目标、关闭自动切换,后续结果不会覆盖该操作。健康的既有会话保持原账号,不被强制打断或每条消息换号。每个账号只尝试一次,全部不可用时停止并保留内容。
- Claude 提示
You've hit your session limit表示会话额度已用尽,不是请求太频繁;周额度和用量上限同样按额度耗尽处理。已开启自动切换且有可用备用账号时,会在可安全接续的情况下切换;仍有结果未确认的工具或未完成后台任务时不会强行接续。 - 中断后点击对话里的「继续」,若需要换到备用 Claude 账号,会带上该轮已确认操作的记录,先拦下原样重复的操作并向模型返回上次结果;不会仅因工具数量多而拒绝换号。若当前状态已变化、确实需要重跑(如修改代码后再运行同一测试),模型可在收到提醒后重新发起。留在原账号时沿用原会话;这不是绝对防重保障,发送消息、发布等重要操作仍应核对实际结果。
- 「请求暂时受限」在退避期间暂时不作为候选;等待结束只允许再次尝试,不代表官方额度已经恢复。工具结果不明、后台任务未结束或进度超出安全范围时不盲目重放;普通网络故障、组织策略和封禁不通过换号绕过。详情可把鼠标悬停在「故障切换」里「账号不可用时自动切换」旁的信息图标上查看。
- 「更多 → 移出账号池」不删除本地登录资料,也不退出其他 Claude Code 客户端;本机账号不能移出。不同备注不保证是不同云端账号,请自行确认。
- 新增账号与「本机登录」隔离,登录凭据由 Claude Code 持久保存在本机;macOS 使用按账号目录隔离的钥匙串条目,不依赖浏览器一直停留在该账号。无需反复退出旧账号来切换。如果已登录的账号意外显示「待登录」,先在该行「更多 → 验证」检查,不要直接移出或重复添加;旧版本可能把正常验证响应误判为认证失败,更新后重新验证即可按真实结果恢复状态。服务商明确撤销或拒绝授权时仍需重新登录,持久保存不代表凭据永久有效。设置页在实际可选账号验证成功后显示其额度并标明名称;回答用量浮层按该回答实际使用的账号查询,可能与设置页不同。
默认 Claude 检测并复用本地 API Key
在「设置 → 模型 → 默认 Claude → 账号」中,点击「本机登录」行的「验证」(已验证时从「更多」进入)。这个入口同时检查 ~/.claude/settings.json 的 ANTHROPIC_API_KEY / ANTHROPIC_AUTH_TOKEN 和与其他 Claude Code 客户端共享的 OAuth 登录态,不再需要另点一次本地配置检测。当前可选账号通过真实鉴权后会更新模型入口,不重复发起同一次验证。API Key 仅在 ANTHROPIC_BASE_URL 为空或指向 Anthropic 官方域名时使用。
- 默认使用第三方模型启动时,已验证、启用且可用的 Claude 账号仍会恢复到模型菜单,不需要为了显示入口重复登录,也不会自动切换当前对话模型。若启动时仍保留之前真实请求的认证失败记录,会自动重新验证一次:成功后恢复 Claude 菜单,失败或暂时无法确认时保留原状态,不阻塞第三方模型,也不会反复重试。旧验证记录本身不会解除认证失败;仍未恢复时可在账号「更多 → 验证」中重新确认,服务商拒绝授权时再重新登录
- NewMax 或系统环境中已经显式设置的同名凭证优先,本地文件不会覆盖它
- 点击账号行「登录」或「更多 → 重新登录」,完成终端登录并切回 NewMax 后会验证一次;提前切回未完成登录时可从「更多 → 验证」手动重试。验证确认已登录后会自动刷新该账号的额度,不需要先发送一条对话。账号仍显示已验证但额度提示登录过期时,也可从「更多 → 验证」检查并由 Claude Code 处理凭据续期;服务商撤销授权时仍需重新登录。额度刷新继续遵守最短查询间隔及服务商限流冷却,验证不保证解除限流
- 「设置 → 连接 → 网络」中已启用的应用内代理同时用于本地配置检测、验证和模型查询;系统代理自动检测得到的配置同样生效,无需另配
HTTP_PROXY/HTTPS_PROXY - 自动验证由窗口回焦触发,不会后台高频轮询,也不会切换当前对话模型;停用账号的验证不等于重新启用它
- 已识别凭据后,限流、断网、超时等非鉴权故障不会清除登录资料;明确拒绝凭据或没有凭据时才标记待登录
- 某次真实对话因凭据被拒而暂时停用默认 Claude 后,后续启动检查仍会重新验证;CLI 已恢复凭据时自动更新,无需重复手动验证
- 只读取上述凭证字段,不加载模型映射、Hooks、权限、个人指令或其他用户级配置
- 指向中转站或其他第三方地址的配置不会关联到默认 Claude;这类服务仍需在「设置 → 模型」中配置对应提供商
- 旧版 NewMax 写入的本地代理地址和配套占位凭证会被识别为配置残留,可在默认 Claude 卡片中一键清理;清理前会自动生成可还原备份
- 文件不存在、JSON 格式错误或没有有效凭证时会静默跳过,原有 Claude OAuth 登录方式不受影响
新手引导:使用 NewMax Gateway(国内版)
国内版新用户完成登录和基础安装后,会优先看到 NewMax Gateway。它已经配置好可用模型,不需要自行准备 API Key。
首次登录时,NewMax Gateway 只默认启用 5 个性价比较高的推荐模型:DeepSeek Flash(日常主力)、GLM 5.3(旗舰,复杂推理)、MiMo V2.5 Pro(均衡)、GLM 5.3 Flash 和 Qwen 3.8 Flash(极省),其余模型需要时再打开。
在「设置 → 模型 → NewMax Gateway」中,面板从上到下依次是:
- 推荐模型:常驻展示,每个模型标明「极省 / 均衡 / 旗舰」档位、一句话用途和输入 / 输出价格(N币 / 百万 tokens),通过右侧开关启用或停用。
- 全部模型(数量):默认收起,数量包含推荐模型;展开后按厂商分类显示完整模型列表,推荐模型也保留在所属厂商下,两处开关状态同步。分类默认收起,已启用的模型会显示在分类标题右侧;顶部搜索框可按模型名、模型 ID 或厂商名查找全部模型。只有一个厂商分类时会直接显示完整列表。
- 已启用的模型:未手动拖拽时,先按推荐顺序排列推荐模型,再按非推荐模型的厂商和目录顺序排列其余项;同一模型只加入一次,不会因两个入口重复计数。开启、关闭模型或刷新目录后都会保持这一规则。手动拖拽后保留自定义顺序。第一个是默认模型,最后一个负责起标题等轻量任务;如希望固定某个模型处理轻量任务,可手动将它拖到末尾。网关模型只能通过上方开关添加,不需要手动输入模型名。点击右侧「恢复推荐」会只保留推荐的几个模型,并恢复自动排序;当前正在用的模型被移出时会自动切到推荐列表的第一个可用模型。
- 连接配置:地址与密钥由登录自动管理,折叠放在面板最底部,一般无需修改。正常使用无需测试连接;只有排查问题时才展开并点击「测试连接」,该操作会发送真实模型请求,可能产生费用。检查结果不会停用现有配置,也不会额外扫描模型能力。
开启、关闭模型和调整排序都会直接保存,不会触发模型测试。移除后重新添加 Gateway 时,登录鉴权成功即可直接启用,无需再「测试并激活」;已有托管凭据的停用配置也可直接点击「启用」。点击设置中的「完成」或关闭设置时,Gateway 的有效配置直接保存,不自动发起测试请求。第三方 API 的连接验证流程保持不变。
图像生成页的生图模型数量较少,因此不按厂商分类,会直接显示全部模型。
选择 NewMax Gateway 的 DeepSeek V4 或 GLM 5.2 时,可在输入框右侧的模型菜单底部调整思考强度;Doubao Seed 2.0/2.1 可切换自动思考或关闭思考。
- 在新手引导中点击「前往充值」
- NewMax 会连接 Gateway,并在新手引导内显示当前余额和充值金额
- 选择充值金额,使用微信扫码完成支付
- 充值到账后点击「开始使用 NewMax」,即可直接开始对话;余额按实际用量扣费
国际版与国内版一样提供钱包、充值及托管 NewMax Gateway(USD 计费),登录后自动连接钱包;国内专属渠道不显示。也可在「Settings → Models」配置国际版目录中的 API、订阅或本地模型。若已有对话仍指定不支持的渠道,请重新选择可用模型。自定义兼容服务和 Magpie 仍可使用,「连接 → 网关」里的本地开放 API 功能也不受影响。
升级前保存的自定义或历史排序会保留,避免覆盖曾经手动拖拽的结果。如果希望回到跟随上方开关列表的自动排序,请点击「恢复推荐」,再开启需要的其他模型;注意该操作会同时重置已启用的模型集合。目录搜索或折叠厂商分组不会改变模型顺序。
NewMax Gateway 的模型目录由服务端维护。登录连接、打开钱包刷新或重新进入模型设置并展开目录时,会获取最新目录;新增模型需要通过目录开关启用。已下架模型会从启用列表中移除;对于有明确替代型号且替代型号已可用的模型,会迁移已有选择。目录获取失败时保留原有列表。
如果提示「无权访问所选模型」,请重新进入「设置 → 模型 → NewMax Gateway」展开目录,并切换到可用模型;若仍失败,请联系支持核查模型权限。这类错误不需要反复退出账号或手动更换密钥。
NewMax Gateway 的密钥由登录态托管。模型请求如果因本地密钥过期返回认证失败,NewMax 会自动从钱包控制面获取当前密钥,并在请求尚未执行时原地重试一次;无需前往模型设置手动修改密钥。只有自动刷新后仍认证失败时,才需要退出并重新登录 NewMax 账号。
如果此前从模型列表移除了 NewMax Gateway,再从「添加模型 → 推荐服务」重新添加,NewMax 会先刷新登录态托管的密钥,再打开配置面板。连接测试会把模型返回的有效思考流视为连通成功;对于首个有效事件较慢的 Gateway 模型,最长等待 60 秒,不需要手动填写或替换 API Key。
如果 DeepSeek V4 等模型的上游渠道在长对话或工具调用续轮中返回请求解析失败,NewMax 会先尝试保留当前工具结构重试,或在请求历史过长时安全裁剪旧工具结果后重试。自动恢复后仍失败时,错误提示会明确说明这是上游渠道解析问题,而不是钱包余额或托管密钥问题;此时可新开对话,或切换其他模型/供应商。
如果对话提示「NewMax Gateway 上游渠道返回计费异常」,说明请求已经通过网关鉴权,但所选模型的上游渠道暂时不可用;这不代表当前显示的 NewMax 钱包余额不足,也不需要更新网关 API Key。可稍后重试,或在设置 → 模型中切换到其他模型/供应商;如果多个 NewMax Gateway 模型持续出现同一提示,需要等待网关服务端恢复渠道。
查看钱包、充值记录、消耗统计与邀请奖励(国内版)
- 打开设置 → 钱包
- 在顶部选择「账户余额」,可查看当前余额、网关密钥并充值;余额卡片右上角的「兑换码」可输入 NewMax 发放的 N币兑换码(格式
NM-N-XXXX-XXXX,大小写和连字符可省略),兑换成功后 N币立即到账并计入「活动赠送」,同一个码每个账号只能兑换一次;提示「已过期」「已被用完」「已作废」时说明码本身不可用,「已兑换过」说明该账号此前已领取 - 在顶部切换到「充值记录」,可查看已支付到账的订单、充值时间、订单号、实付金额和到账 N币;页面顶部同时汇总充值笔数、累计实付和累计到账
- 在顶部切换到「消耗明细」,可使用「24h」「近 7 天」「近 30 天」「全部」快速切换时间范围,也可直接选择开始日期和结束日期自定义筛选;页面会显示该时间范围内的记录数、累计消耗,以及各模型的请求数、输入/输出 Token 和 N币消耗。每条明细的 Token 栏会同时显示总量、输入量和输出量;联网搜索、连接器等按次收费的记录在 Token 栏显示「按次计费」,联网搜索记录的名称显示为「联网搜索」,下方小字保留原始接口路径。明细列表分页展示,点击「下一页」时会按需自动加载更早数据,并可按文本、图像、视频、语音或连接器筛选当前已加载记录
- 点击「全部」可清除日期范围并恢复完整账单;结束日期不能早于开始日期
- 在顶部切换到「邀请好友」,可复制邀请码、邀请链接或完整邀请文案,并查看邀请人数、累计奖励、邀请规则与按日返现记录
- 已带关联 ID 的计费记录会在模型名下显示
Request ID;生图超时或账单需要核对时,可把这个 ID 提供给支持定位
如果已经有自己的 API Key、模型订阅或本地模型,可在新手引导中点击「配置自定义模型」,从 MiniMax、智谱、Kimi Coding Plan 或 DeepSeek 中选择,再按“选择供应商 → 填写密钥或登录 → 测试激活”完成配置;需要更多供应商时再点击「在设置中配置」。也可以点击「稍后配置」先进入主界面。
内置提供商
- Anthropic(默认):Claude 系列模型
可添加的提供商
| 提供商 | 说明 | API 格式 |
|---|---|---|
| OpenAI | 默认 GPT-6 Astra,另有 GPT-6.1 Sol、GPT-6 Sol / Luna、GPT-5.6 系列;生图有 GPT Image 2、2.5 Flare / Sunburst | OpenAI |
| Gemini API | Google AI Studio API Key;可选 Gemini 4 Argon、3.8 Flash、3.7 Flash、3.1 Pro、3.6 Flash、3.5 Flash、3.5 Flash-Lite,以及 Gemini 3 Image 生图模型;默认对话模型保持 3.8 Flash | Gemini |
| OpenCode Go | GLM、Kimi、DeepSeek、MiMo、LongCat 2.0 / 2.5 Preview、HY4 Preview 等官方聊天兼容模型 | OpenAI |
| OpenCode Go (Anthropic) | Haiku 5.5、MiniMax M3 / M2.x 与 Qwen 3.8 / 3.7 / 3.6 | Anthropic |
| OpenCode Go (Responses) | GPT-6 Luna / GPT-5.6 Luna、Grok 4.7 / 4.6、Muse Spark 1.3 / 1.2 Contributor | OpenAI Responses |
| DeepSeek | 默认 DeepSeek V4.1 Flash(deepseek-flash,1M 上下文、原生识图、支持思考强度);也可选官方继续提供的 V4 Pro(deepseek-v4-pro,纯文本)。旧的 deepseek-v4-flash / deepseek-v4-flash-vision-exp 已由官方路由到 V4.1 Flash | Anthropic |
| MiniMax Token Plan / 按量 API | 两种渠道默认仍为 M3;国内、国际 Token Plan 新增 M3.1 Flash Preview(1M、原生识图、五档思考),按量 API 不提供该预览模型;密钥与额度不互通 | Anthropic |
| Kimi Coding Plan | kimi-for-coding 为 K2.8 Preview(1M),另有 K3 / K3-256K 和 HighSpeed;K3 1M 与 HighSpeed 受套餐限制 | Anthropic |
| Moonshot | Kimi K3、K2.7 Code / K2.7 Code 高速版、K2.6 | Anthropic |
| 智谱 GLM Coding Plan / 按量 API | Coding Plan 默认使用 GLM 5.3 1M,按量 API 默认使用 GLM 5.3;两者均提供原生识图的 GLM 5.3 Flash 作为快速模型,按量 API 另可选提速版 GLM 5.3 FlashX | Anthropic / OpenAI |
| 火山方舟 Coding Plan | ark-code-latest、Doubao Seed Evolving、Seed 2.1 Pro,使用 /api/coding 套餐网关;套餐里的其他模型可在编辑模型中手动添加 | Anthropic / OpenAI |
| 火山方舟 Agent Plan | 内置 Doubao Seed Evolving、Seed 2.1 Pro / Turbo、GLM 5.3、Kimi K3 / K2.7 Code、MiniMax M3、DeepSeek V4.1 Flash / V4 Pro / V4 Flash,使用 /api/plan/v3 套餐网关 | OpenAI |
| 火山方舟按量 API | Doubao Seed Evolving、Seed 2.1 Pro / Turbo,使用 /api/v3 通用网关 | OpenAI |
| 阿里百炼 Coding Plan | Coding Plan 官方模型白名单,使用 Coding Plan 专属密钥 | Anthropic / OpenAI |
| 阿里百炼 Token Plan | Token Plan 订阅套餐,使用 sk-sp- 专属密钥,默认提供 Qwen 3.8 Max / Flash、DeepSeek V4.1 Flash、V4 Pro / Pro 0813 / Flash 0731 和 GLM 5.2 等套餐模型 | Anthropic / OpenAI |
| 阿里百炼按量 API | Model Studio 通用 sk- 密钥,默认提供 Qwen 3.8 Max(含可钉住版本的 qwen3.8-max-0902 快照)、Qwen 3.7 Plus 和 Qwen 3.8 Flash,按实际调用量计费 | OpenAI |
| 阶跃星辰 | 默认 Step 5 Preview(step-5-preview,1M 上下文、原生识图,思考强度低 / 中 / 高);仍可选 Step 3.7 Flash / Step 3.5 Flash 2603 / Step 3.5 Flash | OpenAI |
| 蚂蚁百灵 | Ling 3.0 Flash、Ling 3.0 Flash VL(原生识图)、Ling 2.6 / Ring 2.6 | Anthropic |
| LongCat | LongCat 2.0 | Anthropic |
| 小米 MiMo | 推荐 V2.6 Pro / V2.6 Flash;V2.5 Pro / V2.5 暂时保留,将于北京时间 2026 年 10 月 21 日 10:00 下线 | Anthropic |
| OpenRouter | 多模型路由平台;默认提供 Claude Fable 5.1、Opus 5.5、Sonnet 5、Haiku 4.5 | OpenAI |
| Ollama | 本地运行的开源模型 | OpenAI |
| LM Studio | 本地模型管理平台 | OpenAI |
| SiliconFlow (硅基流动) | 国际站默认 MiniMax M3,另有 GLM 5.3 / 5.3 Flash、Kimi K3、DeepSeek V4.1 Flash;国内站提供 MiniMax M2.7、GLM 5.2 / 5.1 | OpenAI |
| Groq | GPT-OSS 120B / 20B、Qwen 3.8 27B 高速推理 | OpenAI |
| Cerebras | GPT-OSS 120B 高速推理 | OpenAI |
| ZenMux | 多模型聚合平台,默认自动路由,另提供 Claude Fable 5.1、Opus 5.5、Sonnet 5 | Anthropic |
| Pipellm Claude | Claude 中转聚合,默认 Claude Opus 5.5,另有 Sonnet 5、Haiku 4.5 | Anthropic |
| GPTNB | OpenAI 系聚合渠道 | OpenAI |
| 自定义提供商 | 任意 OpenAI 或 Anthropic 兼容的 API | 可选 |
设置 → 模型 → 添加提供商时,顶部有「推荐服务」标签页,列出官方推荐渠道,方便没准备 API Key 的用户快速试用。
操作步骤:添加 AI 提供商
- 点击左侧导航栏底部的头像图标 → 打开「设置」
- 点击左侧「模型」标签
- 页面显示已有的提供商列表
- 点击「添加提供商」按钮
- 从列表中选择提供商类型(如 Kimi、OpenRouter、Ollama 等)
- 填写必要信息:
- 如果已经进入「自定义供应商」但不知道 API 地址,先使用顶部的「从服务商预设创建(推荐)」搜索并选择对应的“品牌 · 接入方案”;例如火山方舟会分别显示 Coding Plan、Agent Plan 和按量 API。NewMax 会自动带入与该套餐配套的 API 地址、接口格式和推荐模型,通常只需填写对应套餐生成的 API Key
- API Key:在提供商官网获取的密钥(Ollama/LM Studio 不需要);同一提供商可点击「添加 API 密钥」继续添加多把 Key。粘贴时 NewMax 会自动去掉空格、换行、不可见字符以及中文标点、全角符号、省略号等密钥中不可能出现的字符;如果「从服务商拉取模型列表」或「测试连接」提示「API 密钥包含非法字符」,说明复制的内容混入了此类字符,请回到服务商后台重新完整复制密钥
- Base URL:自定义提供商可填写服务根地址、
/v1地址,也可直接粘贴以/chat/completions、/responses或/messages结尾的完整请求地址;离开输入框后,NewMax 会自动去掉具体请求端点并整理为 Base URL。省略协议时,公网域名默认补https://,localhost / 127.0.0.1 默认补http:// - API 格式:NewMax 会根据完整请求端点、兼容路径或已知官方域名自动选择 OpenAI / Anthropic 格式;仍可在下方手动切换。模型名不会用于判断接口格式,因为 OpenAI 兼容中转站也可能提供 Claude 模型
- 如添加了多把 API Key,可开启「密钥不可用时自动切换」:NewMax 会优先使用当前可用 Key,首次从第一把 Key 开始,当前 Key 不可用时自动尝试下一把;如果主 Key 因限流、超时、网络或服务端临时故障切到备用 Key,后续真实请求会按 1、5、15、30 分钟的递增冷却间隔顺带探测主 Key,恢复后自动切回,不会在后台额外发起计费请求。主 Key 返回 401/403 时不会定时探测,修改密钥配置或重启应用后才会重新从第一把开始
- 可以点击「测试连接」验证首把 API Key 和当前模型是否有效。连接测试最长等待 60 秒,收到有效文本、思考或工具调用即可提前完成,只有角色声明或空内容的首包不会提前判定成功;超时后会取消本次请求,可以检查网络后重新测试。服务商返回错误正文、异常流或未产生有效响应时会判为测试失败,不会继续能力检测;能力检测遇到错误、空响应或网页等非模型响应时保留为未确认。如果测试失败但你确认地址、密钥和模型都没问题,可以点击下方的「仍然保存(未验证)」按配置保存并启用
- 点击保存
- 新提供商的模型会出现在对话中的模型选择器下拉菜单中;如果当前 Claude 默认档未登录或登录已失效,新添加的第一个可用模型会自动设为默认
多 API Key 自动切换只在同一个提供商内切换密钥,不会改变模型或切到其他提供商;跨提供商切换请使用「智能路由 / 故障转移」。
同一品牌的不同接入方案不能只靠切换 API 格式互换。Coding Plan、Agent Plan、Token Plan 和按量 API 可能使用不同 Base URL、不同类型的 API Key 和不同额度;请按密钥来源选择完全一致的预设。旧版已添加的
火山方舟、智谱、MiniMax和百炼 Coding Plan配置会保留原 provider ID,并分别对应其原有套餐预设。
「测试连接」会用第一个模型发送最小文本请求,用于确认密钥、地址和模型可用,供应商仍可能按普通文本调用计费。配置成功后,NewMax 会继续为本次配置中的全部模型同步思考能力:先使用内置预置中已经查证的固定能力,再读取不生成内容的模型目录元数据,只有两者都无法判断的模型才发送非法思考参数做生成前校验。严格校验参数的上游不会产生输出 token;如果兼容层忽略非法参数,轻量探针最多生成 1 个 token(Responses 兼容接口可能要求更高的最小输出上限)。这属于首次配置的初始化流程,不会自动检测图片、文档或视频;完整能力检测需由用户在「编辑模型」窗口内点击按钮触发。
Gemini API 的连接测试不携带真实对话中的完整工具定义,因此连接成功不等于所有工具参数都兼容。若聊天报错包含
function_declarations、parameters和Proto field is not repeating, cannot start list或items: missing field,应先更新到包含工具参数兼容修复的 NewMax 版本;这类错误本身不表示 Key 无效或模型不存在。更新后仍失败,请保留完整错误和应用版本用于排查。
连接测试比真实对话多做了几件事(探测思考档位、校验模型可用性),少数中转站会因此拒绝请求,但正常对话可用。测试失败时,按钮下方会出现「仍然保存(未验证)」:点击后按当前配置保存并启用,该提供商在设置页左侧会显示「未验证」角标。未验证的提供商不会保存失败请求的能力探测结果,但会保留手动能力设置;未手动设置的能力仍按已有结果或内置模型信息判断,无法确认时保持未知;之后任意一次连接测试通过,角标会自动消失。
修改已启用的自定义提供商时,如果只改提供商名称,点击「完成」或关闭设置会直接保存,不会重新测试连接;如果修改了 Base URL、API Key、接口格式等连接配置,点击「完成」或首次关闭设置会先验证一次,成功后保存并退出。主动点击「测试连接」只会保存当前 Provider 并停留在设置页,方便继续配置其他项目。如果自动验证失败,设置页会保留错误供修改;此时再次点击右上角关闭、设置外区域或按 Esc,可放弃未通过验证的改动并退出。错误后继续编辑配置,则下次关闭会重新验证。
操作步骤:使用 Magpie 网关模型
- 先启动 Magpie,并在其中配置好供应商、订阅账号或路由组
- 打开设置 → 模型 → 添加模型 →「聚合与兼容平台」→「Magpie」;国际版位于「Cloud APIs(云端 API)」分类
- 默认地址为
http://127.0.0.1:3425,本机调用标识预填magpie-newmax;如果 Magpie 改了端口,请修改 API 地址。连接另一台机器时,填写其网关地址和有效的 Magpie 网关密钥,不使用本机占位标识 - 点击「从服务商拉取模型列表」,勾选需要的模型或路由组后更新列表。模型 ID 保留完整的
供应商/模型或group/名称,不要仅填写显示名称或去掉前缀 - 点击「测试连接并激活」。列模型不会生成内容;连接测试可能产生正常模型调用费用
订阅登录、插件和路由由 Magpie 管理,使用期间需保持网关运行。模型目录明确声明的上下文窗口、思考档位与图片支持会同步到 NewMax;没有声明的能力保持未知,不代表已经通过真实通道验证。
操作步骤:从 Magpie 导入供应商
- 打开设置 → 模型 → 添加模型 →「从 Magpie 导入」
- NewMax 只读扫描本机
~/.config/magpie/providers.json(设置了绝对路径XDG_CONFIG_HOME时使用对应目录)。未找到或使用 Portable / 自定义目录时,点击「选择配置文件」选择providers.json - 在脱敏预览中勾选 API 供应商,然后点击「导入 N 个供应商」;同一供应商的不同协议会分别显示
- 导入后可在模型设置里调整模型、拉取目录并测试连接。没有模型的配置保持停用,需添加或拉取模型后再测试启用
导入不修改 Magpie 文件,不读取订阅登录凭据,不测试连接,不改变当前默认模型;不会覆盖现有的同品牌或同地址供应商。重复导入相同 Magpie 供应商与协议会更新此前导入的配置,不重复添加。默认本机扫描可从端点匹配的本机模型缓存补齐模型和能力;手选文件不借用本机缓存。每个配置最多导入 20 个模型,超过时会提示。
订阅/插件账号及账号级模型权限配置不能作为普通 API Key 安全迁移,请用上一节的 Magpie 网关接入。停用的供应商保持停用,停用或不兼容当前协议的密钥不会加入配置。路由、权重、限额、自定义请求头/请求体和中间件不迁移,多个密钥以主备方式保存。加密 .magpie-backup 暂不支持,请选择 providers.json 或明文配置。
操作步骤:从 CC Switch 导入供应商
- 打开设置 → 模型 → 添加模型
- 在供应商目录中点击「从 CC Switch 导入」
- NewMax 会只读扫描默认的 CC Switch 数据库;如果 CC Switch 使用了自定义数据目录,点击「选择数据库文件」并选择
cc-switch.db - 在预览中勾选要导入的 Claude 供应商。API 密钥只显示脱敏结果
- 点击「导入 N 个供应商」
NewMax 会把可识别的 Base URL、API Key、接口格式和模型列表加入现有配置。匹配到 NewMax 内置供应商时更新对应配置,其他配置作为独立供应商追加;导入不会修改 CC Switch 数据库,不会发起连接测试,也不会切换当前默认模型。
以下配置会在预览中标为不可导入:由 CC Switch 管理登录态的 OAuth 账号、依赖 CC Switch 本机代理的配置、完整请求 URL 模式,以及缺少 API Key、Base URL 或模型的配置。CC Switch 的备用端点、自定义请求头和请求体覆盖暂不迁移。
操作步骤:管理提供商模型列表
- 打开设置 → 模型标签
- 点击已添加的提供商,展开详情
- 查看该提供商下的模型列表
- 可添加自定义模型名称、删除不需要的模型;服务商提供标准模型目录时,也可点击「从服务商拉取模型列表」,在弹窗中勾选要保留或添加的模型后点击「更新列表」
- NewMax 会检测本次配置中的全部模型。它优先使用服务商模型列表返回的上下文窗口和推理参数元数据(例如 OpenRouter),这一步不生成内容。对目录仍无法判断的兼容模型,再逐个检查上游是否识别思考参数:OpenAI 格式检查强度档位,Anthropic 格式检查
thinking类型;上游明确返回有效值时保存对应档位,明确拒绝时保存为不支持,避免以后重复探测。只有兼容层忽略非法参数时才可能产生最小输出,并尝试从返回流识别思考内容 - 服务商未返回上下文窗口时,会按已知官方模型窗口自动补全;如果仍不准确,点击模型行任意空白区域或右侧的编辑图标即可打开模型编辑窗口,键盘聚焦模型行后也可按 Enter 或空格进入。拖拽手柄和删除按钮保持独立操作,不会误开编辑窗口。删除按钮带有 Tooltip;首次点击只会在原位置切换为红色对勾,需在 3 秒内再次点击才会删除模型;超过 3 秒或按钮失焦都会自动恢复为删除图标。窗口标题直接显示当前模型名称;标题悬浮时会显示底色,点击后可原位修改模型名称,按 Enter 或移出输入框确认本次输入,按 Esc 撤销本次输入。名称仍处于输入状态时,首次点击弹窗外只会确认名称并保留窗口,防止误触关闭;再次点击弹窗外才会关闭。空名称或与列表内已有模型重名时保留原名称。可在左侧输入框手动填写自定义上下文窗口,也可点击右侧的 128K、200K、256K、500K 或 1M 快捷按钮写入对应数值;该值会同步用于上下文统计、自动压缩判定和底层 Agent 的最大上下文判断。纯数字默认按
k处理,也支持显式输入k、M(最大 10M);手动输入后离开输入框,会自动格式化为统一的k/M显示。窗口不再提供底部取消和保存按钮;结束名称输入后,点击右上角关闭、按 Esc 或点击遮罩都会保存有效改动。无效的窗口输入会被忽略并保留原值 - 「编辑模型」窗口顶部提供统一的「检测模型能力」按钮。点击后会同时刷新模型目录中的上下文窗口元数据,并按当前接口格式发送图片、文档、视频和思考探测请求;按钮 Tooltip 会提示真实能力请求的费用以供应商计费规则为准。检测不再经过二次确认弹窗,也不会关闭当前编辑窗口。检测结果会保存;上游目录没有返回窗口大小时会保留现有已知值。模型行与编辑窗口会优先显示手动设置和已有检测结果;图片能力尚未检测时,会使用内置模型信息补齐,例如
deepseek-flash无需先检测即可显示支持图片。这种默认显示不会发送检测请求,也不代表当前服务商通道已经通过验证。模型行只显示支持的能力胶囊,不支持或未知项仍可在编辑窗口中查看和手动覆盖 - 启动 NewMax 或单独刷新模型列表不会自动执行完整能力检测;添加、编辑或重新激活服务商并完成连接测试后,会自动同步全部已配置模型的思考能力。图片、文档和视频仍只在用户主动点击「检测模型能力」后执行完整检测。未确认的思考能力保持保守状态,不会显示未经上游确认的档位
- 如果中转站静默忽略能力探针或返回不准确,「编辑模型」可在「能力支持」中点击图片、文档、视频和思考胶囊手动切换,点亮表示支持。手动设置无需先运行能力检测:关闭模型编辑窗口即可保留选择;新建自定义供应商的选择会随「测试连接并激活」或「仍然保存(未验证)」一起保存,未激活的内置供应商也可直接保留手动设置。手动设置的图片能力优先于内置模型判断,OpenAI 与 Anthropic 接口都会按该设置处理;能否实际识图仍取决于所选模型和服务商接口是否支持图片输入。只有勾选「思考」后才会显示下方的深度思考设置,可选择自适应档位、Token 预算或仅开关;各选项的 Tooltip 会说明含义。再根据实际能力选择自动、关闭、低、中、高等档位。所有能力和档位选项使用相同的小尺寸控件。本次编辑发生改动后,窗口顶部才会显示「恢复检测结果」;上下文输入框仅聚焦不会触发,修改内容并离开输入框后才会出现。点击恢复可统一清除上下文窗口、多模态、深度思考协议和档位的全部手动覆盖,随后按钮立即隐藏
- 每个提供商最多 20 个模型槽位,支持手动输入未在预设里的模型 ID
- OpenAI 兼容格式的提供商可勾选「使用 Responses API」开关(适合 GPT-5 / GPT-6 / Codex 等需要 Responses 端点进行工具调用的场景)
GPT-5.2-Codex、GPT-5.3-Codex(不含 Spark)、Kimi-K2.7-Code、Qwen3.7-Max-2026-06-08、LongCat-Flash-Omni / Next 和 Qianfan-VL 的已支持型号可直接使用原生图片输入,不需要仅因模型带有 Code、Codex 或 Max 名称而配置备用识图模型。自定义服务商仍需提供支持图片输入的接口;如果该接口明确不支持图片,可关闭该模型的图片能力并配置备用识图模型。
NewMax 升级后会自动同步所有内置提供商的新版模型预设。未手动调整过的列表会直接采用新版顺序;调整过的列表会保留自定义模型、删除选择和现有排序,并在剩余槽位中加入新模型。列表已经占满 20 个槽位时,会优先保留现有选择,可在提供商详情中手动删除旧模型后添加新模型。自定义提供商不受内置预设更新影响。
火山方舟 Agent Plan 套餐网关不提供标准模型列表接口,因此不会显示「从服务商拉取模型列表」。NewMax 会直接展示该套餐的内置模型;服务商后续刚发布、尚未进入预设的模型仍可通过「添加模型」填写模型 ID。
Anthropic 兼容提供商会按模型列表顺序映射 Claude Code 的档位:只配置 1 个模型时,Opus / Sonnet / Haiku / small-fast 都使用该模型;配置 2 个模型时,第 1 个承接 Opus 与 Sonnet,第 2 个承接 Haiku 与 small-fast;配置 3 个及以上时,第 1 个承接 Opus,第 2 个承接 Sonnet,最后 1 个承接 Haiku 与 small-fast。
操作步骤:配置图片识别 Fallback
- 打开设置 → 模型 → 图片识别 Fallback
- 开启图片识别 Fallback,并选择备用模型;NewMax 会先按规范化模型名称判断固有视觉能力,自动排除
deepseek-v4-pro、kimi-k2.7-code等已知纯文本模型,不会为它们发送付费探针;deepseek-flash(DeepSeek V4.1 Flash)等原生视觉模型则会识别为支持识图。已知支持识图和能力未知的候选会分别显示“支持识图”或“能力未知”,并单独显示当前供应商的通道验证状态 - 点击「扫描视觉能力」并在费用提示中确认。扫描会发送一张带有大号四位校验码的测试图片,要求模型只返回该校验码,并完整走聊天时实际使用的备用模型转述链路;扫描过程中显示本轮候选通道总数和完成进度。只有成功识别测试图片的通道才会标为“通道已验证”并真正启用。失败会细分为“鉴权失败 / 通道限流 / 通道验证超时 / 通道网络异常 / 通道不支持图片 / 识图结果不确定 / 验证未完成”,不会覆盖模型名称给出的固有能力;登录恢复或网络正常后可重新扫描。修改 API Key、Base URL 或接口格式后,旧的视觉通道结果会自动失效,需按新配置重新验证
- 使用不支持识图的主模型对话时,可以让 AI 查找并分析工作区内的 PNG、JPEG、GIF 或 WebP 图片
辅助识图是主模型的兜底能力:主模型按已保存的通道结果或模型名称先验确认支持识图时不会调用辅助模型;主模型已明确不支持识图且备用模型已经通过真实链路验证时,NewMax 才会先把消息附件转述成文字;能力尚未确认时,普通图片附件会优先尝试主模型的原生图片输入,不会仅因“未检测”就自动转述。浏览器截图是例外:浏览器工具结果中的图片如果被文本上游拒绝,主模型没有机会再调用辅助工具,因此只要主模型尚未确认支持识图且备用链路可用,NewMax 就会在浏览器工具边界自动转写截图,只把 DOM 快照和视觉描述交给主模型。备用模型链路全部失败时,原图不会再次发送给不支持或尚未确认支持图片的主模型,需验证或更换备用模型后重试。工作区辅助识图只能读取当前工作区内、最大 10MB 的图片;浏览器截图由工具在内存中直接转写,两者都不用于生成或修改图片。
操作步骤:配置图像生成模型
图像生成、视频生成、语音生成及云端语音识别尚未添加模型时,内容区会显示「尚未添加…模型」标题,下方单独提供添加指引;点击左侧对应的「添加…模型」入口开始配置。
- 打开设置 → 模型 → 图像生成
- 选择要用于生图的提供商
- 如果列表里没有目标服务,点击「添加生图模型」打开独立的生图预设目录;每张卡片会标明接口类型、内置模型数量和凭证方式。可选择 OpenAI、Gemini API、百炼按量 API、Grok 订阅、GPTNB 等生图渠道,也可选择普通模型配置中已有且支持生图接口的自定义提供商,或选择「自定义生图」。已经加入左侧列表的服务不会从添加目录消失,而会显示「已激活」,点击后可直接返回现有配置
- 已在模型配置中登录 Grok 订阅时,可选择 Grok 订阅 / Grok Imagine,默认优先使用
grok-imagine-image-2.0,并保留grok-imagine-image-quality、grok-imagine-image兼容模型,无需填写 API Key 或 Base URL;与文本生成共用 Grok 订阅账号。账号卡片默认收起显示当前账号,点击名称或展开箭头可添加、切换、移除账号或退出登录,这些操作也会同步影响文本生成所用的 Grok 账号;未登录时可直接点击「使用 SuperGrok 订阅登录」,等待授权期间可取消。点击「从服务商拉取模型列表」时,NewMax 会使用当前 Grok 登录令牌读取 xAI 的生图模型目录,可勾选官方新增模型并更新列表;授权失效时按提示重新登录 - 其他提供商填写或调整生图 API Key、Base URL(可选)和模型 ID;选择预设时这些地址、接口和起步模型会自动带入。OpenAI 官方默认保持
gpt-image-2,另可选gpt-image-2.5-flare、gpt-image-2.5-sunburst;Google AI Studio 默认提供gemini-3.1-flash-image、gemini-3.1-flash-lite-image和gemini-3-pro-image;百炼按量 API 默认使用 DashScope 生图端点,并提供qwen-image-3.0-pro、wan2.7-image-pro、z-image-turbo;GPTNB 中转可用gpt-image-2-vip、gpt-image-2。选择 DashScope 接口时还可设置「调用方式」:默认先同步调用并在服务明确提示仅支持异步时自动切换;也可手动固定为「同步返回」或「异步任务」。NewMax Gateway 的gpt-image-2固定使用由 Gateway 托管的可恢复异步任务,不显示调用方式选择 - 首次添加预设服务或已有提供商时,可点击「测试连接并激活」;如果直接点击「完成」或首次关闭设置,NewMax 也会自动测试并在成功后激活。自动测试失败时会保留错误;再次点击右上角关闭、设置外区域或按 Esc,可放弃未通过验证的改动并退出。测试会连接服务商、校验模型列表,并阻止把
gpt-5.5等明确的对话模型配置到生图接口;测试过程不会实际生成图片或产生测试生图费用 - 选择「自定义生图」后,可在顶部「选择模型服务商」中搜索并选择常见平台。国内版目录包括 OpenAI、xAI API、Google Gemini、阿里云百炼、智谱 BigModel、火山方舟、OpenRouter、Together AI、SiliconFlow / 硅基流动、DMXAPI、GPTNB;国际版隐藏仅面向国内的服务。NewMax 会自动填写与服务商匹配的接口类型、Base URL 和推荐模型,只需粘贴对应的 API Key。选中后目录会自动收起,卡片标题显示当前服务商;需要改选时点击「更换服务商」。可在「供应商名称」中填写便于区分的名称;留空时使用当前模板名称,未选模板则使用「自定义生图」。选择模板或重新选择都不会覆盖已输入的名称和 Key,Base URL、Key 和模型列表仍可继续修改,接口协议由已选模板确定,不再额外要求选择。已有自定义供应商也可在配置卡中改名,移开焦点或按 Enter 后保存;空白名称会恢复原名称,单独改名无需重新测试连接。若该供应商同时用于文本生成,名称会同步更新。Grok 订阅等账号登录渠道不出现在这里,应从上一层生图预设目录直接选择
- 内置供应商和已选服务商模板不再显示「生图接口」选择,NewMax 会自动使用对应的 OpenAI 兼容、Google、DashScope、OpenRouter Image API 或 SiliconFlow Image API;从文本模型配置复用的已知供应商,以及名称为 Mimo 等历史自定义配置,也不再显示接口选择或多余的「高级设置」,即使尚未填写 Key 或地址也一样;修改前保存的协议、密钥和模型列表保持不变。已有自定义配置的地址与协议匹配已知服务商时也不再显示。只有无法识别供应商的完全自定义中转或自建服务仍可展开「高级设置」手动选择接口,收起或展开不会更改原配置。百炼的「调用方式」单独保留,可按需要设置自动、同步或异步。OpenRouter 会调用专用
/images和/images/models接口;SiliconFlow 会按其image_size请求参数和images响应结构调用,不会误走 OpenAI 响应解析 - 如果使用 OpenAI 兼容生图接口,Base URL 可填到服务根地址或
/v1;只填服务根地址时,NewMax 会自动补/v1后调用/images/generations - 如果使用 DashScope / 百炼生图,生图 Base URL 可留空或使用
https://dashscope.aliyuncs.com;不要把聊天兼容网关的/compatible-mode/v1地址填为 DashScope 生图 Base URL - 如果使用 GPTNB 中转站,选择 GPTNB 提供商,或在 OpenAI 兼容生图接口中填写 Base URL
https://one-cn2.gptnb.ai/v1,模型可填gpt-image-2-vip(分层)或gpt-image-2 - 如果使用 APIMart 或其镜像 apib.ai,在 OpenAI 兼容生图接口中填写 Base URL
https://api.apimart.ai/v1或https://api.apib.ai/v1,模型填gpt-image-2。这类网关是异步任务接口,NewMax 会自动提交任务并轮询结果(最长等待 10 分钟),参考图也会按其协议随请求一起发送,不需要额外设置;等待超时时错误提示里会给出任务 ID - 对已加入列表的生图提供商,点击「测试连接」可再次确认 API Key、Base URL、接口类型和默认生图模型出现在服务商模型列表中,并排除已知的对话模型;由于测试不会实际生成图片,最终生图能力仍以真实调用结果为准
- 对已加入左侧列表的生图提供商,点击行尾「更多」可停用或移除;停用会保留配置并移入「已停用」列表,可在列表中恢复或移除
- 需要在中转站故障时自动使用备用配置,可打开左侧列表底部独立设置区的「失败时自动切换」(默认关闭),该行结构与「添加生图模型」一致,为图标、文字和最右侧开关;点击设置行或开关即可切换,悬停或键盘聚焦该行可查看完整规则。上游返回 502/503/504、限流、鉴权失败或额度不足等可切换错误时,先尝试当前供应商后面的模型,再按左侧拖拽顺序尝试后面的已激活供应商;禁用或缺少密钥的配置会跳过。切换只作用于本次调用,不会改动默认模型,生成结果下方显示实际使用的模型
自动切换不会覆盖当前消息中明确点名的模型:只会尝试后续供应商配置的同名模型,不改用其它模型。参考图、提示词与尺寸会继续传给备用配置;参数错误、不支持参考图或内容安全拒绝会直接报告错误。任务已接受、图片已生成但下载或保存失败、网络断开后无法确认是否已经执行时,不会再次生图;NewMax Gateway 的异步超时仍先查询原任务,不能确认结果时保留 Request ID 供稍后恢复。第三方中转返回 502/504 不保证其上游一定未执行或计费,开启自动切换前请了解各服务商的计费规则。
生图预设与文本模型套餐分开维护。同一品牌的 Coding Plan、Agent Plan、Token Plan 密钥不一定能调用按量生图 API;例如百炼生图预设只提供「百炼按量 API」,不会把百炼 Coding Plan 显示成可直接生图的渠道。请按预设卡片标注的凭证方式准备对应 Key。
视频生成、语音生成和云端语音识别也使用相同的预设目录交互:点击对应页的「添加…模型」,先按供应商卡片核对接口类型、内置模型数量和凭证方式,再进入配置。NewMax 网关显示「登录托管」,Grok Imagine 显示「账号登录」,Kokoro 显示「本地离线」,其余官方渠道显示「API Key」;没有目标服务时再选择最后一张「自定义渠道」卡片。自定义渠道不会默认套用即梦、OpenAI 等任一服务商,需先按中转或自建服务的文档选择兼容的接口格式;选中后会把官方默认地址写入输入值,并自动带入该格式的推荐模型和推荐音色(如适用),用户通常只需填写 Key。使用中转或自建服务时再覆盖地址,也可继续增删模型或音色。
视频生成中,已知供应商不再显示「接口格式」选择,也不保留多余的「高级设置」。自定义渠道若名称或官方地址可识别,也按同样方式简化;刚选定服务商并自动填入默认地址后,无需再选一次接口。只有名称与地址均无法识别的自定义中转或自建视频服务,才在默认收起的「高级设置」中提供接口选择;展开不会改动原来的协议、Key、地址或模型列表。语音生成和云端识别的接口编辑方式保持不变。
查看 NewMax 网关视频价格
- 打开「设置 → 模型 → 视频生成」,选择左侧 NewMax 网关视频;尚未添加时,点击「添加视频模型」并选择 NewMax 网关。
- 右侧与图片生成一致,常驻平铺视频模型,名称下显示价格区间,单位按模型分别为 N币/秒或 N币/百万视频 Token。悬停报价,或用键盘聚焦报价,可查看分辨率、是否有声、是否有参考视频等已公布规格对应的单价;「其他分辨率」表示其余报价档,不代表某个固定尺寸。
- 使用每行右侧开关启用或停用模型,可同时启用多个;首个启用模型作为默认,关闭它后使用剩余首个模型,全部关闭后不提供托管视频生成工具。已有配置保留原默认模型,不会因为刷新目录自动启用新模型。已配置渠道立即保存,新添加渠道需点击「保存并加入列表」才会启用;不会改变左侧渠道顺序。
- 这些是单价,不是整段视频总价。提交时预扣,完成后按实际视频 Token 或时长多退少补;生成失败退还费用。Token 计费模型不能仅凭视频秒数推算最终费用。
- 报价缺失时显示「报价暂不可用」,不表示免费;目录加载失败或为空时可点击「重试」。查看价格不会提交生成任务或扣除生成费用。
下载本地语音模型(Kokoro)
- 打开「设置 → 模型 → 语音生成 → 添加语音模型」,选择标有「本地离线」的 Kokoro。
- 选择模型:Kokoro v1.1-zh · INT8 约 147 MB,提供 103 个音色;Kokoro v1.0 · INT8 约 132 MB,提供 36 个中英文音色。下载体积不等于运行内存,建议至少留有 4 GB 可用内存。
- 点击「下载模型」,等待下载、校验和解压完成。首次下载需要联网;可以取消,失败后可重试(重新下载,不续传)。关闭设置不会取消已开始的下载,重新进入可查看进度。
- 模型就绪后选择音色,点击「试听」,再点击「保存并加入列表」。不需要 API Key、服务地址或 Python;本地合成不扣 N币。已有云端渠道不会被删除,要默认使用本地模型,可将 Kokoro 拖到列表首位。
- 在对话里要求“把这段文字生成语音”,将使用默认语音渠道。Kokoro 在本机 CPU 合成并输出 WAV;每次最多 5000 字符,长文请分段。文字不会由本地 TTS 发往云端,但对话模型本身仍按所选服务处理聊天内容。
- 设置页的「删除本地模型文件」会释放该模型占用空间;「移除此供应商」只移除配置,不删除模型。删除模型后须重新下载才能生成;不会自动改用云端。
支持 Windows x64、macOS x64/arm64、Linux x64/arm64;Windows arm64 暂不支持。当前是生成完成后播放,不是实时流式朗读;不支持声音克隆或上传参考声音。模型权重采用 Apache-2.0,语音处理资源遵循各自许可,可从卡片中的「模型说明与许可」查看上游说明。
图像生成补充说明
「自动识别」不会只根据模型名猜测调用方式:DashScope 根据服务实际响应判断,先尝试同步并在服务明确要求时切换为异步;其他声明仅异步能力的模型会直接提交任务。异步调用会根据服务返回的 task_id 自动查询进度并下载生成结果,整个过程不需要手动查询任务。NewMax Gateway 会先持久化 gpt-image-2 的请求并返回任务 ID,再在网关内部执行实际生图。每次请求都有唯一 Request ID,结果临时保存 24 小时;客户端遇到 408、5xx、连接中断或网络层超时时,会先按这个 ID 恢复已有任务。轮询等待达到上限时也会显示原请求 ID 和任务 ID,提示稍后查询而不是重新提交,从而避免同一请求重复计费。
如果任务已经超时退出、应用曾经关闭,或稍后想取回暂存结果,可以在对话中粘贴完整 Request ID 并说“恢复这次生图”。NewMax 会调用 recover_image 查询并保存原任务结果;该工具只发送 GET 查询,不会新建生图任务或再次扣费。任务仍在排队或处理中会返回原任务状态,可稍后使用同一个 Request ID 再查。
NewMax Gateway 的生图模型目录固定展开,不提供收起入口;目录不按厂商分类:固定价模型显示 N币/次;按量模型根据服务端报价分别显示 N币/张、N币/秒或 N币/百万视频 Token 的规格价区间,并标明「按实际用量结算」。参考图附加费用可悬停报价查看。目录根据网关声明在价格后以「·」分隔显示「文生图」「图生图」能力文字,可直接通过各模型右侧开关启用或停用。Seedream 5.0 Pro 和 Seedream 5.0 lite 均支持文生图与图生图;旧网关目录未声明操作能力时,客户端也会补齐这两项文字。目录不会重复显示「图像生成」分类标签,其他未声明的能力也不会根据模型名猜测。升级后登录时,NewMax 会为尚未初始化生图能力的旧 Gateway 配置自动补齐当前可用生图模型;用户主动停用的模型不会被重新打开。
配置并启用图像生成模型后,对话里的普通“生成图片 / 画图 / 图生图 / 海报 / 封面 / 头像”等请求会优先使用 NewMax 内置生图工具和当前配置的生图供应商。配置了多个可用模型时,可直接在描述中点名模型 ID 或唯一简称,例如“用 gpt image 2 生成头像”或“使用 wan2.7 画一张产品海报”;NewMax 会忽略大小写以及空格、横线、点等分隔符,先匹配完整模型名,再尝试唯一的部分名称,并在已启用的生图供应商中选择对应模型。简称同时命中多个模型时会列出候选并要求提供更完整名称,不会自动猜测;未点名时仍使用列表首位的默认供应商与默认模型。如果点名的模型没有配置或当前不可用,会提示当前可用模型,不会静默改用其它模型。同一对话一旦加载并使用过生图等任务工具,后续消息会继续保留这些工具;可以直接说“换成 fantasy 风格”“尺寸改为 16:9”等省略要求,不需要重复写“生成图片”或重新选择工具。新建或重置对话、关闭相应能力或授权失效时,工具会按当前可用配置重新加载。用户安装的第三方生图、宠物、精灵图或视频复刻流水线类 Skill 不会作为自动兜底;只有在你明确点名或在输入框手选某个 Skill 时,NewMax 才会让它主导本轮。输入框手选是一次性的,随消息发送后清空;如果下一条消息明确说“继续”“下一步”或“按上一步继续”,NewMax 会延续上一条消息手选的 Skill 工作流。Skill 主导时内置 mcp__image-generation__generate_image 仍保持可用,可由 Skill 作为子步骤调用;任一路径失败时都会报告原始错误,不会在 Skill 与内置生图之间静默切换。未配置可用默认生图模型时,NewMax 不会强制调用内置生图工具,可使用可用的生图 Skill;如果没有合适 Skill,则需要先在这里配置供应商、API Key 和生图模型。
需要特定比例或尺寸时,直接写在描述里,例如“竖版 9:16”或“1080×1920”。对于 gpt-image-2 及 2.5 系列,NewMax 按比例换算自定义尺寸后提交请求,例如 9:16 请求 1024×1824;给出具体像素时,会按模型约束调整并将宽高对齐到 16 的倍数,例如 1080×1920 请求 1088×1920。其他只支持固定档位的模型会选最接近的方形、横版或竖版档位。请求尺寸不保证等于最终输出,网关或上游渠道可能返回不同像素。生成完成后,能读取尺寸时会注明图片的实际像素;与指定像素不同或比例偏差超过容差时会明确提示,不会把请求尺寸当作实际输出。
图生图时,在同一条消息中附加 PNG、JPEG、GIF 或 WebP 图片并说明希望生成的结果即可。NewMax 会结合整条消息的生图意图判断,而不是只匹配某个固定触发词;确认是内置图生图后,会把本轮图片附件的原始文件直接绑定到 reference_images,由支持编辑能力的供应商走图片编辑接口。参考图不会先交给图片识别 Fallback 转述成文字;“描述 / 分析这张图片”等非生图请求仍按普通识图流程处理。若当前生图模型不支持参考图,NewMax 会报告不支持编辑操作,不会静默退化为根据文字描述重新文生图。
NewMax 内置生图工具生成的图片会在图片下方显示“生图模型 · 模型 ID”,该信息来自工具的实际调用结果,不是回复顶部显示的对话模型。多张图片组成画廊时,切换缩略图会同步显示当前图片对应的生图模型。
如果没有指定输出路径,内置生图工具会用包含本次 Request ID 的唯一文件名保存结果。批量或并发生成多张图片时,各次调用不会再共同写入 generated-image.png 而互相覆盖。
生图提交、任务查询和结果图片下载都会遵循应用的代理及绕过列表;图片下载域名与接口域名不同时,会各自判断网络路径。遇到网络失败时,可根据提示中的目标主机、应用代理地址和错误码,到「设置 → 连接 → 网络」核对代理是否运行以及绕过列表是否符合预期。提示“未使用应用代理”不代表系统代理或加速器一定关闭。连接测试只检查接口可访问性和模型信息,不代表令牌分组已开通实际生图权限;若返回 Image generation is not enabled for this group,需要向服务商确认令牌分组的生图权限,反复切换网络不能解决权限问题。
点名只在当前这条用户消息中生效,不会自动沿用上一轮使用过的模型。本轮没有点名时,即使对话模型自行填入了历史 model 参数,内置生图工具也会忽略该参数并回到设置中的默认供应商与默认模型。
如果在对话中明确要求“分层图 / 图层 / 前景背景特效拆分”,NewMax 会把分层需求放进同一次生图调用,避免多次独立文生图导致各层不一致。配置的 OpenAI 兼容生图模型如果支持分层多图返回(例如模型名包含 vip 的分层模型),会一次返回合成图和多个独立图层,并在回复中连续展示以触发多图画廊;普通生图模型通常只能返回单张扁平图。
Kimi Coding Plan
kimi-for-coding 已原地升级为 K2.8 Preview,支持 1M 上下文,无需更换模型 ID。新套餐需 Plus 及以上,旧套餐 Andante 及以上可用;Go 档没有 Coding 额度。
Plus / Moderato 及以上可用 k3 与 k3-256k。NewMax 的普通 k3 入口保守使用 256K,k3-256k 则固定为 256K;Pro / Allegretto 及以上可选 k3[1m] 使用 1M,或选择 kimi-for-coding-highspeed(仍是 K2.7 Code、256K)。不要在没有对应套餐权限时选择 1M 或高速版。
K3 和 K2.8 Preview 均支持 low / high / max 三档,可在模型菜单底部的「思考强度」中选择;「自动」使用服务端默认值,K3 为 high、K2.8 Preview 为 max。HighSpeed 仍只提供「自动」。关闭思考会让服务端改用 K2.8 Preview 无思考版,为避免选择的型号被暗中替换,NewMax 不显示关闭选项。
升级会修正旧预设的上下文窗口;在「编辑模型」中手动设置的窗口仍优先。切换模型或思考档位会影响缓存,建议在新对话中切换;长对话从 1M 切回 256K 前先压缩,包含视频的历史也不应直接切到只支持图片的 K3-256K。
MiniMax M3.1 Flash Preview
在「设置 → 模型」的国内或国际 MiniMax Token Plan 中选择 MiniMax-M3.1-Flash-Preview。它支持 1M 上下文、原生图片输入和五档思考;手动添加官方正式型号 MiniMax-M3.1-Flash(含 [1m] 后缀)时同样按这些能力识别;「自动」使用服务端默认 max,不能关闭思考。M3 仍为默认模型,按量 API 和未经确认的聚合渠道不会自动加入该预览模型。
MiniMax 旧模型公告
在「设置 → 模型」中打开对应 MiniMax 渠道,可看到当前迁移提醒:
- 国内 / 国际 Token Plan:自 2026 年 10 月 19 日起,M2.5 / M2.7 请求由厂商转发到 M3.1 Flash Preview,旧名称继续可用,套餐权益不变。
- 按量 API:M2.5 / M2.7 自 2026 年 10 月 19 日起不再向新用户开放,存量用户可用至 2026 年 11 月 18 日下线。请提前切换 M3,此通道不适用套餐自动转发。
NewMax 保留现有模型选择,不把厂商套餐公告套用到按量 API 或其它聚合渠道。
MiMo V2.5 下线提醒
mimo-v2.5-pro 和 mimo-v2.5 自北京时间 2026 年 10 月 14 日 18:00起,分别由厂商转发至 V2.6 Pro 和 V2.6 Flash,并按新版计价;2026 年 10 月 21 日 10:00 起旧名称失效。请在截止前到模型选择器切换为 V2.6,并用新对话验证。「设置 → 模型 → 小米 MiMo」会显示提醒;NewMax 不提前强制修改原有选择,也不据此替换其它渠道的 MiMo 型号。
Grok 生图兼容名称
2026 年 11 月 2 日起,xAI 将 grok-imagine-image-quality 转发到 grok-imagine-image-2.0 的 low 质量,旧名称继续可用;grok-imagine-image(1.0)不受影响。可在「设置 → 图像生成」主动选择 Image 2.0,NewMax 不提前删除兼容选项,也不会把 Image 1.0 当成退役模型。
OpenCode Go 订阅
如果你已经订阅 OpenCode Go,可以用 OpenCode Go 提供的 API Key 接入 NewMax,无需在 NewMax 里走 OAuth 登录。
操作步骤:添加 OpenCode Go
- 打开设置 → 模型标签 → 添加提供商
- 选择 OpenCode Go
- 前往 OpenCode Go / Zen 页面复制 API Key
- 将 API Key 粘贴到 NewMax 的 API Key 输入框
- 点击「测试连接」确认可用,然后保存
- 回到对话界面,在模型选择器里选择 OpenCode Go 下的模型
选择哪个 OpenCode Go 通道
- OpenCode Go:用于 GLM、Kimi、DeepSeek、MiMo、LongCat、HY 等 Chat Completions 模型
- OpenCode Go (Anthropic):用于 Haiku 5.5、MiniMax、Qwen 等 Anthropic Messages 模型
- OpenCode Go (Responses):用于 GPT-6 Luna / GPT-5.6 Luna、Grok 4.7 / 4.6、Muse Spark 1.3 / 1.2 Contributor
三个通道使用同一个 OpenCode Go API Key,仍须分别添加。NewMax 按通道固定正确协议;可用性取决于套餐和账号权限。升级会将旧标准入口更新至官方
/inference/go,不会覆盖自定义代理地址或密钥。Sonnet 5.5、GPT-6.1 Sol 不在当前 Go 预设内,不能把其它平台的目录当作 Go 账号权限。
OpenCode Go 的思考强度会按具体模型能力显示:GLM 5.3 / 5.3 Flash、Kimi K3 支持自动 / 低 / 高 / 极限;GLM 5.2、DeepSeek V4 / V4.1 Flash 支持自动 / 关闭 / 高 / 极限;GLM 5.1、Kimi K2.6 支持自动 / 关闭;Kimi K2.7 Code 与 MiMo 思考强度固定,只显示自动。Anthropic 通道中的 MiniMax M3 可自动或关闭,MiniMax M2.x 只显示自动,Qwen 显示自动或关闭。
OpenCode Go 的 deepseek-v4-flash 当前聊天端点只接受文本内容;deepseek-v4.1-flash 能否直接传图尚未确认,NewMax 暂按纯文本处理。对话中附加图片时,如果已经启用并验证图片识别 Fallback,NewMax 会在发送前用备用识图模型转述图片,再把文字描述交给 deepseek-v4-flash;未配置可用 Fallback 时会明确提示当前模型或供应商不支持该附件类型。
操作步骤:设置提供商排序和默认
- 打开设置 → 模型标签
- 提供商列表中,排在第一位的启用提供商即为默认提供商
- 拖拽提供商卡片可调整顺序
- 使用提供商旁的开关可启用/禁用
- 如果 Claude 未登录或登录已失效,添加或重新启用其他可用提供商时,NewMax 会自动把该提供商的第一个可用模型放到默认位置
操作步骤:在「默认 (Claude)」档指定首选模型
- 打开设置 → 模型标签
- 找到「默认 (Claude)」档(即 Opus / Sonnet / Haiku 这组)
- 直接拖拽提供商到首选位置,对话中选「Opus / Sonnet / Haiku」时就会用拖到首位的提供商承接(无需单独"激活"按钮)
操作步骤:查看用量与费用
- 打开设置 → 模型标签 → 顶部「用量统计」入口
- 用量按提供商分组显示,国内模型用 ¥、海外模型用 $,避免单一币种换算误差
- 通过 ChatGPT、Claude、Antigravity、Grok 等账号授权登录产生的调用显示为「订阅」,只统计请求数与 Token,不计入总费用;悬停「订阅」可查看按公开 API 价折算的参考成本
- 使用 API Key 或按量网关时才显示金额;该金额仍以模型供应商最终账单为准
- 「缓存命中率」同时显示两种口径:按 Token 为成功请求中的缓存读取 Token / 总输入 Token,按请求为成功请求中出现缓存读取的请求占比;失败请求不计入命中率。NewMax 会归一化 DeepSeek、OpenAI 和 Anthropic 兼容接口返回的缓存字段
- Claude Native 同一轮如果还有 SDK 后台或子代理模型用量,请求日志的「模型」列以主对话实际回复模型为准,不会被后台模型的排序覆盖
API 格式说明
NewMax 支持两种 API 格式:
- Anthropic Messages API:Anthropic 原生格式
- OpenAI Chat Completions API:OpenAI 兼容格式
大多数第三方提供商使用 OpenAI 格式,部分提供商(如 ZenMux)使用 Anthropic 格式。配置自定义提供商时,可把服务商文档给出的完整请求地址直接粘贴到 Base URL:以 /chat/completions 或 /responses 结尾时识别为 OpenAI 格式,以 /messages 结尾时识别为 Anthropic 格式,并自动去掉末尾的具体请求路径。未知中转地址默认保持 OpenAI 格式,不会仅因模型 ID 中包含 claude 就切换协议;如果中转服务明确要求 Anthropic Messages,请手动选择 Anthropic 格式。
视频参考图与图生视频
内置 generate_video 使用统一的 keyframes 参数接收显式关键帧,每项包含 image_url 和 position:first 表示首帧,last 表示尾帧,reference 表示普通主体或风格参考图。最多各指定一张首帧和尾帧;普通参考图数量由当前模型决定。旧的 reference_image_urls 仍保留兼容(第一张作为首帧/主参考图,第二张作为尾帧),但不能与 keyframes 同时使用。NewMax 会根据当前视频渠道自动转换为对应协议:
- NewMax 网关:Seedance 使用
content.image_url;Kling 自动切换到 image-to-video 端点;HappyHorse I2V 接收一张首帧,R2V 接收多张普通参考图 - Agnes AI:2.0 保留单图
image和旧关键帧模式;2.5 按角色使用first_frame/last_frame或普通参考图images,两类不能混用 - 即梦 / Seedance:使用
content.image_url - Kling:自动切换到 image-to-video 端点,可传首尾帧
- MiniMax:使用
first_frame_image/last_frame_image - Google Veo:NewMax 下载公网图片并以内联图片数据提交
- Grok Imagine:使用
image.url
参考图目前必须是公网可访问的 HTTP/HTTPS URL。本地附件、file:// 地址和仅本机可访问的地址不能被远端视频服务读取,因此会明确报错,不会静默退化成文生视频。当前通用层只表达首帧、尾帧和普通参考图,不接受 time_sec 等任意时间点,避免对不支持的模型伪装生效。NewMax Gateway 的线上视频目录会自动同步到托管渠道;HappyHorse T2V 只接受文本,I2V 要求一张图片,R2V 要求至少一张普通参考图,Video Edit 还要求通过 source_video_url 提供公网源视频 URL,可额外附加参考图。输入与模型模式不匹配时工具会明确报错,不会忽略媒体输入。
Agnes AI 视频生成
Agnes 视频生成使用独立的 Agnes API 协议。只填写 agnes-video-v2.0 模型名、但把接口格式选成即梦或其他厂商协议,会导致请求地址和参数不匹配。
操作步骤:配置 Agnes AI
- 打开设置 → 模型 → 视频生成,点击「添加视频模型」
- 选择 Agnes AI
- 填写 Agnes API Key,使用 2.0 时选择
agnes-video-v2.0;账号已开通 2.5 时,在模型列表中添加并选用agnes-video-2.5或agnes-video-2.5-flash。现有默认模型不会自动替换 - 国际站可使用默认接口地址
https://apihub.agnes-ai.com/v1;中国站账号可把接口地址改为服务商提供的中国区地址 - 保存后,在对话中直接描述画面、比例和时长;AI 会调用内置视频工具提交任务、轮询结果并把 mp4 保存到当前工作区
- 需要图生视频时,在同一条消息中提供一张或多张公网图片 URL,并说明希望图片中的哪些元素运动、哪些主体细节保持稳定。内置工具会按上方统一参考图规则提交
已有自定义视频渠道不必删除重建:旧版保存成“自定义 + 即梦协议”,同时使用 agnes-video-* 模型和 Agnes 官方域名的渠道会自动按 Agnes 协议兼容;仍建议打开渠道详情,把「接口格式」切换为 Agnes AI,保留原 API Key、接口地址和模型后保存。先由接口格式选择供应商协议,再由已确认的 Agnes 模型名称区分 2.0 与 2.5 参数。
agnes-video-2.5 默认生成 5 秒、720P、16:9 视频,时长可指定 4–12 秒的整数;支持 21:9、16:9、4:3、1:1、3:4、9:16。首帧和尾帧可以单独或同时提供;普通参考图最多 8 张,也可通过 source_video_url 提供一段公网参考视频。首尾关键帧不能与普通参考图或参考视频混用;多张普通参考图请明确使用 keyframes 的 reference 角色,不要用旧数组混淆首尾帧。当前工具固定使用 720P,不提供参考音频或参考视频截取参数。
agnes-video-2.5-flash 使用与 2.5 相同的新版参数(同样不发送宽高和帧数),区别是普通参考图最多 5 张、不支持参考视频;传入 source_video_url 会在提交前直接提示,请改用 agnes-video-2.5。模型名需与上面完全一致,其他未确认的 Agnes 型号仍按 2.0 参数发送。
若旧版本调用 2.5 报“width 是禁止字段”,请更新到包含此修复的版本;这属于旧版工具的参数兼容问题,不需要把中文提示词改成英文。查询任务遇到 429 时,NewMax 会降低查询频率并遵守服务商的等待时间,只查询原任务,不重新提交生成;预算耗尽会显示任务 ID 和最近一次限速原因。提交失败不会自动重发;若返回 invalid_json,请保留完整错误用于定位,它本身不能证明中文不受支持。Agnes 2.5 参数校验及提交、查询、取件的 HTTP/JSON 和超时提示会按当前语言显示;HTTP 状态码、任务 ID 和服务商原始错误片段不会被翻译或隐藏。
ChatGPT / Gemini / Antigravity / Grok 订阅 OAuth 登录
如果你已经有 ChatGPT Plus / Pro、Google AI Pro 或 SuperGrok 订阅,可以直接用账号登录,无需 API Key。
SuperGrok 的新模型候选可在设置 → 模型 → Grok 订阅中点击「从服务商拉取模型列表」查看。列表会实时刷新;新候选默认不勾选,勾选后点击「更新列表」才会追加到现有模型后面,不会自动替换默认模型。候选出现在目录中不代表已经验证可调用,实际可用性取决于账号权限及接口支持;未确认的推理档位和上下文大小不会套用旧模型参数。普通自动同步仍只启用已验证模型,保留你手动添加的候选和排序。
GPT-6 Astra、Sol 和 Luna 已在 OpenAI API Key 和 ChatGPT 订阅两个渠道提供:新添加这两个提供商时,gpt-6-astra 排在模型列表首位并作为默认主模型,Sonnet 档使用 gpt-6-sol;API Key 渠道的轻量任务使用 gpt-6-luna。ChatGPT 订阅中的 Luna 仍在分批开放,部分账号暂时无法调用,因此订阅渠道的轻量任务仍使用 gpt-5.6-luna。已保存的提供商会自动追加新模型,默认模型仍保持你原来的选择;ChatGPT 订阅已于 2026 年 8 月 31 日下线 gpt-5.4 和 gpt-5.4-mini,这两个模型会从订阅渠道的模型列表中移除,原来选它们的默认模型会切到当前推荐模型。ChatGPT 订阅上线的新模型会随模型目录自动出现并可直接调用,不需要等 NewMax 更新。实际可调用性仍取决于账号权限;如账号未开通,可切换回 gpt-5.6-terra 或 gpt-5.3-codex-spark。
操作步骤:登录订阅账号
- 打开设置 → 模型标签 → 添加提供商
- 选择 ChatGPT、Gemini、Antigravity 或 Grok 提供商
- 在面板里点「订阅登录」,跳出 OAuth 授权窗口
- 在浏览器里完成授权,凭证自动写回应用
- 登录后该提供商会出现在模型选择器中,订阅可用模型置顶展示
- Claude、ChatGPT、SuperGrok 和 Antigravity 订阅都会自动同步当前账号可用的模型目录:启动 NewMax、登录或切换账号时刷新,应用持续运行期间每 6 小时再次刷新。Claude 使用 Claude Code SDK 的账号目录,ChatGPT 使用 Codex 账号目录,SuperGrok 使用 xAI 模型目录,Antigravity 使用 agy 模型目录。xAI 的原始目录也可能返回仍可路由的历史部署;SuperGrok 自动同步只启用已验证的模型,并过滤历史兼容项。首次授权添加 ChatGPT、SuperGrok 或 Antigravity 时,模型列表严格采用账号官方目录及顺序,不混入内置旧列表;完成添加后,后续刷新会保留用户手动增删和拖拽排序,同时同步官方新增、下线及图片输入、深度思考、思考档位和上下文窗口能力。当前选中模型在同步后已不可用时会自动切到同步列表首位,已有手动能力覆盖仍会保留。同步失败时仍保留上一次成功目录或内置兜底,不会清除登录。ChatGPT 官方目录对几乎所有模型都报同一个 272k 上下文窗口,那是 Codex 命令行自己的会话预算,并非模型真实上限(例如 GPT-6 Astra 实为 1.05M),因此该目录返回的窗口只用于补充 NewMax 未收录的新模型或调大已知窗口,不会调小;如需按自己的用量收紧,仍可在「编辑模型」里手动填写上下文窗口
- Gemini 订阅默认模型已对齐官方 gemini-cli,会随订阅升级到 3.1 系列
- Grok 订阅默认使用 xAI 官方当前推荐的
grok-4.7(grok-4.6仍可在模型列表中选择),上下文窗口按 500k tokens 显示;思考强度支持自动、低、中、高和超高,且不能关闭 - 对话中的「联网搜索」开启时,Antigravity 订阅中的 Gemini 模型会直接使用 Google Search;同一订阅中的 Claude 与 GPT-OSS 模型不启用这条 Gemini 专用搜索路径,可使用已配置搜索服务或 NewMax 提供的其他联网方式
- 对话中的「联网搜索」开启时,Grok 订阅会通过独立 Web Search 工具获取网页资料,再由当前 Grok 主对话综合回答;直接说明 X 账号、帖子、时间范围或主题时,还可通过 X Search 查询公开 X 数据并获取来源
- Grok 登录还可复用于媒体生成:设置 → 模型 → 图像生成中选择 Grok Imagine 可优先使用
grok-imagine-image-2.0,并保留grok-imagine-image-quality/grok-imagine-image兼容模型;也可通过「从服务商拉取模型列表」使用当前登录令牌读取 xAI 生图目录。设置 → 模型 → 视频生成 → 添加视频模型中选择 Grok Imagine 可使用grok-imagine-video。两处都无需填写 API Key,NewMax 仅在调用或拉取目录前读取并刷新 OAuth access token,不会把 token 保存成媒体 API Key
自定义配置的品牌图标
填写已支持品牌的官方 Base URL 后,自定义配置的标题、左侧服务商列表、对话模型按钮、识图副模型及计划执行模型入口会复用已有品牌 Logo。例如 MiMo Token Plan 国内站地址会显示小米 MiMo 图标。已有预设仍保留自己的品牌;未知中转站或本地地址使用名称首字母,不会因为名字叫“OpenAI”或模型叫“Claude”就自动认成官方服务。
图标识别只改变外观,不改变 API 格式、密钥、套餐额度、计费渠道或模型能力。
查看订阅额度(速率限制窗口)
Claude Code、ChatGPT、Grok、Antigravity 这些 OAuth 登录的订阅,智谱 GLM Coding Plan(含 Z.ai)、MiniMax Token Plan(含国际站)这两家用 API 密钥的套餐,以及百炼 Token Plan 个人版,都没有余额,只有速率限制窗口(如「5 小时会话」「本周」、Claude 按模型的周限)。NewMax 在两处显示当前账号还剩多少:
- 设置 → 模型:选中 ChatGPT / Grok / Antigravity 提供商,账号面板下方有「订阅额度」卡片,显示套餐名(如 Max 20x、Pro、X Premium+)、每个窗口的已用百分比和「x 小时 y 分后重置」倒计时;右上角可手动刷新。为避免触发服务商限制,同一账号向服务商查询额度有最短间隔(Claude 5 分钟、其他订阅 1 分钟),间隔内刷新显示的是上次读数;被服务商限流时会暂停查询并提示「额度查询太频繁,稍后自动重试」。「默认 (Claude)」档登录正常时同样显示这张卡片,读取的是本机 Claude Code 命令行登录的账号。智谱 GLM Coding Plan / Z.ai / MiniMax Token Plan 保存 API 密钥后,密钥下方也会出现同样的卡片(智谱显示 Lite / Pro / Max 档位);MiniMax 必须填 Token Plan 的订阅密钥,填成按量付费密钥会提示「密钥无效或不是套餐密钥」。百炼 Token Plan 的
sk-sp-密钥查不了用量。订阅额度卡片未登录时,标题行点「登录百炼控制台」,用阿里云账号登录一次后,同一张卡片显示档位、月额度已用比例和重置时间;若服务商仍返回旧的 5 小时或周窗口,也会一并显示。月额度为 0% 时同样正常显示。已经登录只留「断开」,不会再要求重新登录;登录过期才会出现「重新登录」。这是控制台登录态,断开后用量不再更新 - Kimi Coding Plan:API 密钥查不了用量。设置 → 模型 → Kimi Coding Plan 的配置面板里有「订阅额度」卡片,点标题行的「连接 Kimi 账户(扫码)」,用 Kimi App 扫码登录一次后,同一张卡片显示「5 小时会话」和「本周」的已用百分比与重置倒计时,对话用量胶囊的悬浮卡里也显示同样的窗口。已登录只留「断开」,登录过期才出现「重新登录」。需要账户开通 Coding Plan;未开通时卡片会提示这个账户没有 Coding Plan 额度
- MiMo Token Plan 个人版(自定义配置):Base URL 为
https://token-plan-cn.xiaomimimo.com/anthropic时,配置卡片右上角提供「去获取 API 密钥」,点击会在系统浏览器打开小米官方控制台的密钥页面,不修改已有连接配置。配置面板会在「添加 API 密钥」下方、「API 格式」上方自动出现「订阅额度」,与其他套餐配置的位置一致。点击额度标题行的「连接 MiMo 账户」,在官方控制台登录后显示套餐额度的已用比例,以及服务商返回的补偿额度。这里读取的是网页登录账户,不是 API 密钥,请登录密钥所属账户;可用旧 MiMo 余额登录态,无需重复登录。已登录只显示「断开」,过期时可重新登录。服务商未提供重置时间时不显示倒计时,不把套餐有效期当成额度重置时间。目前只接个人版国内站,不覆盖团队席位和国际站 - 对话里:把鼠标悬停在回复底部的用量胶囊上,悬浮卡片顶部会显示这条消息所用订阅的额度窗口
说明:
- 百分比都是服务商自己报的数,NewMax 不用本地统计推算;进度条 75% 以上变黄、90% 以上变红,服务商判定用尽时显示「已用尽」
- 读数每 5 分钟自动刷新一次,两处共用;刷新失败时保留上次读数并标「上次读数 · x 分钟前」,只有登录失效才会清空
- 提示「Claude Code 登录已过期」时在终端运行
claude完成一次登录即可,NewMax 不会替 Claude Code 刷新登录;ChatGPT / Grok / Antigravity 提示登录过期时到设置 → 模型重新登录 - Antigravity 额度按模型组(Gemini、Claude · GPT)汇总,取组内剩余最少的那条;ChatGPT Pro 只有周窗口,没有 5 小时窗口,属正常现象
- 百炼和 MiMo 的控制台登录态会加密保存在本机;查询额度时优先使用最新浏览器会话,并保存服务商下发的更新票据。登录窗口会在服务端验证通过且保存成功后关闭;若提示「无法保存登录状态」,请检查磁盘空间和应用数据目录权限后重试,不必重新填写 API 密钥。服务商撤销登录或要求重新验证时仍需重新登录,保存登录态不代表永久有效
按量付费(API Key)的服务商没有速率限制窗口,只有账户余额。DeepSeek、Moonshot、硅基流动(国内站 / 国际站)、OpenRouter、阶跃星辰这五家在两处显示余额:设置 → 模型 → 点开该服务商,API 密钥下方的「账户余额」区块(余额 / 充值 / 赠送三张小卡,右上角可刷新;没保存密钥时不显示),以及同一个用量胶囊悬浮卡(DeepSeek / Moonshot / 硅基流动拆出充值与赠送两部分,OpenRouter 只显示剩余美元额度)。百炼 Coding Plan 和百炼按量 API、火山、智谱开放平台 API、MiniMax 按量 API、百灵、各类中转站没有可用 API 密钥查询的余额或额度接口,悬浮卡里只显示本条消息的 token 用量。百炼 Token Plan 个人版例外,登录控制台后可以看月额度用量,仍兼容服务商返回的旧窗口。
使用 Grok Imagine 生成视频
- 先按上方步骤登录 Grok 订阅
- 打开设置 → 模型 → 视频生成,点击「添加视频模型」
- 选择 Grok Imagine;与文本生成、图像生成共用 Grok 订阅账号,无需填写 API Key 或 Base URL。账号面板默认收起显示当前账号,点击名称或展开箭头可添加、切换、移除账号或确认退出,这些操作也会影响文本和图像生成所用的 Grok 账号;未登录时可直接点击「使用 SuperGrok 订阅登录」,等待授权期间可取消。选择
grok-imagine-video后保存 - 在对话中描述画面、比例和时长,例如“生成一段 16:9 的海边日落短视频”
- AI 会提交异步任务、轮询完成状态并把 mp4 保存到当前工作区。视频生成可能消耗订阅额度且耗时较长,建议先用短时长测试
操作步骤:管理多个订阅账号
- 在设置 → 模型中选择 ChatGPT、Antigravity 或 Grok 订阅,点击账号卡片的摘要区(含周围留白)或展开箭头即可展开、收起;账号管理、登录和排序等独立控件只执行各自操作,不会展开或收起卡片
- 卡片顶部就是当前账号;点击列表中的其他账号即可切换,成功后收起列表,顶部和下方订阅额度同步更新,不再显示额外的对勾或优先标签
- 面板底部有「添加账号」可继续走 OAuth 绑定新账号
- 登录多个账号后,可开启「账号不可用时自动切换」:当前账号不可用或限流时自动尝试下一个。备用账号成功完成请求后,会同步成为设置中的当前账号,后续请求从它开始;原账号恢复后不会主动切回。已打开的设置页会在下一次状态刷新时更新顶部账号和额度
- 失败或取消的尝试不会切换设置;请求期间手动选择了其他账号,旧请求的迟到结果也不会覆盖选择。正在执行的其他请求不会被强制中断
- ChatGPT 的备用资格由运行时自动判断,不需要逐个账号打开参与开关;已登录账号按顺序作为备用,不支持当前模型的账号会按模型暂时跳过。旧版本手动关闭过参与资格的账号也会重新纳入候选,无需重新登录;是否允许自动切换仍由「账号不可用时自动切换」总开关控制
- ChatGPT 备用账号右侧的上移、下移按钮可调整自动尝试顺序;当前账号固定在顶部,其余按显示顺序尝试。设置只保存在本机,不同步到其他设备,不需要退出账号或重新登录;保存期间控件暂时禁用,失败会显示错误并保留原列表
- 单账号场景也能从面板里「退出登录」
ChatGPT 开启自动切换后,若备用账号明确不支持当前模型,会继续尝试后面的账号,而不是在该账号停止。只换账号,不换模型;版本兼容恢复仍先在原账号进行。此类拒绝按「账号+模型」暂记五分钟,后续请求会跳过对应备用账号,不影响它使用其他模型;手动选中或重新登录可重新尝试。全部候选仍不可用时才报错,普通参数错误或已经开始返回内容的请求不会通过这条规则重放。
ChatGPT 订阅提示当前账号或接入方式不支持所选模型时,请先在设置 → 模型 → ChatGPT 订阅中核对模型 ID,确保与官方 ID 完全一致,包括大小写和连字符,不要填写显示名称。也可切换到当前账号可用的模型;ID 正确仍失败时,确认登录账号并更新 NewMax 后重试。这类错误本身不能说明账号是免费订阅。
账号自动切换只在同一个订阅提供商内切换账号,不会改变模型或切到其他提供商;跨提供商切换请使用「智能路由 / 故障转移」。ChatGPT 订阅遇到普通 429 时,会提示当前是并发请求过多导致的临时限速,建议稍后重试或减少同时运行的子代理;只有上游明确返回用量上限已达到时,才会提示 Codex 订阅额度已用完。
ChatGPT、Antigravity 和 Grok 订阅在刷新登录凭证时遇到断网、代理异常或连接关闭,会保留当前登录账号并显示网络错误,不需要重新登录;只有授权服务明确拒绝 refresh token 时,才会提示登录失效。
Grok 登录、刷新凭证或拉取模型目录时会优先使用「设置 → 网络」里的应用内代理。如果能确认代理服务器在建立 TCP 连接时直接拒绝请求,NewMax 会自动直连重试一次;超时、连接重置和服务端 HTTP 错误不会直连重试,避免重复提交已经到达上游的请求。
Antigravity 官方 CLI(
agy)已能对话,但 NewMax 仍提示项目初始化失败时,请确认两边使用同一 Google 账号并直接重试;仍失败再重新授权一次。NewMax 会沿用agy在~/.gemini/antigravity-cli/cache/default_project_id.txt中选择的项目;如果该文件不存在,则按agy的默认逻辑使用default-cli-project。此流程不依赖gemini-cli,也不要求在~/.gemini/.env另配GOOGLE_CLOUD_PROJECT。
Google 提示「需要验证账号」(
Verify your account to continue/VALIDATION_REQUIRED)时,这是账号验证要求,不是 Code Assist 初始化失败,也不能据此判断账号被封。请用同一个 Google 账号登录对应的官方服务;Antigravity 用户请在官方 Antigravity 尝试对话并按页面提示完成验证,再回 NewMax 重试,不需要为此安装gemini-cli。如果官方服务正常、只有 NewMax 仍提示验证,请附日志反馈。
Antigravity 提示「绑定的 Google Code Assist 项目没有可用许可」时,这不是密钥或登录过期问题,而是登录时绑到了账号无权使用的项目。NewMax 收到这类错误会自动重新解析项目并重试一次;如果仍然提示,请在设置 → 模型 → Antigravity 订阅中退出该账号并重新授权。
Antigravity 只有明确提示「当前网络出口地区不受支持」时才应检查代理:请打开设置 → 网络,配置 HTTP / SOCKS 应用内代理,或启用系统代理 / TUN;同时确认代理绕过列表没有包含
googleapis.com或daily-cloudcode-pa.googleapis.com。泛化 429 不能直接归因网络出口,可能是账号额度、模型容量、短期并发限制或客户端兼容问题;请先升级到最新版 NewMax。如果升级后提示重新授权,请重新登录一次 Antigravity;仍失败时稍后重试或切换模型。
Grok 订阅如果提示「连接 Grok 被中断」或「连接 Grok 失败」,请打开设置 → 网络,确认已启用代理且
api.x.ai未在代理绕过列表中;仍失败时,更换代理节点或网络后重试。NewMax 会在尚未向对话显示响应时,对这类瞬时中断最多自动重连 5 次。
Grok 订阅如果提示「账号当前没有可用额度」,请先打开错误消息中的「查看 Grok 用量」,确认本周共享用量和重置时间。如果仍有额度,通常是 NewMax 登录的 xAI 账号与购买订阅的账号不一致;请在设置 → 模型 → Grok 订阅中退出,再使用购买订阅时相同的登录方式和账号重新登录。
智能路由与故障转移
当配置了多个提供商时,可以启用智能路由功能。
操作步骤:配置智能路由
- 打开设置 → 模型标签
- 找到「智能路由」区域
- 开启智能路由开关
- 开启后同时激活故障转移功能
- 配置故障转移队列(按优先级排列备用提供商)
故障转移机制
- 当主提供商请求失败时,自动切换到队列中下一个提供商
- 故障转移队列可拖拽排序,调整优先级
- 可将某个提供商「提升」到队列顶部
- 支持自动切换:失败时无感切换到备用提供商
操作步骤:配置离线模式(使用 Ollama)
通过添加 Ollama 提供商,可以完全离线使用 AI 对话。
- 先在电脑上安装 Ollama:
- 前往 ollama.com 下载安装
- 打开终端运行
ollama pull llama3(或其他模型)下载模型 - 确认 Ollama 服务已启动(默认运行在 localhost:11434)
- 在NewMax中添加 Ollama 提供商:
- 点击左侧导航栏底部的头像图标 → 打开「设置」
- 点击左侧「模型」标签
- 点击「添加提供商」
- 选择「Ollama」
- Base URL 默认为
http://localhost:11434,无需修改 - 不需要填写 API Key
- 保存
- 切换到本地模型:
- 回到对话界面
- 点击输入框右侧的模型选择器
- 在下拉菜单中找到 Ollama 分组
- 选择已下载的本地模型
- 现在可以断网使用 AI 对话
提示:离线模式下不可用联网功能(网络搜索、网页获取等)。
本地模型上下文不足时怎么办
- 使用「Ollama」提供商时,NewMax 会在发送前核对模型实际运行的上下文窗口;尚未加载的模型会先加载再核对,因此冷启动可能需要等待。模型理论上支持 128K,不代表 Ollama 当前也按 128K 运行;仅修改 NewMax 的窗口数值不会扩大 Ollama 的实际窗口。
- 本地模型默认按需读取记忆,不再在每次新会话中自动附带完整记忆索引;Skill 目录只保留简短说明,完整内容在使用时加载;多代理编排、团队消息等本地模型难以使用的工具也不会发给本地模型。项目规则、你的问题和显式选用的 Skill 指令仍会保留。开启「本地模型加载全部扩展功能」也不会关闭上下文保护。
- 如果预计输入超过安全预算,NewMax 会停止发送并显示当前窗口、预计输入和可用预算,不会为了发送而静默删掉当前问题,也不会因此转到备用云端模型。可先压缩已有对话或新开对话;如果固定背景本身太大,需要减少无关背景,或在 Ollama 中提高实际上下文窗口后重试。更大窗口会增加内存需求。
- 如果提示「无法确认实际上下文窗口」,请确认 Ollama 正常运行,并使用能返回运行窗口信息的版本;通过反向代理连接时,还需允许访问
/api/ps和模型预加载接口/api/generate。不能确认窗口时,NewMax 不会按猜测的 128K 继续发送。 - 预算仍是带安全余量的估算,并非精确分词结果;大量图片等输入可能需要进一步减少。以上窗口自动核对针对内置「Ollama」提供商,自定义兼容提供商不自动调用 Ollama 专用接口。
模型网关(开放 API)
NewMax 可以作为本地 API 网关,供其他工具调用。网关对外提供 OpenAI Chat Completions 和 Anthropic Messages 接口,支持转接 Gemini 原生 API,并转换流式回复、图片输入和工具调用。外部工具指定模型时,会按该模型的能力处理请求参数。上游报错或流意外中断时,网关会向调用工具返回错误;回复达到输出长度上限时会保留截断状态。兼容服务在有效输出后仅发送结束标记时,也能正常完成回复并保留全部工具调用;只有空首包和结束标记仍会报错。调用工具断开连接后,网关会取消上游请求。
操作步骤:启用模型网关
- 打开设置 → 找到「开放网关」标签
- 开启模型网关开关
- 设置监听端口(默认端口可自定义)
- 启用后,其他本地应用可通过
http://localhost:端口调用 AI 模型 - 网关自动继承故障转移配置
使用 OpenCode Go 等要求会话标识的服务时,调用网关的工具仍需为每段对话提供稳定的会话标识(OpenCode Go 使用 x-opencode-session),并保持真实的客户端标识。网关会保留这些标识,切换 API Key 时也不会改变会话标识。
Claude 代理
本地代理功能,用于 Claude Code CLI 的请求转发和故障转移。
操作步骤:启用 Claude 代理
- 打开设置 → 找到「开放网关」标签
- 开启 Claude 代理开关
- 设置代理端口
- 启用后可在 Claude Code CLI 中使用本地代理地址
文档能力检测会要求模型读出测试 PDF 内的随机校验文本,只有内容验证通过才标记支持。仅返回成功、未读到文件或回复无法验证时保持未确认。旧版未经内容验证的“支持文档”检测结果会在加载配置时恢复为未确认,可重新检测;手动设置的能力不受影响。此标记表示接口能直接读取 PDF,不代表通过工具提取文档文字的能力。