开放 API 现已上线。通过 API 将 Markdown 转换为图片,每月 50 次带水印免费调用。

自动化

给 Dify 加一个 Markdown 转图片工具

导入一份 OpenAPI schema,你的 Dify Agent 和工作流就能自行把 Markdown 渲染成图片——不用写代码节点,也不用自己托管服务。

用途

大家用它来做什么

01

让 Agent 直接把自己的 Markdown 回答变成可分享的卡片,中间不需要额外的人工步骤。

02

在工作流里把检索到的文档渲染成图片,产出报告式或幻灯片式的结果。

03

让知识库机器人用图片返回排版好的表格和图表,而不是丢出一堆原始 Markdown。

接入

接入 Dify

  1. 01

    在「个人中心 → API tokens」创建令牌。它以 mti_ 开头,且只显示一次。

  2. 02

    在 Dify 中打开「工具 → 自定义 → 创建自定义工具」。

  3. 03

    在 schema 字段切换到「从 URL 导入」,填入这个地址。Dify 会自行拉取 OpenAPI 文档并列出 generate_image。

    https://markdowntoimage.com/api/v1/openapi.json
  4. 04

    认证方式选 API Key,类型选 Bearer,值填你的 mti_ 令牌。

  5. 05

    保存后,generate_image 就会出现在该工作空间的所有 Agent、Chatflow 和工作流节点中。

主题、字体、代码样式、PDF 页面尺寸等全部参数,都列在 API 文档.

常见问题

技术支持
Q1

为什么不能直接导入 /api/v1/schema 这个地址?

那个接口返回的是精简的工具描述,不是 OpenAPI 文档,而 Dify 的导入器要求 OpenAPI 3.x。请改用 /api/v1/openapi.json——同一个接口,只是换成了 Dify 能解析的格式。
Q2

Dify 的哪些功能能用这个工具?

凡是能调用自定义工具的地方都可以:Agent、Chatflow,以及工作流里的工具节点。保存后它会出现在整个工作空间的工具选择列表里。
Q3

能让 Agent 自己决定输出格式吗?

可以。schema 把 format 声明为 png、jpeg、webp、pdf 的枚举,模型可以根据用户诉求自行选择。不传则默认 png。
Q4

生成的文件存在哪里?

接口返回的是托管链接。如果你需要把文件存到自己的空间,可以在工作流的下一步下载它,或者把 mode 设为 binary 直接拿到字节流,自行写入任意位置。
Dify Markdown 转图片 | 自定义工具接入 | MarkdownToImage