功能使用与设置

自定义 API 与模型

配置自定义 API,并理解模型选择与多模态标识。

当前所在地区

在桌面客户端进入“设置”后,打开“高级设置”,可以在“当前所在地区”中选择模型服务通道:

  • 中国大陆:适合主要在国内网络环境下使用,会使用面向国内访问优化的模型配置。
  • 其他地区:适合在海外或跨境网络环境下使用,会使用面向海外访问优化的模型配置。

切换后客户端会重新拉取可用模型配置。若出现模型加载慢、请求超时或响应不稳定,先确认这里是否选择了与你当前网络位置一致的通道。

操作时先点击「当前所在地区」标题展开选项,再按下面顺序检查:

  1. 选择与你当前网络位置一致的地区,不要只按账号注册地选择。
  2. 等待模型配置刷新完成,再关闭高级设置。
  3. 回到「解题模型」或「面试回答模型」列表,确认当前选择仍可用。
  4. 用一次简短请求检查是否正常返回;如果仍异常,继续核对网络和模型设置。

自定义 API(专业版及以上)

专业版及以上支持自定义 API。填写模型名称、API URL 与 API Key 后保存即可生效。API Key 仅保存在当前设备,并只会在向你配置的 API 服务发起请求时使用。

可点击的操作演示

跟着点一次:添加并选择自定义模型

点击图片中的编号,看看客户端接下来会发生什么。也可以用下方的教程按钮逐步查看。

客户端 2.2.7 · macOS 界面 · 示例配置

01 / 09

点击悬浮工具条右侧的齿轮

点击悬浮工具条右侧的齿轮
1 → 点击设置齿轮放大完整截图(新标签页)

先找到桌面客户端的悬浮工具条,点击最右侧齿轮,打开设置面板。

完成后,你会看到:设置面板展开,能看到语言、模型、截图模式,以及下方的常用入口。

以下使用固定示例演示点击过程。你可以点击图片中的黄色标记,也可以用下方「教程下一步」。

展开全部图文步骤,照着操作
  1. 1. 点击悬浮工具条右侧的齿轮

    先找到桌面客户端的悬浮工具条,点击最右侧齿轮,打开设置面板。

    点击悬浮工具条右侧的齿轮

    设置面板展开,能看到语言、模型、截图模式,以及下方的常用入口。

    以下使用固定示例演示点击过程。你可以点击图片中的黄色标记,也可以用下方「教程下一步」。

  2. 2. 在设置面板下方点击「高级设置」

    向下查看设置面板,找到与「知识库」「语音设置」并列的「高级设置」,点击进入。

    在设置面板下方点击「高级设置」

    打开高级设置窗口。每个带箭头的标题都能点击展开,窗口内容较多时可以向下滚动。

    本图放大了入口所在区域。这里只是打开窗口,还没有修改任何选项。

  3. 3. 展开「自定义 API」,确认账号可用

    在高级设置窗口内向下滚动,点击「自定义 API」。使用专业版或旗舰版账号,准备服务商提供的接口地址、模型标识和 API Key。

    展开「自定义 API」,确认账号可用

    展开模型名称、API URL、API Key 等字段及多模态开关。

    本教程里的地址、模型和密钥都是无效示例,只用于说明填写位置。实际参数请以你使用的服务为准。

  4. 4. 区分显示名称与实际模型标识

    填写四项:显示名称用于你自己辨认;API URL 填服务的接口地址;API Key 填该服务密钥;模型名称填 API 接受的实际模型标识。本例用「教程示例模型」作为显示名称。

    区分显示名称与实际模型标识

    四个必填字段都有内容,密钥以密码形式显示。

    图中 example.invalid 地址无法调用。显示名称可以自取,模型标识必须准确;不要把自己的显示名称当作 API 模型标识。

  5. 5. 按模型能力设置多模态,选填附加参数

    向下查看请求头、请求体参数和「支持多模态(图片输入)」。服务没有要求附加参数时留空;只有模型确实支持图片时才打开多模态。本例演示打开。

    按模型能力设置多模态,选填附加参数

    多模态开关开启,其余附加字段保持空白。

    打开开关不会让纯文本模型获得图片能力。请求头或请求体需要填写时,使用合法 JSON 对象;请求头的值应为字符串。

  6. 6. 填写完毕后点击「添加模型」

    向下滚动到自定义 API 区域底部,核对参数后点击「添加模型」。

    填写完毕后点击「添加模型」

    创建成功后,高级设置窗口关闭,返回设置面板。

    有错误提示时先处理提示再重试。添加成功表示配置已建立,尚不能证明服务地址或密钥能实际调用。

  7. 7. 回到解题模型列表,选中刚添加的模型

    在设置面板展开「解题模型」下拉列表,找到自己填写的显示名称,本例为「教程示例模型」,点击选中。

    回到解题模型列表,选中刚添加的模型

    解题模型按钮上的名称更新为刚添加的模型。

    仅添加模型还不够,需要选择到相应功能上。面试回答模型是另一处选择;用于语音时还要检查对应列表中的可用项。

  8. 8. 在展开的列表中点击自己的模型名称

    在解题模型列表里找到「教程示例模型」。实际使用时查找你自己填写的显示名称,并直接点击这一项。

    在展开的列表中点击自己的模型名称

    模型列表收起,设置面板上的截图解题模型名称更新。

    如果列表没有新增模型,先确认添加时没有错误提示,再重新打开列表或刷新模型配置。

  9. 9. 确认当前模型名称,再发起一次短测试

    确认「解题模型」显示「教程示例模型」所在的位置。在实际使用中换成有效参数,再用一张简单题目截图触发解题,检查是否正常返回。

    确认当前模型名称,再发起一次短测试

    模型已被选中;真实请求能返回有效回答后,才算完成接口验证。

    本演示没有发出 API 请求。失败时先核对地址、密钥、模型标识和图片能力;必要时切回内置模型做对照。

模型选择与多模态提示

在「解题模型」列表中,可用的多模态模型右侧有输入方式开关:蓝色图片图标表示图片输入,灰色文档图标表示文本输入。点击图标可以切换;点击模型名称才是选择该模型。

先确认 API URL 与模型名称匹配,再录入 API Key;首次配置后建议先做 1 次短会话验证。

可点击的操作演示

跟着点一次:切换模型的图片与文本输入

点击图片中的编号,看看客户端接下来会发生什么。也可以用下方的教程按钮逐步查看。

客户端 2.2.7 · macOS 界面 · 示例配置

01 / 06

点击悬浮工具条右侧的齿轮

点击悬浮工具条右侧的齿轮
1 → 点击设置齿轮放大完整截图(新标签页)

先找到桌面客户端的悬浮工具条,点击最右侧齿轮,打开设置面板。

完成后,你会看到:设置面板展开,能看到语言、模型、截图模式,以及下方的常用入口。

以下使用固定示例演示点击过程。你可以点击图片中的黄色标记,也可以用下方「教程下一步」。

展开全部图文步骤,照着操作
  1. 1. 点击悬浮工具条右侧的齿轮

    先找到桌面客户端的悬浮工具条,点击最右侧齿轮,打开设置面板。

    点击悬浮工具条右侧的齿轮

    设置面板展开,能看到语言、模型、截图模式,以及下方的常用入口。

    以下使用固定示例演示点击过程。你可以点击图片中的黄色标记,也可以用下方「教程下一步」。

  2. 2. 在设置中展开「解题模型」下拉框

    找到「解题模型」,点击当前模型名称,展开模型列表。本例使用上一组已添加、支持图片输入的「教程示例模型」。

    在设置中展开「解题模型」下拉框

    列表显示可选模型;支持多模态且可用的模型,右侧还有一个可点击的小图标。

    模型名称用于选择模型,右侧小图标用于切换该模型的输入方式。

  3. 3. 蓝色图片图标表示已开启图片输入

    找到示例模型右侧的蓝色图片图标,点击一次,观察它如何切换。

    蓝色图片图标表示已开启图片输入

    图标切换为灰色文档,表示这一个模型改用文本输入。模型下拉框保持展开。

    这是输入方式开关,不是仅供展示的徽标。支持多模态,也可以由你选择暂时不传图片。

  4. 4. 灰色文档表示文本输入,再点一次切回图片

    点击同一位置的灰色文档图标。本例准备处理含图表的题目,因此切回图片输入。

    灰色文档表示文本输入,再点一次切回图片

    图标恢复为蓝色图片,图片输入已重新开启。

    自定义 API 里的「支持多模态」声明接口是否支持图片;列表里这个开关决定本次使用哪种输入。声明支持不会让实际不支持的接口获得图片能力。

  5. 5. 确认图标后,再点击模型名称

    确认右侧为蓝色图片图标,再点击「教程示例模型」这一行的名称。

    确认图标后,再点击模型名称

    模型列表收起,解题模型显示为所选名称。

    只点击右侧图标不会帮你选中另一款模型;准备使用哪一款,仍需点它的名称。

  6. 6. 关闭设置,用一道短题验证输入方式

    检查当前模型名称,关闭设置,截取一道简短题目并触发解题。需要模型理解图片时,使用包含图表的示例检查结果。

    关闭设置,用一道短题验证输入方式

    可根据实际返回结果确认接口可用、模型选择正确,以及图片输入是否正常。

    教程使用无效示例 API,不会真的调用模型。你的服务能否处理图片,需要用自己的接口实际验证。

使用建议

  • 国内网络优先选择“中国大陆”,海外网络优先选择“其他地区”。
  • 先确保 API URL 与模型名称匹配,再录入 API Key。
  • 首次配置后先做 1 次短会话验证,再用于正式面试。
  • 出现响应慢或失败时,先回退到默认模型对照排查。

相关文档