1. API快速配置
魔芋AI开发文档
  • API快速配置
    • CC-Switch快速配置（推荐）
    • Claude Code 与 Codex 安装配置
    • 智能体集成魔芋Skills
    • WorkBuddy 配置指南
    • TRAE Work 配置指南
    • AWS Quick Suite 配置指南
    • DeepSeek Harness (DSH) 配置指南
  • 魔芋SDK
    • SDK接口规范文档
    • SDK 完整示例
  • API文档
    • 文本接口
      • Anthropic 文本接口
      • 豆包文本接口
      • Gemini 文本接口
      • OpenAI 文本接口
      • 🖼️ DeepSeek-V4-Flash-Vision 视觉理解
      • 🖼️ GLM-5.3-Flash 多模态理解
      • rerank文本重排序 API 文档
    • 图片接口
      • 🎨 Doubao 图片接口
      • Seedream 图生图接口
      • Gemini 图片生成接口
      • GPT-Image-2 图片接口
      • MiniMax-Hailuo 图片接口
      • OpenAI 图片接口
      • Gemini 图生图调用示例
      • 即梦 & 生数异步图片接口
    • 视频接口
      • kling-v3-传入参考视频
      • 🎬 Kling-v3 系列视频接口
      • 豆包（Doubao）视频接口
      • Happy Horse 视频接口
      • 即梦视频接口
      • Kling 视频接口
      • Seedance 2.0 多图生视频调用示例
      • Sora 视频接口
      • Veo 视频生成 API 接口文档
      • MiniMax-H3 视频生成 API 文档
      • MiniMax-H3-Max 视频生成 API 文档
      • 🎬 Vidu 系列视频接口
      • wan万相 3.0 视频接口
      • Shuchuang 高清直出视频生成接口
      • 拍我AI PixVerse视频生成 API 文档
    • 语音接口
      • 🎙️ 豆包端到端实时语音接口
      • seed-audio-1.0语音合成 API 文档
      • MiniMax Speech API 文档
      • Mureka 音乐生成接口
  • API接口
    • 模型
      • 获取可用模型列表
    • 文本对话
      • OpenAI 对话补全
      • OpenAI Responses
      • Anthropic 消息接口
      • Gemini 内容生成
    • 图片生成
      • 图片编辑
      • 图片编辑 gpt-image
      • 图片生成
    • 视频生成
      • 提交视频生成任务
      • 查询视频生成任务
      • 按令牌获取视频任务列表
    • 素材库
      • 真人素材 API 接口文档（H5 人脸认证）
      • 创建素材 / 批量上传
      • 查询素材列表
      • 查询单个素材
      • 按批次查询素材
      • 更新素材名称
      • 删除素材
      • 获取素材库列表
      • 创建素材库
      • 删除素材库
      • 转移素材库
    • 素材管理
      • 素材管理 API 接口文档
      • 素材库自定义阿里云OSS教程
  • Seedance2文档
    • 豆包 Seedance 2.0 / 2.5 视频生成接口
    • 豆包 Seedance 2.5 草稿样片与正片 API 接口文档
    • 按令牌获取视频任务列表
    • 素材库 API 接口文档
  • 数据模型
    • ChatMessage
    • ChatCompletionRequest
    • ChatCompletionResponse
    • OpenAIUsage
    • ResponsesRequest
    • ResponsesResponse
    • AnthropicMessageRequest
    • AnthropicMessageResponse
    • GeminiPart
    • GeminiContent
    • GeminiGenerateContentRequest
    • GeminiGenerateContentResponse
    • ModelListResponse
    • ImageGenerationRequest
    • ImageGenerationResponse
    • SeedanceContentItem
    • SeedanceMetadata
    • VideoGenerationRequest
    • VideoTaskSubmitResponse
    • VideoTaskQueryResponse
    • VideoTaskListResponse
    • VideoTaskListItem
    • VideoAutoUploadRequest
    • VideoAutoUploadSubmitResponse
    • VideoFlatQueryResponse
    • AssetItem
    • CreateAssetRequest
    • CreateAssetResponse
    • ListAssetsRequest
    • ListAssetsResponse
    • GetAssetResponse
    • BatchGetAssetsResponse
    • AssetIdResponse
    • AssetGroupListResponse
    • ErrorResponse
  1. API快速配置

DeepSeek Harness (DSH) 配置指南

DeepSeek Harness（简称 DSH）是 DeepSeek 官方推出的 AI 智能体（Agent）工作台，支持接入自定义大模型提供方，用于办公问答、文档处理、代码编写等场景。DSH 同时兼容 OpenAI Completions 协议（openai-completions）与 Anthropic Messages 协议（anthropic-messages），只需以「自定义提供方」的方式填入 API 地址、协议、密钥和模型目录，即可接入魔芋AI（MoyuAI）平台，使用平台上的 GPT、Claude、豆包、DeepSeek 等各类模型。
本文以「魔芋AI」平台为例，讲解如何在 DSH 中添加自定义提供方、切换模型，以及如何路由到其他模型。

1. 启动 DSH#

DSH 无需单独下载安装包，通过 npx 一键启动 Web 工作台：

一键使用（推荐）#

在终端执行：
命令会自动拉起 DSH 的 Web 界面。也可切换到「源码安装」方式自行部署。
前置条件：本机已安装 Node.js（含 npx）；拥有魔芋AI的 API Key（形如 sk-XXXXXX，在平台「令牌管理」页面创建），以及服务地址 https://www.moyu.cn。

2. 进入模型设置#

1.
打开 DSH 后，进入 设置。
2.
在左侧选择 模型 标签页，可看到「填入各提供方的 API 密钥即可使用其模型」的说明。
3.
页面列出已有提供方（如内置的 DeepSeek）。底部有两个按钮：
+ 添加提供方：用于内置厂商。
+ 添加自定义提供方：用于接入魔芋AI，点击此项。
接入魔芋AI 请务必点击 「添加自定义提供方」，添加成功后该条目会显示 「自定义」 标签，前面的绿色圆点表示已连通可用。
右上角 「打开配置文件」 可直接编辑底层配置（进阶用法，一般无需手动改）。

image.png#

3. 配置自定义提供方#

DSH 通过 API 协议 字段区分接入格式，魔芋AI 两种协议都支持，二选一即可。

3.1 方式一：OpenAI 协议（openai-completions，推荐）#

点击「添加自定义提供方」后，按下表填写（对应截图）：
配置项填写内容说明
Provider IDmoyuai以小写字母开头的唯一标识，在请求中唯一标识该提供方，并用于派生凭据名。
显示名称moyuai在模型列表中显示的名字，可自定义。
API 地址https://www.moyu.cn/v1魔芋AI 的 OpenAI 兼容地址（带 /v1）。
API 协议openai-completions从下拉列表选择。
API 密钥sk-XXXXXX你的魔芋AI API 密钥，粘贴后检查首尾是否有多余空格。
模型目录见下添加要使用的模型 ID。
模型目录：点击 添加模型，每行有两个输入框——左侧为 模型 ID（发给魔芋AI 的真实模型名，如 deepseek-v4-pro），右侧为 显示名（列表中展示的名字，可与模型 ID 相同）。模型 ID 必须与魔芋AI平台的模型 ID 完全一致（含大小写与连字符）。
填写完成后点击 创建提供方 保存。
image.png

3.2 方式二：Anthropic 协议（anthropic-messages）#

若需使用 Claude 原生 Anthropic 协议，配置如下（对应截图）：
配置项填写内容说明
Provider IDmoyuai唯一小写标识。
显示名称moyuai可自定义。
API 地址https://www.moyu.cn注意：不带 /v1，与 OpenAI 协议不同。
API 协议anthropic-messages从下拉列表选择。
API 密钥sk-XXXXXX你的魔芋AI API 密钥。
模型目录如 claude-sonnet-4-6模型 ID 与显示名，填魔芋AI 支持的 Claude 模型。
填写完成后点击 创建提供方 保存。
image.png
两种协议的 API 地址不同，这是最容易填错、导致报错的地方：
openai-completions → https://www.moyu.cn/v1（带 /v1）
anthropic-messages → https://www.moyu.cn（不带 /v1）

4. 验证#

保存后，回到 模型 列表，确认 moyuAi（自定义）条目前的圆点为 绿色（表示连通）。
如需进一步验证，可点击模型目录旁的 「获取可用模型」，或在对话窗口手动切换到刚配置的模型，发送一条测试消息（如"你好"），能正常对话即配置成功。

5. 切换模型 / 编辑提供方#

在对话窗口选择模型时，从列表中选择 moyuAi 下配置的模型即可即时切换。
在 设置 → 模型 中，点击自定义提供方右侧的 编辑 可修改地址、密钥、模型目录；点击 删除 可移除该提供方。
修改保存后即时生效，无需重启。

6. 模型路由配置（切换 / 指定其他模型）#

魔芋AI平台已将各家模型统一转换为 OpenAI 格式，因此使用 openai-completions 协议接入时，Provider ID、API 地址、协议、API 密钥保持不变，只需在 模型目录 中增删条目即可路由到平台上的其他模型。

6.1 添加更多模型#

在自定义提供方的 模型目录 中点击 添加模型，填入新的模型 ID 与显示名即可，其余配置不变。例如同一个 moyuai 提供方下可同时挂载 gpt-5.6-sol、deepseek-v4-pro、claude-opus-4-8 等多个模型。
请以平台「模型广场」或 GET https://www.moyu.cn/v1/models 返回的实际模型名称为准。

6.2 获取可用模型#

点击模型目录右上角的 「获取可用模型」，DSH 会向配置的 API 地址请求模型列表，便于直接选取，避免手动输入出错。

7. 常见问题#

Q：绿色圆点没亮 / 提供方显示不可用？
A：检查 API 地址与所选协议是否匹配（openai-completions 带 /v1，anthropic-messages 不带）、API 密钥是否正确无空格，以及网络能否访问 https://www.moyu.cn。
Q：提示 404 Not Found？
A：多为 API 地址与协议不匹配。openai-completions 请填 https://www.moyu.cn/v1；anthropic-messages 请填 https://www.moyu.cn，两者都不要以斜杠结尾。
Q：提示 401 / 密钥无效？
A：检查 API Key 是否完整、有无多余空格；确认令牌未过期、账户额度充足。
Q：「获取可用模型」拉不到列表？
A：先确认地址、协议、密钥填写正确且提供方圆点为绿色；网络受限时也可手动在模型目录里逐个添加模型 ID。
Q：Provider ID 有什么讲究？
A：必须以小写字母开头，全局唯一。它在请求中标识该提供方并用于派生凭据名，随意重复可能导致凭据冲突。
Q：提示 connect ETIMEDOUT？
A：说明网络无法连接到端点，检查网络环境或代理设置，确认 https://www.moyu.cn 可正常访问。
Q：npx @deepseek-ai/dsh web 启动失败？
A：确认本机已安装 Node.js 与 npx；网络受限时首次拉取包可能较慢，可重试或改用「源码安装」方式部署。
修改于 2026-09-09 04:42:19
上一页
AWS Quick Suite 配置指南
下一页
SDK接口规范文档
Built with