REST API

通过我们的 REST API,直接从文本或预编写源生成思维导图、流程图、架构图和时序图。一种认证模型,四种图表类型,全部基于同一简洁的请求结构。

概览

ClipMind REST API允许您通过编程方式从任何文本内容生成专业的思维导图图像。无论您是想创建摘要、可视化想法,还是将思维导图集成到您的应用程序中,我们的API都提供了一个简单而强大的接口来实现。

API基础URL
https://api.clipmind.tech

安全认证

基于JWT的认证通过限时令牌确保对API的安全访问。

图像生成

生成高分辨率PNG图像,支持自定义主题和布局。

AI驱动

利用AI对原始文本进行智能摘要和头脑风暴。

端点

请选择下方的图表类型。每种类型均接受相同的 {text, options} 请求体结构,支持原始模式(预编写源)和摘要模式(AI 从文本生成),并返回渲染后的图像或底层源。

POST/public/mindmaps/image

处理原始文本或Markdown,生成结构化的思维导图图像(PNG)。该过程包括AI摘要和后续的专业渲染。

字段类型必填描述
textstring要转换的原始文本或Markdown内容。
options.themestring颜色主题。可选:iris, neon, amethyst, sunset, ocean, forest, cherry-blossom, volcano, hermes-orange, tiffany-blue, rainbow, premium-black, rose-gold, deep-sea, lavender, champagne, midnight-blue, emerald, china-red, french-flag, german-flag, american-flag, japanese-flag, rose, slate, gold, cyan, indigo, dark-iris, dark-neon, dark-amethyst, dark-sunset, dark-ocean, dark-forest, dark-cherry-blossom, dark-volcano, dark-hermes-orange, dark-tiffany-blue, dark-rainbow, dark-premium-black, dark-rose-gold, dark-deep-sea, dark-lavender, dark-champagne, dark-midnight-blue, dark-emerald, dark-china-red, dark-french-flag, dark-german-flag, dark-american-flag, dark-japanese-flag, dark-rose, dark-slate, dark-gold, dark-cyan, dark-indigo。
options.layoutstring布局类型:思维导图、逻辑图、组织图、树状图、时间线
options.modestring生成模式:摘要、头脑风暴或原始模式。在原始模式下,输入被视为已结构化的 Markdown(标题和列表项),直接渲染而无需 AI;非结构化行将被丢弃。
scalenumber分辨率缩放因子(默认值:2)。
示例请求cURL
curl -X POST https://api.clipmind.tech/public/mindmaps/image \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
    "text": "My MindMap\n- Idea 1\n- Idea 2",
    "options": {
      "theme": "dark",
      "layout": "mindmap",
      "mode": "summarize"
    }
  }' > mindmap.png
POST/public/mindmaps/markdown

处理原始文本以生成思维导图的结构化Markdown表示。适用于使用您自己的工具进行渲染。

字段类型必填描述
textstring要转换的原始文本。
options.modestring生成模式:摘要、头脑风暴或原始模式。在原始模式下,输入被视为已结构化的 Markdown(标题和列表项),直接渲染而无需 AI;非结构化行将被丢弃。
options.languagestring输出语言(例如,english, chinese)。
响应格式JSON
{
  "success": true,
  "data": "# Root Node\n## Child Node 1\n## Child Node 2\n..."
}

快速入门

要开始使用 ClipMind API,您需要从工作区生成一个 API 令牌。该令牌有效期有限,且必须包含在所有 API 请求的 Authorization 标头中。

生成您的 API 令牌