Skip to main content
DiagramAI can create a new diagram or modify the diagram currently open in the editor. Submit a prompt, attach supported source files, or use both.

​
Choose a diagram type

Use Auto detect when the source or prompt makes the intended format clear. Select a type when you need a specific notation. Auto detect is not a fourteenth type. A manual choice locks the requested type.

​
Attach source material

Images

Upload PNG, JPEG, or WebP. DiagramAI extracts visible nodes, labels, relationships, and layout.

API and data

Use OpenAPI JSON or YAML and SQL schemas to create API architecture or ER diagrams.

Infrastructure

Use Docker Compose, Kubernetes, or Terraform files to show services, resources, and dependencies.

CI and ZIP

Use CI workflow files directly or package supported multi-file sources in one ZIP.
The attachment button accepts up to 10 non-ZIP files of the same source family. With an attachment, the prompt can be empty. A prompt takes priority when you need a particular scope or presentation.

​
File limits

  • Up to 10 attachments per request
  • Up to 10 MB for one image
  • Up to 5 MB for one text source file
  • Up to 10 MB combined for non-ZIP attachments
  • One ZIP per request, and the ZIP must be the only attachment
  • ZIP limit: 10 MB compressed, 50 MB extracted, and 500 entries
ZIP extraction rejects encrypted archives, nested archives, absolute paths, path traversal, symbolic links, device files, abnormal compression ratios, and other unsafe entries. DiagramAI never installs dependencies, runs builds, executes infrastructure tools, starts CI jobs, or executes user code from an attachment.

​
Structure your prompt

A useful prompt usually contains:
  1. The diagram type and purpose
  2. Components, participants, or source scope
  3. Order, relationships, or boundaries
  4. Important branches and exceptions
  5. Labels that must appear
Keep product and domain names consistent. When using attachments, state which namespace, tag, module, table group, or workflow should be emphasized.

​
How DiagramAI executes the request

DiagramAI first identifies the source and your intended change:
  • A presentation edit preserves semantics, topology, and coordinates.
  • An incremental edit changes a limited part of the structure and applies local layout when needed.
  • A full generation handles a new diagram, type conversion, major restructuring, or explicit redesign.
Text-based source entities and relationships remain authoritative. DiagramAI does not ask separate model candidates to invent different source structures. Before delivery, the result passes document structure and rendering checks. Depending on the path, it can also receive layout and visual checks for overlap, labels, hierarchy, and connector readability.

​
Create a new diagram

1

Choose the destination

Open the folder where the diagram should be stored, or stay at the workspace root.
2

Open AI generation

Select AI generate, choose a diagram type if needed, and write a prompt or attach source material.
3

Review source choices

If a ZIP contains several supported source families, choose the primary source. Large or ambiguous inputs can also require a scope choice.
4

Submit and review

Follow the displayed processing stages. DiagramAI creates the file and opens the editable result.

​
Modify the current diagram

Open the AI panel inside the editor and describe the change in relation to the existing diagram.
If the current diagram is not empty and the request does not clearly say whether to replace, merge, or create a new result, DiagramAI asks before applying the change.

​
Credit usage

  • Uploading, hashing, and deterministic parsing do not consume credits.
  • DiagramAI checks whether the available balance can cover the AI request.
  • A successful request consumes credits based on actual token usage.
  • A failed or canceled request does not consume credits.
  • Personal-workspace requests use the personal balance.
  • Team-workspace requests use the organization’s shared balance.
See Plans, credits, and billing for included balances and purchase rules.
AI output can be incomplete or inaccurate. Review a diagram before relying on it for implementation, operations, security, or other important decisions.