MathBank使用指南
v3.1.0GitHub下载软件
MATHBANK HANDBOOK / 02

API 配置

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

本页目录
i
真实 Key 只填在你自己的 MathBank 软件中

本页以硅基流动为例,先配置 Word 拆题。本站只提供教程,不接收或保存 API Key。

先认清三个配置项

配置项它的作用
API Key服务商提供的调用凭证,类似一把钥匙。请勿分享给他人。
模型名称决定由哪个模型完成任务。同一平台的 Key 通常可以调用多种模型,具体以账号权限为准。
Base URL服务商的接口地址。MathBank 已内置硅基流动的地址,走下面的常规配置时无需另填。

Key 必须与平台对应:硅基流动的 Key 不能填到 DeepSeek 官方或百炼的字段中。

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

一套硅基流动账号与 Key,就可以按任务选择不同模型。已有可用配置时,可直接查看第三步的验证方法。

!
使用 API 前,先充值

先在服务商账户中充值,并确认余额已到账,再回到 MathBank 调用模型。创建了 API Key 不等于已有可用额度;建议先小额充值,用小样例验证。

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

平台按钮如有变化,可对照官方说明操作。

第二步:先配置拆题模型

在「首选模型与识别设置」中,找到「试卷智能拆解模型」,平台选择硅基流动,模型按下方示意填写。首次导入 Word 先完成这一项即可。

配置示意 · 请在本地软件中操作

SiliconFlow Keysk-••••••••(你的硅基流动密钥)
拆题平台硅基流动
拆题模型Qwen/Qwen3.8-27B

需要识图时,将「默认公式识图模型」设为 Qwen/Qwen3.8-27B;分类或生成解析可选择 Qwen/Qwen3.8-27B,平台均选硅基流动。

配置示意使用千问;也可改选 deepseek-ai/DeepSeek-V4.1-Flash,每项只填一个 ID。名称中的 Qwen/ 或 deepseek-ai/ 前缀都要保留。v3.0.0 已内置 Qwen/Qwen3.8-27B 和 deepseek-ai/DeepSeek-V4.1-Flash,可直接选择。旧版没有相应型号时,选择硅基流动,点击模型旁「+」添加完整 ID;旧版不能据此保证自动关闭思考。

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

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

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

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

开始前,再确认所选平台已充值、余额已到账。保存 Key 和模型设置不会自动给 API 账户充值。

1

保存设置

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

2

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

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

3

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

拆题和识图需要分别验证。检查截图中的文字、公式是否被正确读出。

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

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

常用模型:千问与新 Flash 二选一

Qwen3.8-27B 与 DeepSeek-V4.1-Flash 并列推荐。两款均可用于识图与文本任务;先比较一个小样例,再选择适合自己的模型。

1

Qwen3.8-27B:已内置的常用选择

Qwen/Qwen3.8-27B 支持图片理解与文本处理,v2.3.1 起已内置。本页配置示意采用这款模型。

2

DeepSeek-V4.1-Flash:可对照的快速候选

deepseek-ai/DeepSeek-V4.1-Flash 已内置于 v3.0.0。作者此前的一次 9 页 PDF 样例中识图较快,但出现公式、表格误读和配图裁框不完整;需逐项核对题文与图片,这也不是全任务准确率排名。

v3.0.0 会为它的识图、拆题、分类关闭思考,解题服从原开关。旧下载版用「+」添加 ID 后,不代表也已具备这些调用参数;请先确认版本与设置。

希望节省识图费用?查看千问备选

Qwen/Qwen3-VL-32B-Instruct 与 Qwen/Qwen3-VL-8B-Instruct 仍可用于识图。按作者经验,三款千问的能力顺序为 Qwen3.8-27B > Qwen3-VL-32B-Instruct > Qwen3-VL-8B-Instruct;后两款费用相对更低、能力也相对更弱。这个顺序不包含新 Flash,具体计费以控制台为准。

PDF 图文导入要配好识图与拆题:两项可以分别选择上述任一款,或采用不同模型。先核对识图中的文字、公式和配图,再检查题目边界;只换解题模型不会改善这两步。查看三种 PDF 策略 →

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

已有 DeepSeek 官网账号?可以继续使用

硅基流动的新 Flash 与DeepSeek 官方平台是不同配置。已有官网账号时,可将官网 Key 填入「DeepSeek API Key」,对应任务的平台也选择 DeepSeek。

  • 拆题或分类:官网模型选 deepseek-flash。
  • 解题:官网模型可选 deepseek-v4-pro。
  • 识图:可以使用硅基流动的上述两款,也可单独验证官方 deepseek-flash。

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

已有百炼账号,也可以继续使用

查看百炼配置备选

在阿里云百炼创建 Key,填入本地软件的百炼字段,任务平台也选择百炼。常规任务可用 qwen3.7-flash,解题或绘图可尝试 qwen3.7-plus。无需为了跟教程而重新注册。

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

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

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

中转站:渠道说明与推广链接

国内使用 GPT 或 Gemini 可能受网络与服务地区条件影响,也可以选择提供兼容接口的第三方中转站。下方是项目推广链接,渠道情况按所标日期的实际页面核对;未进行付费 API 调用验证。

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

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

中转站 A · 推广链接

RightCodes

提供 Codex、Claude、Gemini 等渠道。核对时 Gemini 分组列有 gemini-3.8-flash;各渠道的地址与接口格式需分别确认。

2026-09-22 核对时有部分渠道临时禁用、外接分组暂停及 Gemini 稳定性提示;历史核查不代表当前状态,GPT 6.1 Sol 的渠道可用性尚未核对。

核对于 2026-09-22

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

PackyAPI

提供 OpenAI、Claude、Gemini、千问等系列。核对时 gemini-3.8-flash 位于 gemini-slb 分组,详情列出 /v1/chat/completions 接口。

创建令牌时,需选择与目标模型匹配的分组。2026-09-22 的目录核查不代表当前状态,GPT 6.1 Sol 的渠道可用性尚未核对。

核对于 2026-09-22

前往 PackyAPI 注册(推广链接) ↗
  • 核对接口:确认所需模型、图片输入与 MathBank 兼容接口均可用。
  • 小额测试:先看计费与退款规则,用原创样例验证,不一次预存过多额度。
  • 保护资料:不上传学生信息或未公开试卷,不把官方 Key 交给中转站。

2026-09-22 的历史核查确认两站当时列出 Gemini 3.8 Flash;本轮未核对 GPT 6.1 Sol 的渠道可用性。使用前请重新核对模型与渠道状态。

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 绘图模型」;需要改善识图则调整「默认公式识图模型」。先用一个小任务验证。只在服务商支持时调整推理强度,不能仅根据模型品牌假定接口格式相同。

V3.1.0 的 MinerU 配置

打开「系统设置 → API」,填写 MinerU API Token。「PDF 配图优先用 MinerU」默认关闭。开关只设置默认配图策略,单份 PDF 可以在导入时覆盖。MinerU 需要接收原 PDF,结果通过原页校验后,程序从本地原件回裁。V3.1.0 便携包和更新的源码均可配置。

搜索使用指南

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

图片预览