Studio Design API

/v1/studio/... are ModelFold Studio resource endpoints: they respond synchronously and do not create async tasks. They use the same API key as the model task endpoints under /api/v1/jobs/.... For full slide-deck generation see ModelFold PPT 1.1, which also covers listing and uploading templates.

Base URL: https://modelfold.ai. Authentication: Authorization: Bearer <API key>.

Custom size for single designs

In Studio, choose "Custom" under "Single design" and enter a width and height or a ratio (for example 3:2 or 21:9). In the editor, click an empty area of the canvas to change the size or lock the ratio.

• Each side 320–4096 px, aspect ratio between 1:4 and 4:1; when you enter a ratio, the long side is 1920 px.
• Existing elements are scaled proportionally and centered, and stay editable.
• PNG / GIF exports use the canvas pixel size; PDF / PPTX keep the page ratio.

There is no API endpoint for generating a single design yet. If you already have a design JSON, render it with the endpoint below; the design's width / height set the output size.

Render a design: POST /v1/studio/render

Renders a design (or one of your templates) to images, optionally in batches with variables.

Field	Type	Description
template_id	string	One of your template IDs (use either this or design)
design	object	A Studio design JSON (use either this or template_id); may set width and height
variables	object	Replaces variables in text for a single render
rows	object[]	Batch: one set of variables per row, up to 100 rows, one image per row
page	integer	Page to render (0-based), default 0
format	string	png (default) or jpg
scale	number	Scale 0.25–2, default 1

Each image costs 1 credit (default price); failures are not charged.

curl -X POST https://modelfold.ai/v1/studio/render \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"template_id": "123", "rows": [{"name": "Alex"}, {"name": "Sam"}], "format": "png"}'
# Returns {"ok":true,"results":[{"ok":true,"url":"https://…/batch-….png"},…],"credits":2,"balance":898}

Related

• ModelFold PPT 1.1: full slide decks, template list and upload
• Async jobs API