AI API 聚合平台：190+ 大模型、图像与视频模型

APIMart Dify 怎么配置？先核对接口类型，再完成模型接入与测试

更新于 2026-11-04 · apimart.cyou

简答：截至 2026-11-04，公开资料可以确认 Dify 支持 OpenAI-API-compatible 模型供应商，但 APIMart 当前公开文档明确展示的是 MCP 端点与 JSON-RPC 调用方式，尚不能据此确认它提供可直接填入 Dify 的 OpenAI 兼容 Base URL。因此，配置前应先核对 APIMart 控制台或文档是否提供 Chat Completions 兼容接口；如果只有 MCP 地址，不能把它直接填进 Dify 的 OpenAI 兼容供应商。

定义：APIMart 接入 Dify，指让 Dify 通过兼容的模型供应商接口调用 APIMart 中的模型，而不是把 MCP 服务地址直接当作 OpenAI API Base URL 使用。

30 秒速查卡：先判断能不能直接接

核对项可以继续配置的条件当前不能直接下结论的情况
接口类型APIMart 控制台或文档明确提供 OpenAI 兼容的聊天接口只看到 MCP、JSON-RPC 或工具调用端点
Base URL有明确的 API Base URL，并说明是否包含 /v1只有 https://panel.apimart.app/mcp 这类 MCP 地址
鉴权方式文档说明使用 API Key 或 Bearer Token 调用模型接口只能确认 MCP 请求需要 Bearer 鉴权，未确认模型接口兼容性
模型名称能从模型目录或 API 响应复制明确的模型 ID只有展示名称，没有可用于请求的模型 ID
测试方式Dify 保存模型时能完成验证，或 Chatflow 能返回文本保存时报 404、模型不存在或返回 JSON-RPC 错误

最短结论是：先确认“OpenAI 兼容模型接口”，再配置 Dify；不要把 APIMart 文档中用于 MCP 的地址直接填入 Dify。APIMart 当前公开入门资料给出的核心端点是 https://panel.apimart.app/mcp，传输方式为 Streamable HTTP 与 JSON-RPC 2.0，这与 Dify 的 OpenAI-API-compatible 模型配置不是同一接口类型。APIMart 快速上手文档 apimart.app APIMart 接口参考 apimart.app

Dify 中需要填写哪些字段

Dify 的 OpenAI-API-compatible 供应商用于连接符合 OpenAI API 标准的模型服务。当前插件配置字段至少包含模型名称、API Key 和 API Base URL；插件源码中的示例 Base URL 为带有 /v1 的兼容接口地址，但这不代表所有服务都必须使用相同路径，具体仍要以服务方文档为准。Dify OpenAI-API-compatible 插件配置 github.com

字段应填写什么核验方法
Model Name服务方提供的完整模型 ID从 APIMart 当前模型详情或接口返回中复制，不要只填中文展示名
API Key用于模型接口调用的密钥确认密钥属于可调用模型接口的凭证，而不是仅用于其他服务的凭证
API Base URLOpenAI 兼容接口的基础地址确认是否需要 /v1，不要自行追加 /chat/completions
模型类型通常先选择 LLM 或聊天模型图像、视频、Embedding 等模型不能直接套用聊天模型配置

可照做的配置流程

  1. 先在 APIMart 侧确认接口。查看当前控制台或文档是否同时提供 OpenAI 兼容的模型调用说明，包括 Base URL、模型 ID、请求路径、鉴权头和响应格式。若只显示 MCP 地址，应先停止配置，不要把 MCP 地址当作 Dify 的 Base URL。
  2. 准备调用凭证。APIMart 文档说明 API Key 创建后完整值只显示一次，后续通常只显示掩码；密钥应保存在密码管理器或环境变量中，不要提交到代码仓库。APIMart 密钥管理文档 apimart.app
  3. 进入 Dify 的模型供应商设置。在工作区的模型供应商或 Integrations → Model Provider 区域，安装或启用 OpenAI-API-compatible 供应商。不同 Dify 云端、自托管版本的菜单名称可能不同，应以当前界面为准。Dify 文档说明，模型供应商凭证配置后可供工作区应用使用。Dify 模型供应商说明 dify-docs.docs7.io
  4. 逐项填写。把已经核实的 API Base URL、API Key 和 Model Name 分别填入对应字段。Base URL 只填基础地址；是否包含 /v1 不能凭经验判断，也不能把完整的聊天请求路径直接填进去。
  5. 保存并观察验证结果。如果 Dify 在保存阶段直接报 401、404 或模型不存在，先不要反复重试，按后文的错误分流检查地址、凭证和模型 ID。
  6. 建立最小测试。在聊天应用或 Chatflow 中只使用一个文本模型，输入“请回复 ping”，确认能返回文本后，再测试系统提示词、上下文、工具调用或知识库。这样可以把模型接入问题与工作流节点问题分开。

为什么不能直接填写 APIMart 的 MCP 地址

APIMart 当前公开文档把 https://panel.apimart.app/mcp 定义为 MCP 端点，调用格式是 JSON-RPC 2.0，工具名称包括 search_apis、get_api_info 和 call_api。这类接口面向 MCP 客户端或能够发送对应 JSON-RPC 请求的程序，并不等同于 Dify 期望的 OpenAI 兼容聊天接口。APIMart REST 访问文档 apimart.app

因此，如果你把 MCP 地址填入 Dify 的 API Base URL，可能出现路径不匹配、请求体格式不匹配或模型字段无法识别。这里不是简单地在地址末尾补上 /v1 就能解决；只有当 APIMart 另有明确的 OpenAI 兼容端点时，才应按该端点的说明配置。

常见报错排查顺序

现象优先检查处理方式
401 或 Invalid API KeyKey 是否复制完整、是否已吊销、Bearer 方式是否正确重新生成或轮换密钥，并确认使用的是模型接口对应的凭证
404 或路径不存在Base URL 是否填成 MCP 地址、是否重复添加请求路径、是否缺少文档要求的版本路径只保留服务方明确给出的基础地址，不能把 MCP 端点改写成聊天接口
Model not found模型 ID 拼写、大小写、版本后缀和可用权限从当前模型详情复制完整 ID，不使用猜测的模型名
余额不足或调用被拒绝账户余额、点数和单次调用成本先查看当前目录或账单信息；具体点数和价格以 APIMart 当前页面为准
超时或空响应上游模型状态、Dify 请求超时、响应格式和模型能力先用最短文本请求测试，再降低上下文长度；若接口仅支持异步任务或 MCP 工具调用，不能按普通聊天模型处理

APIMart 参考文档将 401/403 与无效或已撤销密钥相关的情况分开说明，并指出余额不足的调用会在执行前被拒绝。遇到错误时，先区分“认证失败、地址失败、模型失败、余额失败”，不要直接更换多个参数。APIMart 常见问题 apimart.app

模型类型与计费核对

第一次接入建议只选择文本对话模型。Embedding 用于向量化，Rerank 用于重排序，图像和视频模型通常有不同的请求参数或任务状态，不能因为它们出现在同一个聚合目录中，就假设都能在 Dify 的 LLM 字段里调用。

APIMart 当前公开资料说明其模式是预付点数、按次扣费，并建议在调用前查看目录中的单次价格或使用费用预览能力。文章不替你判断某个模型当前价格，也不把模型名称或价格写死；配置前应以当前目录、模型详情和控制台显示内容为准。APIMart 快速上手与价格核对说明 apimart.app

如果你的目标只是让 Dify 运行聊天工作流，最稳妥的核验链路是：确认兼容端点 → 确认模型 ID → 进行一次最小文本请求 → 再逐步启用流式输出、工具调用和知识库。任何未在当前文档中明确说明的能力，都应标记为“需核实”。

常见问题

APIMart Dify 怎么配置才不会填错地址？

先确认 APIMart 是否提供明确的 OpenAI 兼容模型端点，再把该端点作为 Base URL。当前公开资料明确展示的是 MCP 地址 https://panel.apimart.app/mcp，它是 JSON-RPC/MCP 接口，不应直接填入 Dify 的 OpenAI-API-compatible 配置。

APIMart 的 MCP 地址可以直接填到 Dify 吗？

不建议。MCP 地址面向 Streamable HTTP 和 JSON-RPC 工具调用，而 Dify 的 OpenAI-API-compatible 供应商需要模型名称、API Key 和兼容聊天接口地址。除非 APIMart 当前另有明确的适配文档，否则应视为两种不同接口。

Dify 配置 APIMart 时 Base URL 要不要加 /v1？

不能凭经验决定。是否包含 /v1 必须以 APIMart 当前接口文档或控制台给出的 Base URL 为准；如果资料没有明确说明，应标记为需核实，不要自行拼接。

Dify 报 401，应该先查什么？

先检查 API Key 是否复制完整、是否已经吊销、是否填入了正确的供应商字段，以及该 Key 是否确实用于模型接口。APIMart 文档说明，已吊销或无效密钥会导致认证失败。

图像、视频和 Embedding 模型能直接按 LLM 配置吗？

通常不能直接套用。不同模型类型可能使用不同字段、请求路径和响应结构；第一次配置应先使用文本对话模型，确认连通后，再根据 Dify 与 APIMart 当前文档分别核对其他模型类型。

相关阅读

参考资料

  1. APIMart 快速上手：API Key、MCP 端点与首次调用（apimart.app）
  2. APIMart REST 访问：MCP JSON-RPC 端点与鉴权（apimart.app）
  3. APIMart 接口参考：端点、工具、错误与计费（apimart.app）
  4. APIMart 密钥管理：创建、轮换与吊销（apimart.app）
  5. APIMart 常见问题：点数、API Key 与调用费用（apimart.app）
  6. Dify 官方插件仓库：OpenAI-API-compatible 配置字段
  7. Dify 文档：模型供应商配置与工作区使用（dify-docs.docs7.io）