API Reference

curl -X POST https://api.rendrkit.dev/api/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Product launch announcement, dark theme"}'

Authorization: Bearer rk_live_xxxxxxxxxxxxx

{
  "prompt": "Summer sale announcement for clothing brand",
  "size": "1080x1080",
  "style": "bold",
  "heading": "Summer Sale - 40% Off",
  "subheading": "Use code SUMMER40 at checkout",
  "brand": {
    "colors": ["#6D28D9", "#F59E0B"],
    "font": "Inter"
  }
}

{
  "prompt": "Coffee shop weekend special",
  "imageUrl": "https://your-cdn.com/coffee-shop.jpg"
}

{
  "id": "img_abc123",
  "url": "https://cdn.rendrkit.dev/img_abc123.png",
  "width": 1080,
  "height": 1080,
  "prompt": "Instagram post: Launch day announcement, dark theme",
  "style": "modern",
  "templateId": "gradient-hero",
  "createdAt": "2026-01-15T12:00:00Z",
  "attribution": {
    "source": "unsplash",
    "photographer": "John Doe",
    "photographerUrl": "https://unsplash.com/@johndoe",
    "photoUrl": "https://unsplash.com/photos/abc123"
  }
}

{
  "templateId": "magazine-cover",
  "slots": {
    "heading": "Taste Tuscany",
    "subheading": "Opening Saturday at 7pm. Live jazz and free prosecco.",
    "badge_text": "GRAND OPENING",
    "accent_color": "#D4A574"
  },
  "photoQuery": "italian restaurant interior"
}

{
  "templateId": "gradient-hero",
  "slots": {
    "badge_text": "BETA",
    "heading": "Ship Smarter",
    "accent_color": "#8B5CF6",
    "subheading": "AI-powered deployment pipeline. Join the beta March 1.",
    "cta_text": "Join Beta"
  }
}

{
  "templates": [
    {
      "id": "magazine-cover",
      "name": "Magazine Cover",
      "description": "Full-bleed photo with text overlay at bottom-left.",
      "bestFor": "Lifestyle, food, travel, real estate...",
      "needsPhoto": true,
      "slots": [
        { "name": "heading", "required": true, "description": "Main headline" },
        { "name": "subheading", "required": false, "description": "One-line description" },
        { "name": "badge_text", "required": false, "description": "Small label" },
        { "name": "accent_color", "required": false, "description": "Accent color hex" }
      ]
    }
  ],
  "count": 69
}

curl -X POST https://api.rendrkit.dev/api/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "comparison-vs",
    "slots": {
      "title": "React vs Vue",
      "left_icon": "⚛️", "left_name": "React", "left_color": "#61DAFB",
      "left_bg": "#1E293B",
      "left_item1": "Largest ecosystem", "left_item2": "JSX flexibility",
      "left_item3": "Meta backing", "left_item4": "React Native",
      "left_item5": "Server Components",
      "right_icon": "💚", "right_name": "Vue", "right_color": "#42B883",
      "right_bg": "#1E293B",
      "right_item1": "Gentle learning curve", "right_item2": "Template syntax",
      "right_item3": "Built-in state management", "right_item4": "Smaller bundle",
      "right_item5": "Composition API",
      "bg_color": "#0F172A", "title_color": "#F1F5F9", "text_color": "#CBD5E1"
    },
    "size": "1080x1080"
  }'

{
  "id": "img_abc123",
  "url": "https://cdn.rendrkit.dev/img_abc123.png",
  "width": 1080,
  "height": 1080,
  "format": "png",
  "prompt": "Instagram post: Launch day announcement, dark theme",
  "style": "modern",
  "createdAt": "2026-01-15T12:00:00Z"
}

{
  "name": "Acme Corp",
  "colors": ["#6D28D9", "#F59E0B", "#10B981"],
  "font": "Inter",
  "logoUrl": "https://example.com/acme-logo.png"
}

{
  "id": "bk_xyz789",
  "name": "Acme Corp",
  "colors": ["#6D28D9", "#F59E0B", "#10B981"],
  "font": "Inter",
  "logoUrl": "https://example.com/acme-logo.png",
  "createdAt": "2026-01-15T12:00:00Z"
}

[
  {
    "id": "bk_xyz789",
    "name": "Acme Corp",
    "colors": ["#6D28D9", "#F59E0B", "#10B981"],
    "font": "Inter",
    "logoUrl": "https://example.com/acme-logo.png",
    "createdAt": "2026-01-15T12:00:00Z"
  }
]

{
  "id": "bk_xyz789",
  "name": "Acme Corp",
  "colors": ["#6D28D9", "#F59E0B", "#10B981"],
  "font": "Inter",
  "logoUrl": "https://example.com/acme-logo.png",
  "createdAt": "2026-01-15T12:00:00Z"
}

{
  "name": "Acme Corp (Updated)",
  "colors": ["#1E40AF", "#F59E0B"],
  "font": "Poppins",
  "logoUrl": "https://example.com/acme-logo-v2.png"
}

{
  "plan": "free",
  "quota": 50,
  "used": 12,
  "remaining": 38,
  "periodStart": "2026-02-01T00:00:00Z",
  "periodEnd": "2026-02-28T23:59:59Z"
}

{
  "templateId": "product-showcase",
  "size": "1080x1080",
  "items": [
    { "slots": { "heading": "AirPods Pro", "price": "$249", "accent_color": "#3B82F6" } },
    { "slots": { "heading": "HomePod Mini", "price": "$99", "accent_color": "#10B981" } },
    { "slots": { "heading": "Apple Watch", "price": "$399", "accent_color": "#8B5CF6" } }
  ]
}

{
  "images": [
    { "index": 0, "id": "img_abc1", "url": "https://cdn.rendrkit.dev/img_abc1.png", "width": 1080, "height": 1080 },
    { "index": 1, "id": "img_abc2", "url": "https://cdn.rendrkit.dev/img_abc2.png", "width": 1080, "height": 1080 },
    { "index": 2, "id": "img_abc3", "url": "https://cdn.rendrkit.dev/img_abc3.png", "width": 1080, "height": 1080 }
  ]
}

curl -X POST https://api.rendrkit.dev/api/v1/upload \
  -H "Authorization: Bearer rk_live_xxx" \
  -F "file=@photo.jpg"

{
  "url": "https://cdn.rendrkit.dev/uploads/abc123.jpg",
  "filename": "photo.jpg",
  "size": 245760,
  "mimeType": "image/jpeg"
}

{
  "templateId": "gradient-hero",
  "name": "Acme Announcements",
  "defaultSlots": {
    "accent_color": "#6D28D9",
    "details": "ACME INC"
  }
}

{
  "id": "ut_abc123",
  "name": "Acme Announcements",
  "baseTemplateId": "gradient-hero",
  "defaultSlots": { "accent_color": "#6D28D9", "details": "ACME INC" },
  "createdAt": "2026-03-01T12:00:00Z"
}

{
  "url": "https://checkout.stripe.com/c/pay/cs_live_..."
}

{
  "url": "https://billing.stripe.com/p/session/..."
}

{
  "code": "INVALID_PROMPT",
  "message": "Prompt must be between 1 and 2000 characters."
}

curl -X POST https://api.rendrkit.dev/api/v1/generate \
  -H "Authorization: Bearer rk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Instagram post: Launch day announcement, dark theme"}'

import { RendrKit } from '@rendrkit/sdk';

const rk = new RendrKit({ apiKey: 'rk_live_xxx' });

const image = await rk.generate({
  prompt: 'Blog OG image: How to Ship Fast',
});

console.log(image.url);

import { RendrKit } from '@rendrkit/sdk';

const rk = new RendrKit({ apiKey: 'rk_live_xxx' });

// List available templates
const { templates } = await rk.listTemplates();

// Direct render with photo
const image = await rk.generate({
  templateId: 'magazine-cover',
  slots: {
    heading: 'Taste Tuscany',
    subheading: 'Opening Saturday at 7pm',
    badge_text: 'GRAND OPENING',
    accent_color: '#D4A574',
  },
  photoQuery: 'italian restaurant',
});

console.log(image.url);

import requests

resp = requests.post(
    "https://api.rendrkit.dev/api/v1/generate",
    headers={"Authorization": "Bearer rk_live_xxx"},
    json={"prompt": "YouTube thumbnail: 5 AI Tools, bold text"}
)

print(resp.json()["url"])

{
  "mcpServers": {
    "rendrkit": {
      "command": "npx",
      "args": ["-y", "@rendrkit/mcp"],
      "env": {
        "RENDRKIT_API_KEY": "rk_live_xxx"
      }
    }
  }
}

{
  "mcpServers": {
    "rendrkit": {
      "command": "npx",
      "args": ["-y", "@rendrkit/mcp"],
      "env": {
        "RENDRKIT_API_KEY": "rk_live_xxx"
      }
    }
  }
}