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.
- Create an API key in the dashboard under Integrations → API keys.
- Call
POST /api/v1/renderwith your template ID and optional layer overrides. - 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.