Presets

A preset says where the diagram will be used, not what kind of diagram it is. It changes how the agent composes it (shape, words, emphasis, pages) and which download comes first; the prompt’s own words override it. It costs nothing extra: credits are per page as always. The diagram keeps its preset, so every change to it is made for the same destination, until a change names another (preset on revisions, or null for none). Leave it out for a general diagram, exactly as before.

Preset	Made for	Animates	Pages	First download
`docs`	Documentation: accurate and neutral, no headline or call to action	no	one	`image.png`
`blog`	A figure in an article: one point, landscape about 2:1	no	one	`image.png?quality=high`
`social`	A LinkedIn or X post: one idea readable at phone width, 4:5 or square, no call to action	no	one	`image.png?quality=high`; recordings `size=portrait`
`carousel`	A LinkedIn or Instagram carousel: a cover with a hook and a swipe cue, one idea per numbered page (`n / N`), an end card; 4:5, 6 to 12 pages unless the prompt asks for more. The prompt’s own sentences stay on the pages word for word, and a page gets a figure only where it shows structure	no	many	`image.pdf?pages=all`
`ad`	Paid social: a short line, the product largest, brand bottom left and call to action bottom right, a 1:1 master	yes	one	`animation.mp4?size=square`
`data_story`	One chart from real data whose title is the finding, with a small source line	no	one	`image.png?quality=high`
`explainer_video`	An animated explainer composed for 16:9	yes	one	`animation.mp4?size=landscape`

The frames diagramkit lays a diagram out for and the presets that use them: landscape 1920 by 1080 (16:9) for data_story and explainer_video, wide 1920 by 960 (2:1) for blog, square 1080 by 1080 (1:1) for ad, portrait 1080 by 1350 (4:5) for social and carousel, story 1080 by 1920 (9:16) with no default preset, for Shorts, Reels and TikTok. docs and no preset keep the diagram's own shape, 900 px wide on desktop and 390 px on phone. — Each preset lays the diagram out for a frame; the diagram is laid out again for that shape, never cropped. docs keeps its own shape, with desktop and phone layouts.

A job with a preset carries recommended_download, the download its preset offers first, and animation.* without size uses the preset’s frame.

curl https://app.diagramkit.ai/api/v1/diagrams \
  -H "Authorization: Bearer $DIAGRAMKIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "How SSH sets up an encrypted session", "preset": "social", "wait": 180}'

Get started

Diagrams

Guides

More