---
title: "cURL"
description: "Generate images with the Imejis.io API using cURL. A tested example that POSTs dynamic field overrides to a design and saves the rendered image from the command line."
url: "https://www.imejis.io/apis/curl"
published: "2021-12-24"
---

# cURL

## cURL

Generate an image from a template with a single POST request. Imejis returns the finished image directly, so there are no webhooks and nothing to poll.

Set two environment variables first: `IMEJIS_API_KEY` (from your dashboard) and `IMEJIS_DESIGN_ID` (any design's ID). Then send the fields you want to change as `component.property` pairs, for example `headline.text`.

```bash showLineNumbers title="cURL"
curl -s -o output.jpg \
  -X POST "https://render.imejis.io/v1/$IMEJIS_DESIGN_ID" \
  -H "dma-api-key: $IMEJIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"headline.text": "Hello from Imejis"}'
```

**Override any field.** Each dynamic component exposes keys like `headline.text`, `title.color`, or `image.image`. Send only the ones you want to change, and you can pass several at once. You can find a design's overridable fields in its Share / API panel.

The response is the raw image (`image/jpeg` by default). Save it to disk, pipe it, or stream it straight into an `<img>` tag. Choose the format with `?format=png|jpeg|webp|pdf` (default jpeg) and set JPEG quality with `?quality=1-100`.