APIMaster.ai
APIMaster.ai 使用文档
English快速开始APIMaster 官网模型广场

Dify 配置 APIMaster.ai

在 Dify 设置中添加 OpenAI-API-compatible 模型供应商，接入 apimaster.ai 并在应用中使用广场模型。

Dify 是可视化 Agent / 工作流平台。APIMaster.ai 提供 OpenAI 兼容 接口，在 Dify 里选择 OpenAI-API-compatible 供应商即可接入。

开始前请 获取 API Key。模型名称必须从 APIMaster 模型广场 复制 model id（如 deepseek-v4-flash），不要手打或猜别名。

前置条件

  1. 已有 Dify 账号（云版或自托管均可）。
  2. 已从 APIMaster 控制台 复制 API Key。
  3. 已在 模型广场 选好目标模型，并复制其 model id（下文以 deepseek-v4-flash 为例）。

第 1 步：进入模型供应商

  1. 登录 Dify，点击右上角头像或工作区菜单，进入 设置。
  2. 左侧选择 模型供应商（Model Provider）。

设置 → 模型供应商

第 2 步：安装 OpenAI-API-compatible

在 安装模型供应商 区域找到 OpenAI-API-compatible（兼容 OpenAI API 的第三方服务，如 LM Studio、自建网关等）。

  1. 若尚未安装，点击该卡片完成安装。
  2. 安装后，在已配置供应商列表中找到 OpenAI-API-compatible，点击右侧 + 添加模型。

APIMaster 走 OpenAI 兼容协议，因此选这一项，而不是单独的 OpenAI / Anthropic 官方卡片。

第 3 步：填写模型与凭据

在 添加模型 弹窗中，先填写基础信息与凭据：

字段 填写内容
模型名称 * 从 模型广场 复制的 model id，如 deepseek-v4-flash
模型类型 * LLM
凭据名称 APIMaster.ai（便于识别，可自定）
模型显示名称 可与 model id 相同，或填便于识别的名称
API Key 粘贴你的 APIMaster Key

添加模型 — 凭据与模型名称

  • Key 会按 Dify 说明使用 PKCS1_OAEP 加密存储。
  • 模型名称 必须与 APIMaster 广场上的 id 完全一致（大小写、连字符均不能错）。

第 4 步：填写 API 端点

继续在同一弹窗（或下一步）填写 OpenAI 兼容端点：

字段 填写内容
API endpoint URL * https://apimaster.ai/v1
API endpoint 中的模型名称 * 与上一步相同，如 deepseek-v4-flash
对话类型 对话（Chat）
模型上下文长度 * 按模型能力填写，示例 4096；更大上下文模型可填更高值
最大 token 上限 与上下文长度一致或略低，示例 4096
思考模式支持 若模型带 reasoning，可选 两种模式都支持；纯对话模型选 仅对话 即可

添加模型 — API endpoint 与上下文

点击 添加 保存。

第 5 步：确认模型已启用

添加成功后，OpenAI-API-compatible 下会出现新模型（如 deepseek-v4-flash），标签一般为 LLM · CHAT · 4K 等。

  1. 确认右侧开关为 开启。
  2. 若顶部提示需配置默认模型，可点 系统模型设置 将 LLM 默认项设为刚添加的 APIMaster 模型。
  3. 需要多个模型时，重复 + 添加模型，每次从广场复制不同的 model id。

模型已添加并启用

第 6 步：在应用中使用

  1. 回到 Dify 工作室，创建或打开 聊天助手 / Agent / 工作流。
  2. 在 模型 选择器里选刚添加的 APIMaster 模型（如 deepseek-v4-flash）。
  3. 保存并 运行 / 预览，发送一条测试消息验证连通。

若报错，请保留 Dify 完整错误信息与当前模型 id，对照 模型广场 检查名称是否一致。

常见问题

现象 处理
401 / Invalid API Key 检查 Key 是否完整、是否已在控制台启用
404 / model not found 模型名称 与广场 model id 不一致；重新复制粘贴
402 / 余额或额度 控制台查看配额；错误详情以 Dify 返回为准
应用提示未设置默认模型 设置 → 模型供应商 → 系统模型设置 指定 LLM
需要换模型 再 + 添加模型，或编辑已有项的 model id

核对清单

  • Dify 设置 → 模型供应商 已安装 OpenAI-API-compatible
  • API endpoint URL = https://apimaster.ai/v1
  • 模型名称 来自 模型广场 且两处填写一致
  • API Key 已粘贴，模型开关为开启
  • 应用内已选中该模型并能正常对话

相关链接