Render multiple sizes in one call

Need a Story, a Square, and an OG image from one design? extraSizes renders them all in a single call. Where size replaces the output, extraSizes is purely additive — your normal render is unchanged, and each output gains an extraSizes array beside it.

Pass an array of sizes:

curl -X POST "https://api.orshot.com/v1/studio/render" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "1227",
    "response": {
      "type": "url", "format": "png",
      "extraSizes": ["1080x1920", "1080x1080", "1200x630"]
    }
  }'

…or a named object, when you want a label to route on:

"extraSizes": { "story": "1080x1920", "square": "1080x1080" }

Each extra size comes back nested beside your render — self-describing its size, width, height, and content URL (and name, for a named object). On multi-page templates, every page carries its own extraSizes.

Related#