Quickstart

Render your first image with a single POST request. No SDK required—just your favourite HTTP client.

1. Get your API key

Sign up at imageclaw.dev to get a free API key. Set it as an environment variable:

.env
IMGCLAW_API_KEY=ic_key_abc123def456

2. Make your first request

Choose a template from the library and send your fields:

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

3. Use the response

The API returns a signed URL to your rendered image:

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>
}

That’s it! You’ve rendered your first image. Check the API Reference for advanced usage.