# How to render images via the API

> A complete worked example — from template to rendered image URL in one request

- **URL**: https://orshot.com/help/render-images-via-api

---

The fastest way to your first API render: open your template's **Playground** (via [Quick Connect](https://orshot.com/help/generate-your-first-image)) and switch to the **REST API** tab — your exact render as a copy-paste request:

![The ready-made API request in the REST API tab](https://orshot.com/help/getting-started/generate-image-4-rest-api.webp)

## The anatomy of a render call```bash
curl -X POST "https://api.orshot.com/v1/studio/render" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "12307",
    "modifications": {
      "headline": "INBOX ZERO IS A MYTH"
    },
    "response": { "type": "url", "format": "png" }
  }'
```- **`templateId`** + **API key** — [where to find both](https://orshot.com/help/find-your-api-key-and-template-id)
- **`modifications`** — your template's [dynamic parameters](https://orshot.com/help/make-your-template-dynamic)
- **`response`** — `url`, `base64` or `binary`; formats `png`, `jpg`, `webp`, `avif`, `pdf` (plus `mp4`, `webm`, `gif` for video templates)

The response contains a URL to your rendered image — [cached for speed](https://orshot.com/help/renders-not-updating-after-template-changes) on repeat calls.

## Related