What do I get back, an image or an editable file?
What do I get back, an image or an editable file?
Both. Every diagram is native draw.io XML you can open and edit at
app.diagrams.net, and you can export SVG. It is not a flat image,
so an agent or a person can keep editing it.
Is it free?
Is it free?
Reads and the prompt helpers are free. Generate, edit, fix, re-layout, and fork cost credits.
Every billable response returns a
usage block. See Billing.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.
Does test mode cost credits?
Does test mode cost credits?
Yes.
dgz_test_ keys bill the same credits as a live key, at lower rate limits. Use them to
validate an integration, not to avoid spend. 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?
Do you rate-limit?
Do you rate-limit?
Yes, per key and per IP. A
429 means back off and retry. See Rate limits.