edrawmax-diagram

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

EdrawMax（万兴图示）AI Diagram Generator

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

Author: EdrawMax AI Team（万兴图示 AI 团队）· Organization: Wondershare EdrawMax（万兴图示） Version: 2.0.0 · License: Proprietary © 2026 Wondershare EdrawMax（万兴图示）. All rights reserved.

Generate four types of diagrams from natural language via EdrawMax（万兴图示）AI APIs. Each API returns PNG/SVG image URLs and source code.

作者: EdrawMax AI 团队（万兴图示 AI 团队）· 组织: 万兴EdrawMax（万兴图示） 版本: 2.0.0 · 版权: 专有版权 © 2026 万兴EdrawMax（万兴图示）。保留所有权利。

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

Step 1 — Choose Diagram Type

步骤1 — 选择图表类型

User Intent	Type	Endpoint
Process, workflow, steps, decision flow	flowchart	`/skills/generate-flowchart`
Data visualization, statistics, comparison	infographic	`/skills/generate-infographic`
Project plan, timeline, schedule, phases	gantt	`/skills/generate-gantt`
Knowledge structure, brainstorm, topic tree	mindmap	`/skills/generate-mindmap`

If the user's intent is ambiguous, ask which diagram type they want.

用户意图	类型	接口地址（Endpoint）
流程、工作流、步骤、决策流	flowchart	`/skills/generate-flowchart`
数据可视化、统计、对比	infographic	`/skills/generate-infographic`
项目计划、时间线、进度安排、阶段	gantt	`/skills/generate-gantt`
知识结构、头脑风暴、主题树	mindmap	`/skills/generate-mindmap`

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

Step 2 — Call the API

步骤2 — 调用API

Base URL:

https://api.edrawmax.cn/api/ai

All four endpoints share the same request format:

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

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

基础URL:

https://api.edrawmax.cn/api/ai

四个接口共享相同的请求格式：

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

{"prompt": "<用户描述>", "lang": "cn", "platform": "web"}

Request Parameters

请求参数

Field	Type	Required	Default	Description
prompt	string	Yes	—	Natural language description of the diagram
lang	string	No	"cn"	Language: en, cn, jp, kr, es, fr, de, it, tw, pt, ru, id
platform	string	No	—	Platform: web, win, mac, ios, android, linux

字段	类型	是否必填	默认值	描述
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

Response Fields

响应字段

Flowchart returns:

json

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

Infographic / Gantt / Mindmap return:

json

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

Note: flowchart uses
mermaid_code
, the other three use
source_code
.

**Flowchart（流程图）**返回：

json

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

**Infographic（信息图）/ Gantt（甘特图）/ Mindmap（思维导图）**返回：

json

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

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

Step 3 — Download Files Locally

步骤3 — 本地下载文件

After a successful API call, always run the download script to save the images locally:

bash

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

Default output directory:
```
./edrawmax_output
```

The script prints the local file paths as JSON, e.g.:

json

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

Use the returned local file paths when presenting results to the user.
Security: The script only accepts
```
https://
```
URLs whose hostname belongs to trusted EdrawMax OSS domains (
```
.aliyuncs.com
```
,
```
.wondershare.com
```
,
```
.edrawsoft.com
```
,
```
.edrawmax.com
```
). TLS certificates are fully verified. URLs from any other host are rejected — do not pass user-supplied or third-party URLs to this script.

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

bash

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

默认输出目录：
```
./edrawmax_output
```

脚本会以JSON格式打印本地文件路径，例如：

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://
```
链接。TLS证书会被完全验证。任何其他主机的链接都会被拒绝——请勿将用户提供的或第三方链接传递给此脚本。

Step 4 — Present Results to User

步骤4 — 向用户展示结果

Use the following preferred display format:

Thumbnail (PNG) — Render the local PNG file as an inline image if the environment supports it (e.g. Markdown
```
![diagram](path/to/diagram.png)
```
). If inline rendering is not supported, show the
```
png_url
```
as a clickable link instead.
High-res diagram (SVG) — Always present the
```
svg_url
```
as a clickable link so the user can open the full-quality vector image in their browser: e.g.
```
[查看高清图](svg_url)
```
.
Source code — Show
```
mermaid_code
```
(flowchart) or
```
source_code
```
(other types) in a code block for secondary editing or re-rendering.

Example output format:

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

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

请使用以下推荐的展示格式：

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

示例输出格式：

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

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

Error Handling

错误处理

code	msg	Action
400	prompt is required	Ask user to provide a description
400	lang不合法	Fix lang to a valid value
2406	risk control rejection	Content rejected; ask user to rephrase
3001	concurrency limit	Wait briefly, then retry once
212200	生成失败	Retry once; if still failing, report to user
212201	渲染失败	Retry once; if still failing, report to user
500	panic	Report internal server error to user

For retryable errors (3001, 212200, 212201), retry up to 1 time before reporting failure. If the error persists, inform the user and share the support contact (see FAQ below).

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

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

FAQ

常见问题（FAQ）

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

Q: 如何联系我们？ A: 如有技术问题、服务反馈或 API 大量购买需求，欢迎通过邮箱联系： 📧 ws-business@wondershare.cn 我们将尽快为您解答。

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

Q: 如何联系我们？ A: 如有技术问题、服务反馈或 API 大量购买需求，欢迎通过邮箱联系： 📧 ws-business@wondershare.cn 我们将尽快为您解答。

Language Mapping

语言映射

Map user language/locale to

lang

param:

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

将用户语言/区域设置映射到

lang

参数：

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

Notes

注意事项

```
user_id
```
is extracted server-side from
```
X-User-ID
```
header; do not pass it in the body
Always present the source code so users can edit or re-render
For full API specs, see references/api-reference.md
When an error cannot be resolved after retry, always share the support email ws-business@wondershare.cn with the user

```
user_id
```
由服务器端从
```
X-User-ID
```
请求头中提取；请勿在请求体中传递
始终展示源代码，以便用户编辑或重新渲染
完整API规范，请查看 references/api-reference.md
当重试后仍无法解决错误时，请务必向用户提供支持邮箱 ws-business@wondershare.cn