Documentation

Quick Start

Get started with the Renderful API in minutes. Follow these steps to make your first API request.

1. Get your API Key

Create an API key from the API Keys page. Keep this key secure and never expose it in client-side code.

2. Make your first request

curl -X POST https://api.renderful.ai/api/v1/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "text-to-image",
    "model": "flux-dev",
    "prompt": "A beautiful sunset over mountains"
  }'

3. Handle the response

{
  "id": "gen_abc123",
  "status": "processing",
  "model": "flux-dev",
  "created_at": "2024-01-15T10:30:00Z"
}

Poll the generation status or configure a webhook to be notified when complete.