Skip to content

1.2 多模型与自定义端点

本节目标

除了 DeepSeek,学会接入更多模型提供方,以及把 dsh 接到任意 OpenAI 兼容的服务上,比如本地的模型或者公司内部的网关。

两种接法

模型页上有两个入口,对应两种场景:

  • 添加提供方:从 dsh 内置支持的提供方列表里选,填个密钥就能用,最省事
  • 添加自定义提供方:手动填一个服务地址,适合本地模型、中转网关、公司内部服务

这一节两种都讲。

方式一:从内置列表添加

  1. 打开设置 → 模型
  2. 添加提供方
  3. 在弹出的列表里选择你用的服务。列表以英文标识列出各家平台,内置有 OpenAI、OpenRouter、xAI、Mistral、通义千问(qwen)、MiniMax、月之暗面(moonshotai)、智谱(zai)、小米(xiaomi)、NVIDIA、Together 等二十多家
  4. 选中后会进入该提供方的配置表单,填上对应的 API 密钥,点保存

每个提供方的表单都长得差不多,都是密钥加可选的模型列表,和 1.1 节 DeepSeek 的编辑表单一致。

拿不到某家的密钥?

各家平台都有自己的开放平台,去对应官网注册申请即可。填完后和 DeepSeek 一样,模型立即可用。

方式二:添加自定义提供方

这个入口是给"标准 OpenAI 兼容接口"准备的。你的服务只要实现了 OpenAI 的接口协议,就能被 dsh 识别。典型的场景有三个:

  • 本地跑的模型,比如 Ollama、vLLM、LM Studio
  • 第三方中转服务,统一转发到多家大模型
  • 公司内部网关,只对员工开放

添加自定义提供方,弹出下面的表单:

自定义提供方表单

逐个字段解释:

字段填什么例子
Provider ID小写字母开头的唯一标识,用于派生凭据名my-gateway
显示名称界面上显示的名字我的网关
API 地址服务的完整地址https://gateway.example/v1
API 协议接口协议,三种可选openai-completions
API 密钥该服务的密钥sk-...
模型目录列出可用的模型 ID见下方说明

API 协议选哪个

  • openai-completions:标准 OpenAI 对话补全协议,绝大多数服务都兼容,默认选这个
  • openai-responses:OpenAI 新版 Responses 协议,只有 OpenAI 自家最新服务用
  • anthropic-messages:Anthropic(Claude)的消息协议

不确定就选第一个。

模型目录怎么填

表单里有一个模型目录区域,两种填法:

  1. 获取可用模型,dsh 会自动请求服务把模型列表拉下来,不用手敲
  2. 如果服务不支持列举模型,点添加模型手动填:先填模型 ID(请求里用的原始 ID,比如 qwen2.5-7b),再填显示名称(界面下拉里看到的)

填完点创建提供方就完成了。

实战:接一个本地 Ollama

拿最常见的本地模型场景举例。假设你装了 Ollama 并跑起了 qwen2.5:7b

  1. 模型页点添加自定义提供方
  2. Provider ID 填 ollama-local
  3. 显示名称填 本地 Ollama
  4. API 地址填 http://localhost:11434/v1
  5. API 协议选 openai-completions
  6. API 密钥随便填一个占位(本地服务通常不校验)
  7. 获取可用模型,或手动添加模型 ID qwen2.5:7b
  8. 创建提供方

之后就能在主界面的模型选择器里看到本地 Ollama了。

本地服务的地址

本机服务用 localhost 就行。如果 Ollama 跑在另一台机器上,地址要换成那台机器的局域网 IP,并确认服务监听了非本机端口。

常见问题

问:填完自定义提供方,模型选择器里看不到模型?

先确认模型目录里有没有模型。用获取可用模型拉一次,不行就手动添加。另外确认 API 地址和协议没选错,地址末尾的路径(比如 /v1)要和服务要求一致。

问:保存时报"无法连接"?

地址不对或者服务没起来。先在浏览器里直接访问 API 地址试试,能通再回来填。

小结

  • 内置支持二十多家提供方,点添加提供方选完填密钥即可
  • 自定义提供方适合本地模型、中转、公司网关,关键是填对地址 + 协议 + 模型
  • 模型目录可以用获取可用模型自动拉取,也可以手动添加

模型配好了,接下来选一个工作区,告诉 dsh 在哪个地盘干活。

发现错误?提交反馈 · 欢迎 提 PR 改进本书