Render at other sizes

One template can render at any size. JamFrame lays the design out again for the new size, so you don’t design a story and a banner by hand. Ask for one size with response.size, or several sizes in one call with response.sizes.

To save sizes on a template and adjust their layout in the editor, see Smart Resize in the editor.

One size

Add size to response:

curl https://api.jamframe.com/v1/render \
  -H "Authorization: Bearer $JAMFRAME_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "clx8m2k3p0001abcd1234efgh",
    "modifications": { "title": "Summer sale ends Sunday" },
    "response": { "format": "png", "size": "story" }
  }'

const res = await fetch("https://api.jamframe.com/v1/render", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.JAMFRAME_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    templateId: "clx8m2k3p0001abcd1234efgh",
    modifications: { title: "Summer sale ends Sunday" },
    response: { format: "png", size: "story" },
  }),
});
const { data } = await res.json();
console.log(data.content); // a 1080 × 1920 image

import os
import requests

res = requests.post(
    "https://api.jamframe.com/v1/render",
    headers={"Authorization": f"Bearer {os.environ['JAMFRAME_API_KEY']}"},
    json={
        "templateId": "clx8m2k3p0001abcd1234efgh",
        "modifications": {"title": "Summer sale ends Sunday"},
        "response": {"format": "png", "size": "story"},
    },
)
print(res.json()["data"]["content"])  # a 1080 x 1920 image

Every page renders at that size. The answer has the same shape as any render. size works with PNG, JPEG, WebP and PDF, with async, and in signed URLs.

What a size can be

JamFrame reads size in this order:

1. A size saved on the template. Use its id from GET /v1/designs/{id}. You get the layout as you adjusted it in the editor.
2. original: the template’s own size.
3. Width and height, written WIDTHxHEIGHT, such as "1200x630". Each side can be 16 to 10000 px. × works in place of x.
4. A size name or a preset id, from the tables below.
5. The name of a saved size, such as "Web banner". Upper and lower case don’t matter.

If the template has a saved size with the same width and height as the size you ask for, JamFrame uses the saved one, with your adjustments. Otherwise it makes the layout itself: backgrounds and photos fill the new page, things on an edge stay on that edge, and the rest is scaled and centred.

A size that matches none of these is a 400. Its message lists the template’s saved sizes.

Size names

Preset ids

These are the sizes in the editor’s size menu. Upper and lower case don’t matter.

Several sizes in one call

Send a list in response.sizes:

{
  "templateId": "clx8m2k3p0001abcd1234efgh",
  "modifications": { "title": "Summer sale ends Sunday" },
  "response": { "format": "png", "sizes": ["original", "story", "square", "1200x630"] }
}

content then has one entry per size, in the order you asked:

{
  "data": {
    "content": [
      { "size": "original", "name": "Original", "width": 1080, "height": 1350, "pages": [1], "url": "https://cdn.jamframe.com/renders/…-s1.png?Expires=…" },
      { "size": "story", "name": "Story / Reel", "width": 1080, "height": 1920, "pages": [1], "url": "https://cdn.jamframe.com/renders/…-s2.png?Expires=…" },
      { "size": "square", "name": "Square", "width": 1080, "height": 1080, "pages": [1], "url": "https://cdn.jamframe.com/renders/…-s3.png?Expires=…" },
      { "size": "1200x630", "name": "1200×630", "width": 1200, "height": 630, "pages": [1], "url": "https://cdn.jamframe.com/renders/…-s4.png?Expires=…" }
    ],
    "expiresAt": "2026-11-14T12:05:00.000Z",
    "type": "url",
    "format": "png",
    "pages": [1],
    "credits": 4,
    "renderId": "clx8n0q1r0007abcd1234efgh",
    "responseTime": 5120
  }
}

Rules for sizes:

• Ask for 1 to 10 sizes.
• One call renders at most 30 pages in all: pages × sizes. A 3-page carousel in 10 sizes is 30, which is fine. A 5-page carousel in 7 sizes is 35, which is a 400.
• List each size once. Two values that end up the same size, such as story and 1080x1920, are a 400.
• sizes can’t go with size, async or "type": "base64".
• The call works or fails as a whole. If one size fails, nothing is charged.

For more sizes or pages than that, send one request per size with response.size, with async if you like.

See a template’s saved sizes

GET /v1/designs/{id} lists the sizes saved on the template, in sizes:

{
  "design": {
    "id": "clx8m2k3p0001abcd1234efgh",
    "name": "Summer sale",
    "sizes": [
      { "id": "story", "name": "Story / Reel", "width": 1080, "height": 1920 },
      { "id": "landscape", "name": "Landscape 1.91:1", "width": 1200, "height": 630 }
    ]
  }
}

Send an id as response.size to use that saved layout. You can still ask for any size that isn’t saved.

Style keys at another size

Modification keys apply after the new layout. So x, y, width and height are in the new size’s pixels. A layer at "title.x": 100 sits 100 px from the left of the story, not of the original.

Credits and limits

• One credit per page per size. A 3-page carousel in 2 sizes costs 6 credits.
• Each page, at each size, can be at most 36 megapixels (width × height × scale²).

See Credits.

Related

• Save sizes and fix their layout by hand: Smart Resize in the editor.
• Every other render option: Render images and PDFs.
• Sizes in a public link: the _size parameter of a dynamic URL.