GET STARTED

Quick Start

Create an API key, send a render, and get a file back.

Three steps to your first render. Full auth details are in Authentication.

  1. Create an API key in the dashboard under Integrations → API keys.
  2. Call POST /api/v1/render with your template ID and optional layer overrides.
  3. Wait with /wait, stream SSE events, or receive a webhook when the job finishes.

Your API base URL is https://app.jsontoimg.com. Set it once, then call paths under /api/v1.

export JSONTOIMG_BASE_URL="<your-base-url>"   # e.g. the Base URL above
export JSONTOIMG_API_KEY="sk_..."

curl -X POST "$JSONTOIMG_BASE_URL/api/v1/render?wait=60" \
  -H "Authorization: Bearer $JSONTOIMG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"template":"<design-id>","format":"png"}'

?wait=60 blocks until the job is done or failed (max 120). Without it, the call returns 202 and you poll, wait, or subscribe.

Next: import a template, then override layers.