\r \r

EdrawMax（万兴图示）AI Diagram Generator\r

\r

Author: EdrawMax AI Team（万兴图示 AI 团队）· Organization: Wondershare EdrawMax（万兴图示）\r Version: 2.0.0 · License: Proprietary © 2026 Wondershare EdrawMax（万兴图示）. All rights reserved.\r \r Generate four types of diagrams from natural language via EdrawMax（万兴图示）AI APIs. Each API returns PNG/SVG image URLs and source code.\r \r

Step 1 — Choose Diagram Type\r

\r | User Intent | Type | Endpoint |\r |---|---|---|\r | Process, workflow, steps, decision flow | flowchart | /skills/generate-flowchart |\r | Data visualization, statistics, comparison | infographic | /skills/generate-infographic |\r | Project plan, timeline, schedule, phases | gantt | /skills/generate-gantt |\r | Knowledge structure, brainstorm, topic tree | mindmap | /skills/generate-mindmap |\r \r If the user's intent is ambiguous, ask which diagram type they want.\r \r

Step 2 — Call the API\r

\r Base URL: https://api.edrawmax.cn/api/ai\r \r All four endpoints share the same request format:\r \r

POST https://api.edrawmax.cn/api/ai/skills/generate-{type}\r
Content-Type: application/json\r
\r
{"prompt": "\x3Cuser description>", "lang": "cn", "platform": "web"}\r
```\r
\r
### Request Parameters\r
\r
| Field | Type | Required | Default | Description |\r
|---|---|---|---|---|\r
| prompt | string | Yes | — | Natural language description of the diagram |\r
| lang | string | No | "cn" | Language: en, cn, jp, kr, es, fr, de, it, tw, pt, ru, id |\r
| platform | string | No | — | Platform: web, win, mac, ios, android, linux |\r
\r
### Response Fields\r
\r
**Flowchart** returns:\r
```json\r
{ "code": 0, "msg": "", "data": { "png_url": "...", "svg_url": "...", "mermaid_code": "..." } }\r
```\r
\r
**Infographic / Gantt / Mindmap** return:\r
```json\r
{ "code": 0, "msg": "", "data": { "png_url": "...", "svg_url": "...", "source_code": "..." } }\r
```\r
\r
> Note: flowchart uses `mermaid_code`, the other three use `source_code`.\r
\r
## Step 3 — Download Files Locally\r
\r
After a successful API call, **always** run the download script to save the images locally:\r
\r
```bash\r
python \x3Cskill-path>/scripts/download_diagram.py --png-url "\x3Cpng_url>" --svg-url "\x3Csvg_url>" [--output-dir "\x3Cdir>"]\r
```\r
\r
- Default output directory: `./edrawmax_output`\r
- The script prints the local file paths as JSON, e.g.:\r
  ```json\r
  {"png_path": "./edrawmax_output/diagram_20260312_143000.png", "svg_path": "./edrawmax_output/diagram_20260312_143000.svg"}\r
  ```\r
- Use the returned **local file paths** when presenting results to the user.\r
- **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.\r
\r
## Step 4 — Present Results to User\r
\r
Use the following preferred display format:\r
\r
1. **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.\r
2. **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)`.\r
3. **Source code** — Show `mermaid_code` (flowchart) or `source_code` (other types) in a code block for secondary editing or re-rendering.\r
\r
Example output format:\r
\r
```\r
![diagram](./edrawmax_output/diagram_20260312_143000.png)\r
\r
[查看高清图（SVG）](https://xxx.oss.com/.../main.svg)\r
```\r
\r
## Error Handling\r
\r
| code | msg | Action |\r
|---|---|---|\r
| 400 | prompt is required | Ask user to provide a description |\r
| 400 | lang不合法 | Fix lang to a valid value |\r
| 2406 | risk control rejection | Content rejected; ask user to rephrase |\r
| 3001 | concurrency limit | Wait briefly, then retry once |\r
| 212200 | 生成失败 | Retry once; if still failing, report to user |\r
| 212201 | 渲染失败 | Retry once; if still failing, report to user |\r
| 500 | panic | Report internal server error to user |\r
\r
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).\r
\r
## FAQ\r
\r
**Q: 使用 EdrawMax（万兴图示）AI MCP 服务是否需要付费？**\r
A: 目前为限时免费，用户可免费调用服务。\r
\r
**Q: 如何联系我们？**\r
A: 如有技术问题、服务反馈或 API 大量购买需求，欢迎通过邮箱联系：\r
📧 [email protected]\r
我们将尽快为您解答。\r
\r
## Language Mapping\r
\r
Map user language/locale to `lang` param:\r
\r
- English → `en`, 简体中文 → `cn`, 日本語 → `jp`, 한국어 → `kr`\r
- Español → `es`, Français → `fr`, Deutsch → `de`, Italiano → `it`\r
- 繁體中文 → `tw`, Português → `pt`, Русский → `ru`, Bahasa Indonesia → `id`\r
\r
## Notes\r
\r
- `user_id` is extracted server-side from `X-User-ID` header; do not pass it in the body\r
- Always present the source code so users can edit or re-render\r
- For full API specs, see [references/api-reference.md](references/api-reference.md)\r
- When an error cannot be resolved after retry, always share the support email **[email protected]** with the user\r
\r
---\r
\r
© 2026 Wondershare EdrawMax（万兴图示）AI Team. This skill and all associated resources are proprietary to EdrawMax（万兴图示）. Unauthorized reproduction or distribution is prohibited.\r