API Reference

The core endpoint for rendering images. Returns a PNG or SVG in under a second.

Render an image

POST/v1/images

Request body

template (required) — Template ID from the library.

size (required) — Dimensions, e.g. "1200x630".

brandKitId (optional) — ID of a saved brand kit.

Example request

curl -X POST https://api.imageclaw.dev/v1/images \
  -H "Authorization: Bearer $IMGCLAW_API_KEY" \
  -d '{
        "template": "blog-gradient-v1",
        "title": "Hello, ImageClaw!",
        "size": "1200x630"
      }'

Response 200

{
  "id": "img_9f2c8a3e",
  "url": "cdn.imageclaw.dev/9f2c/a83e.png",
  "width": <span class="tok-num">1200</span>,
  "height": <span class="tok-num">630</span>,
  "format": "png",
  "cost_ms": <span class="tok-num">124</span>
}

Base URL

All API endpoints are served from https://api.imageclaw.dev.