What do I get back, an image or an editable file?
What do I get back, an image or an editable file?
It depends on the plan. Every diagram is stored as native draw.io XML, so you can keep
editing it with prompts on either plan. Paid gets that XML back in every reply and as a
.drawio export; open it at app.diagrams.net. Free gets an SVG with
a watermark, and replies carry xml: null with a link to that SVG.Is it free?
Is it free?
Yes, with no usage limit. Free costs 20 a month or $120 a year, and adds two things: no watermark,
and the draw.io file. See Plans & pricing.
API, MCP, or SDK, which should I use?
API, MCP, or SDK, which should I use?
Use the MCP server to give an AI agent (Claude, Cursor) the ability to make diagrams in-loop.
Use an SDK (Python or TypeScript) for app and CI code. Use
the REST API directly from any other language.
How is test mode different?
How is test mode different?
dgz_test_ keys have a lower rate limit. They still run real generations on your account, so
they are not a sandbox. See Authentication.Which clouds and diagram types are supported?
Which clouds and diagram types are supported?
AWS, Azure, GCP, and general architecture. Call Meta at runtime for the
authoritative list of providers, diagram types, and export formats.
How do I keep my key safe?
How do I keep my key safe?
Store it in a secret manager, use it server-side only, and never commit it. Keys are shown once,
stored only as a hash, and can be revoked instantly. See Security.
What happens on an error?
What happens on an error?
Can I use my own LLM provider key?
Can I use my own LLM provider key?
No. Bring your own key (BYO) was removed on 9 October 2026, and stored provider keys were
deleted. Every request runs on our models, on both plans.
Do you rate-limit?
Do you rate-limit?
Yes, per key and per IP, and that is the only limit. A
429 means back off and retry. See
Rate limits.