MathBank使用指南
v2.3.0GitHub下载软件
MATHBANK HANDBOOK / 02

API 配置

配置一个平台,先让一次小任务跑通。

i
真实 Key 只填在你自己的 MathBank 软件中

本页以硅基流动为入门示例。只需配置这个平台,就能分别选择识图、拆题和解题模型。本网站不接收、不保存 API Key。

先认清三个配置项

配置项它的作用
API Key服务商提供的调用凭证,类似一把钥匙。请勿分享给他人。
模型名称决定调用哪个模型。硅基流动中可以用同一份 Key 选择不同千问模型;使用 DeepSeek 系列则优先参考下方的官网配置。
Base URL服务商的接口地址。MathBank 已内置硅基流动的地址,走下面的常规配置时无需另填。

同一平台下可以切换模型,但在硅基流动获得的 Key 不能填到 DeepSeek 官方或百炼的密钥字段。平台不同,调用凭证也不同。

第一步:在硅基流动创建 Key

还没有平台账号时,可以跟着下面的步骤开始。硅基流动把多种模型放在同一个平台里,本教程用一套账号与 Key 完成日常导入和解题的配置。

  1. 注册或登录硅基流动。按平台提示完成实名认证与账号准备。
  2. 进入「API 密钥」页面。点击「新建 API 密钥」,创建后复制自己的 Key。
  3. 查看模型与可用额度。在平台的模型列表中确认准备使用的模型、权限与计费说明,不必先尝试所有模型。
  4. 回到本地 MathBank。打开「系统设置」,找到 SiliconFlow API Key(硅基流动云端),将 Key 填在这里。

Key 不需要发给开发者,也不需要粘贴到本教程。平台按钮如有变化,可对照官方说明操作。

第二步:都选硅基流动,再按任务选模型

在「首选模型与识别设置」中,每项先选择平台硅基流动,再选模型。首次导入 Word 只需先配拆题;识别图片、生成解析时再补齐相应项。

只读示意 · 请在本地软件中操作

SiliconFlow Keysk-••••••••(你的硅基流动密钥)
各项平台硅基流动
拆题模型Qwen/Qwen3.8-27B
识图模型Qwen/Qwen3-VL-8B-Instruct
分类模型Qwen/Qwen3.8-27B
解题模型Qwen/Qwen3.8-27B

这套单平台示意使用硅基流动的 Key 与千问模型。Qwen/ 也是 ID 的一部分。Qwen3.8-27B 是本次本地更新新增的预设;已发布的 v2.3.0 包若还没有此项,可点击模型旁的“+”手动添加完整 ID。

硅基流动的 Base URL 需要填写吗?

正常使用 MathBank 的硅基流动选项时,软件已经内置接口地址,不需要在中转站的 Base URL 中再填一遍。

排查接口配置时,可核对官方地址:https://api.siliconflow.cn/v1。不要混用其他服务商的 Key 与地址。

常用模型,先知道各自负责什么

1

Qwen-VL 8B:先把图片读出来

Qwen/Qwen3-VL-8B-Instruct 用于「默认公式识图模型」,适合先测试清晰的截图和扫描 PDF。重点检查文字、公式、上下标与表格。

2

Qwen-VL 32B:识别不理想时再对照

Qwen/Qwen3-VL-32B-Instruct 也是识图候选。按作者使用经验,32B 整体效果更好;想改善复杂公式或版面识别时,可以直接尝试,并与 8B 的结果对照。

3

Qwen3.8-27B:识图和文本处理的新候选

Qwen/Qwen3.8-27B 支持图片理解,作者在题库任务中反馈效果不错,可尝试用于识图、拆题或解题。旧版本缺少选项时,先选择硅基流动,再点击对应模型区域的「+」,添加完整名称。

扫描 PDF 要配两步:先用识图模型读取,再用拆题模型整理成题目。两项可以使用不同的千问模型;只更换解题模型不会改善前面的识图与拆题。

查看完整模型说明与切换建议 →

如果使用 DeepSeek,优先选择官网

按作者观察,硅基流动的 DeepSeek 型号更新相对较慢。想使用 DeepSeek 系列时,建议前往DeepSeek 官方平台创建 Key,再填入本地设置中的「DeepSeek API Key」。

  • 拆题或分类:平台选 DeepSeek,模型选 deepseek-flash
  • 解题:平台选 DeepSeek,模型选 deepseek-v4-pro
  • 识图:可以继续使用已配好的硅基流动千问模型;也可单独验证官方 deepseek-flash 的识图。

切到官网时,要同时匹配平台、Key 与模型名称;硅基流动的 deepseek-ai/… 名称不能原样填到官方平台。

第三步:保存后,用小任务验证

1

保存设置

看到保存成功提示后,继续做一次实际调用。

2

导入三题 Word 样例,验证拆题

下载入门样例,先关闭自动生成解答,点击「开始解析」,检查是否返回三道独立题目。这里验证的是硅基流动的拆题模型。

3

需要识图时,再识别一张单题截图

Word 拆题成功不等于 Qwen-VL 识图调用成功。再检查截图中的文字、公式是否被正确读出。

应该看到:对应任务返回了可检查的结果,没有密钥、权限或连接错误。模型结果是否准确,还需要人工核对。

若调用失败,记录平台、完整模型 ID 和具体错误,进入密钥与连接排查。不要反复保存相同设置来代替测试。

已经有其他平台账号

查看 DeepSeek 官方与百炼的配置备选

可以继续使用已有的平台,不必为了教程重新注册。DeepSeek 官方可先用 deepseek-flash 识图与拆题,解题尝试 deepseek-v4-pro;百炼可用 qwen3.7-flash 做常规任务,解题或绘图尝试 qwen3.7-plus

Key 填入对应平台字段,任务设置也选择同一平台。硅基流动的模型 ID 与 DeepSeek 官方的名称不同,不要直接互换。

希望进一步提升效果:GPT / Gemini

作者日常使用 Gemini 3.8 Flash,也推荐 GPT 5.6 Luna。需要更好的公式识别、复杂解析或高级 TikZ 绘图效果时,可以考虑这两类模型;其中 TikZ 绘图优先建议使用 GPT / Gemini。

它们的官方模型 ID 分别为 gemini-3.8-flashgpt-5.6-luna,中转站可能使用不同的名称或后缀,必须以实际服务商列表为准。查看用途与作者使用经验 →

中转站:当前渠道情况与推广链接

国内使用 GPT 或 Gemini 可能受网络与服务地区条件影响,也可以选择提供兼容接口的第三方中转站。下面保留项目 README 中的推广链接,介绍已按两站登录后的模型页面核对更新。型号列在目录中,不等于已替你完成真实 API 调用验证。

!
第三方服务有风险,开发者不提供担保

中转方可能接触你发送的试题、图片和调用内容;存在隐私泄露、服务中断、额度损失以及模型被替换或降级等风险。模型名称不能证明实际调用的模型,价格、可用性与退款规则也可能变化。

中转站 A · 推广链接

RightCodes

提供 Codex、Claude、Gemini 等多个渠道。本次登录实页核对,Gemini 分组已列出 gemini-3.8-flash;不同渠道的地址和接口格式需要分别确认。

Gemini 分组注明 CLI 逆向及稳定性提示;主页存在 Luna 临时禁用公告,Codex 外接分组也有暂停提示。不要把 GPT 5.6 Luna 视为当前已确认可用。

核对于 2026-09-22 · 当前模型列表 ↗ · 接入说明 ↗

前往 RightCodes 注册(推广链接) ↗
中转站 B · 推广链接

PackyAPI

模型广场提供 OpenAI、Claude、Gemini、千问等多个系列。本次登录实页确认 gemini-3.8-flash 位于 gemini-slb 分组,详情明确支持 /v1/chat/completions。

核对时搜索 gpt-5.6-luna 没有结果。创建令牌时应选择与目标模型匹配的分组,不能只看网站首页的品牌名称。

核对于 2026-09-22 · 当前模型列表 ↗ · 接入说明 ↗

前往 PackyAPI 注册(推广链接) ↗
  • 先核对,再小额测试:查看当前支持的模型、图片输入、计费及退款规则,用原创小样例验证后再决定是否继续使用。
  • 不上传敏感资料:避免发送学生信息、未公开试卷或其他保密内容,不将官方平台的密钥交给不可信中转方。
  • 确认实际调用效果:不要把“标有 GPT / Gemini”视为模型真实度或服务质量的保证;不建议一次预存过多额度。

两站核对时均列出了 Gemini 3.8 Flash;GPT 5.6 Luna 则不能据本次页面检查认定当前可用。模型列表、渠道状态和分组会变化,使用前请重新核对。开发者不保证其稳定性、模型真实性或数据安全。

RightCodes:先区分 Codex 渠道与普通题库任务

本次实页核对,普通 Codex 分组写有“仅限正常Coding”和禁止批量任务的限制,外接分组另有暂停提示。不要直接把这一分组用于试卷批量导入,应先确认当前渠道允许此类调用。

其接入文档还说明,Codex 的 Chat Completions 接口由 Responses 转换而来,并会替换 system prompt。MathBank 的识图、拆题依赖任务提示,这类转换可能影响结果;不能只凭接口名称判断完整兼容。

Gemini 的公开调用示例使用原生 Gemini 协议。虽然模型列表已列出 gemini-3.8-flash,仍需确认所选渠道是否提供 MathBank 所需的 OpenAI 兼容接口,不能直接复制原生 Gemini URL 使用。查看该站接口说明 ↗

PackyAPI:Gemini 要选对令牌分组与接口

本次模型详情确认 gemini-3.8-flash 属于 gemini-slb 分组,同时列出原生 Gemini 与 OpenAI Chat Completions 两种端点。用于 MathBank 时,选择后者对应的地址。

该站文档当前给出的 OpenAI 兼容 Base URL 示例是 https://cf.api.fan/v1。请以控制台当前显示的 Endpoint 为准,确认包含所需的 /v1;创建令牌时也需选择对应分组。识图仍应先用一张小图片验证。查看该站配置说明 ↗

在 MathBank 中填写中转站与自定义模型

在本地「系统设置」中,将该站自己的 Key 和 Base URL 填入同一组中转站 A 或 B 字段,再在需要的任务中选择相同中转站、填写模型名称并保存。软件当前需要服务商提供兼容的聊天接口;不要把任意官网网址直接当作接口地址。填写前核对:

  • 服务地址:填入服务商给出的 Base URL;输入框灰色示例文字不代表已经配置。
  • 准确模型 ID:复制接口文档中的名称,包含必要的前缀;不要使用网页显示昵称替代。
  • 接口能力:识图需要该模型及当前接口都支持图片输入。
  • 权限与费用:确认 Key 对应账号可调用所选模型。

例如只想改善绘图,就调整「高级 TikZ 绘图模型」;需要改善识图则调整「默认公式识图模型」。先用一个小任务验证。只在服务商支持时调整推理强度,不能仅根据模型品牌假定接口格式相同。

搜索使用指南

输入问题或关键词,查找对应的操作步骤。