公开 API
从文本生成 AI Visio 图，或将 draw.io / 图表 JSON 转为 vsdx、png、svg、drawio。与网站共用积分与引擎。
将 vsdx_YOUR_KEY 替换为「设置 → API Key」中的密钥。使用 Authorization: Bearer vsdx_… 或 x-api-key。
curl -X POST https://vsdx.ai/api/v1/generate \
-H 'Authorization: Bearer vsdx_YOUR_KEY' \
-H 'Content-Type: application/json' \
-d '{
"prompt": "Cloud migration swimlane for finance and engineering",
"diagramType": "swimlane",
"formats": ["vsdx", "png", "drawio"]
}'curl -X POST https://vsdx.ai/api/v1/convert \
-H 'Authorization: Bearer vsdx_YOUR_KEY' \
-H 'Content-Type: application/json' \
-d '{
"drawio": "<mxfile>...</mxfile>",
"formats": ["vsdx", "png"]
}'curl https://vsdx.ai/api/v1/credits \ -H 'Authorization: Bearer vsdx_YOUR_KEY'
| 方法 | 路径 | 积分 | 说明 |
|---|---|---|---|
| POST | /api/v1/generate | 10 | 提示词 → 可编辑图表文件（同步，最长约数分钟）。 |
| POST | /api/v1/convert | 5 | draw.io XML 或 diagram IR → 指定格式。 |
| GET | /api/v1/credits | 免费 | 该 Key 所属账户的剩余积分。 |
| GET | /api/v1/openapi.json | 免费 | OpenAPI 3.1 机器可读文档。 |
| code | 含义 |
|---|---|
| unauthorized | 缺少或无效的 API Key。 |
| insufficient_credits | 积分不足。 |
| invalid_request | 请求体验证失败。 |
| payload_too_large | drawio 超过 2 MB。 |
| rate_limited | 请求过多（每 Key 每分钟 120 次）。 |
| upstream_failed | 渲染或 AI 引擎未能完成。 |
| internal | 服务器内部错误。 |