edrawmax-diagram

EdrawMax（万兴图示）AI 图表生成器

作者： EdrawMax AI Team（万兴图示 AI 团队）· 组织： Wondershare EdrawMax（万兴图示） 版本： 2.0.0 · 许可证： 专有软件 © 2026 Wondershare EdrawMax（万兴图示）。保留所有权利。

通过 EdrawMax（万兴图示）AI API，根据自然语言生成四种类型的图表。每个 API 都会返回 PNG/SVG 图片 URL 和源代码。

步骤 1 — 选择图表类型

用户意图	类型	端点
流程、工作流、步骤、决策流程	flowchart	/skills/generate-flowchart
数据可视化、统计、比较	infographic	/skills/generate-infographic
项目计划、时间线、日程安排、阶段	gantt	/skills/generate-gantt
知识结构、头脑风暴、主题树	mindmap	/skills/generate-mindmap

如果用户的意图不明确，请询问他们想要哪种图表类型。

步骤 2 — 调用 API

基础 URL： https://api.edrawmax.cn/api/ai

所有四个端点都使用相同的请求格式：

POST https://api.edrawmax.cn/api/ai/skills/generate-{type}
Content-Type: application/json

{"prompt": "<user description>", "lang": "cn", "platform": "web"}

请求参数

字段	类型	必填	默认值	描述
prompt	string	是	—	图表的自然语言描述
lang	string	否	"cn"	语言：en、cn、jp、kr、es、fr、de、it、tw、pt、ru、id
platform	string	否	—	平台：web、win、mac、ios、android、linux

响应字段

Flowchart 返回：

{ "code": 0, "msg": "", "data": { "png_url": "...", "svg_url": "...", "mermaid_code": "..." } }

Infographic / Gantt / Mindmap 返回：

{ "code": 0, "msg": "", "data": { "png_url": "...", "svg_url": "...", "source_code": "..." } }

注意：flowchart 使用 mermaid_code，其他三种使用 source_code。

步骤 3 — 在本地下载文件

API 调用成功后，务必运行下载脚本，将图片保存到本地：

python <skill-path>/scripts/download_diagram.py --png-url "<png_url>" --svg-url "<svg_url>" [--output-dir "<dir>"]

• 默认输出目录：./edrawmax_output
• 脚本会以 JSON 格式输出本地文件路径，例如：

  {"png_path": "./edrawmax_output/diagram_20260312_143000.png", "svg_path": "./edrawmax_output/diagram_20260312_143000.svg"}
  

• 向用户展示结果时，请使用返回的本地文件路径。
• **安全性：**该脚本仅接受主机名属于受信任 EdrawMax OSS 域名（.aliyuncs.com、.wondershare.com、.edrawsoft.com、.edrawmax.com）的 https:// URL。TLS 证书会经过完整验证。来自任何其他主机的 URL 都会被拒绝 — 不要将用户提供的 URL 或第三方 URL 传递给此脚本。

步骤 4 — 向用户展示结果

优先使用以下展示格式：

1. 缩略图（PNG） — 如果环境支持，请将本地 PNG 文件作为内嵌图片显示（例如 Markdown ![diagram](path/to/diagram.png)）。如果不支持内嵌显示，请将 png_url 显示为可点击链接。
2. 高清图表（SVG） — 始终将 svg_url 显示为可点击链接，以便用户在浏览器中打开完整质量的矢量图片，例如：[查看高清图](svg_url)。
3. 源代码 — 将 mermaid_code（flowchart）或 source_code（其他类型）放在代码块中，供用户进行二次编辑或重新渲染。

输出格式示例：

![diagram](./edrawmax_output/diagram_20260312_143000.png)

[查看高清图（SVG）](https://xxx.oss.com/.../main.svg)

错误处理

code	msg	操作
400	prompt is required	请用户提供描述
400	lang不合法	将 lang 修正为有效值
2406	risk control rejection	内容被拒绝；请用户改写
3001	concurrency limit	稍等片刻，然后重试一次
212200	生成失败	重试一次；如果仍然失败，请告知用户
212201	渲染失败	重试一次；如果仍然失败，请告知用户
500	panic	告知用户发生内部服务器错误

对于可重试的错误（3001、212200、212201），报告失败前最多重试一次。如果错误仍然存在，请告知用户，并提供支持联系方式（见下方常见问题）。

常见问题

问：使用 EdrawMax（万兴图示）AI MCP 服务是否需要付费？ 答：目前为限时免费，用户可免费调用服务。

问：如何联系我们？ 答：如有技术问题、服务反馈或大量购买 API 的需求，欢迎通过邮箱联系： 📧 [email protected] 我们将尽快为您解答。

语言映射

将用户的语言/区域设置映射到 lang 参数：

• English → en，简体中文 → cn，日本語 → jp，한국어 → kr
• Español → es，Français → fr，Deutsch → de，Italiano → it
• 繁體中文 → tw，Português → pt，Русский → ru，Bahasa Indonesia → id

注意事项

• user_id 从服务器端的 X-User-ID 标头中提取；请勿在请求正文中传递
• 始终提供源代码，方便用户编辑或重新渲染
• 完整 API 规范请参阅 references/api-reference.md
• 重试后仍无法解决错误时，务必向用户提供支持邮箱 [email protected]

---

© 2026 Wondershare EdrawMax（万兴图示）AI Team。本技能及所有相关资源均为 EdrawMax（万兴图示）的专有内容。未经授权，禁止复制或分发。