Renderful AI

Generate AI images and videos using the renderful.ai API. Pay with crypto (Base/Polygon/Solana).

API Base URL

https://api.renderful.ai/v1

Authentication

Get API key from https://renderful.ai/dashboard

# Set as environment variable
export RENDERFUL_API_KEY="rf_your_api_key"

Quick Start

Generate an Image

curl -X POST https://api.renderful.ai/v1/generate \
  -H "Authorization: Bearer $RENDERFUL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-dev",
    "prompt": "a cat astronaut floating in space, cinematic lighting",
    "width": 1024,
    "height": 1024,
    "steps": 28
  }'

Generate a Video

curl -X POST https://api.renderful.ai/v1/generate \
  -H "Authorization: Bearer $RENDERFUL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-1.6",
    "prompt": "a serene mountain landscape at sunset, camera slowly panning",
    "duration": 5,
    "width": 1280,
    "height": 720
  }'

Available Models

Image Models

Model	Description	Best For
flux-dev	FLUX.1 Dev	General purpose, high quality
flux-schnell	FLUX.1 Schnell	Fast generation
flux-pro	FLUX.1 Pro	Highest quality
sdxl	Stable Diffusion XL	Classic diffusion
gemini-3	Gemini 3 Pro Image	Google image gen
grok-imagine	Grok Imagine	X/Twitter integration
seedream	Seedream 4.5	Asian aesthetic
reve	Reve Image	Artistic styles

Video Models

Model	Description	Duration
kling-1.6	Kling 1.6	Up to 10s
kling-1.5	Kling 1.5	Up to 10s
veo-3	Google Veo 3	Up to 8s
veo-2	Google Veo 2	Up to 8s
seedance	Seedance 1.5	Up to 10s
wan-2.5	Wan 2.5	Up to 10s
ltx	LTX Video	Up to 10s
omnihuman	OmniHuman	Portrait videos

Image Generation Options

{
  "model": "flux-dev",
  "prompt": "required - your image description",
  "negative_prompt": "optional - what to avoid",
  "width": 1024,
  "height": 1024,
  "steps": 28,
  "seed": 42,
  "format": "png"
}

Video Generation Options

{
  "model": "kling-1.6",
  "prompt": "required - your video description",
  "duration": 5,
  "width": 1280,
  "height": 720,
  "fps": 24,
  "seed": 42
}

Check Generation Status

curl https://api.renderful.ai/v1/status/{task_id} \
  -H "Authorization: Bearer $RENDERFUL_API_KEY"

Response Format

{
  "task_id": "rf_abc123",
  "status": "completed",
  "url": "https://cdn.renderful.ai/generated/abc123.png",
  "expires_at": "2026-02-02T12:00:00Z"
}

Pricing

Pay with USDC on Base, Polygon, or Solana. Check current rates at https://renderful.ai/pricing

x402 Integration

Renderful supports x402 payments for agent autonomy:

# Agent can pay directly without human approval
export RENDERFUL_X402_WALLET="your_agent_wallet"
export RENDERFUL_PREFER_X402="true"

Error Handling

Status	Meaning
200	Success
402	Payment required (x402 flow)
429	Rate limit
500	Generation failed

Examples

Simple Image

curl -X POST https://api.renderful.ai/v1/generate \
  -H "Authorization: Bearer $RENDERFUL_API_KEY" \
  -d '{"model":"flux-dev","prompt":"a cute cat","width":512,"height":512}'

Video with Specific Settings

curl -X POST https://api.renderful.ai/v1/generate \
  -H "Authorization: Bearer $RENDERFUL_API_KEY" \
  -d '{
    "model": "kling-1.6",
    "prompt": "underwater coral reef, fish swimming, sunlight rays",
    "duration": 5,
    "width": 1920,
    "height": 1080
  }'

Tips

• Use detailed prompts for better results
• Include style descriptors ("cinematic", "photorealistic", "anime")
• Negative prompts help avoid unwanted elements
• Check status for video generation (takes 30-120s)