# Renderful AI API

> AI-powered image, video, and 3D generation API with crypto payments

## Overview

Renderful provides a comprehensive API for AI agents to generate:
- **Images**: Text-to-image, image-to-image with 20+ models (Flux, SDXL, Ideogram, Recraft, etc.)
- **Videos**: Text-to-video, image-to-video with Hailuo, Kling, Luma, Runway, Pika
- **3D Models**: Text-to-3D, image-to-3D with Meshy, Tripo, Rodin
- **Audio**: Lip-sync video generation

## For AI Agents

Renderful supports AI agent authentication via `rf_` prefixed API keys with USDC cryptocurrency payments on Base, Polygon, and Ethereum mainnet.

### Quick Start

1. Register your agent:
```
POST https://renderful.ai/api/v1/agents/register
Content-Type: application/json

{"agent_name": "MyAgent", "webhook_url": "https://example.com/webhook"}
```

2. Deposit USDC to the provided treasury address on Base, Polygon, or Ethereum

3. Submit your deposit transaction:
```
POST https://renderful.ai/api/v1/agents/deposit
Authorization: Bearer rf_your_api_key
Content-Type: application/json

{"chain": "base", "tx_hash": "0x..."}
```

4. Generate content:
```
POST https://renderful.ai/api/v1/generations
Authorization: Bearer rf_your_api_key
Content-Type: application/json

{"type": "text-to-image", "model": "flux-1.1-pro", "prompt": "A futuristic city"}
```

## Endpoints

- `POST /api/v1/agents/register` - Create agent account, get API key
- `POST /api/v1/agents/deposit` - Submit USDC payment for verification
- `GET /api/v1/agents/balance` - Check balance and usage
- `POST /api/v1/agents/quote` - Get cost estimate before generating
- `PATCH /api/v1/agents/webhook` - Configure webhook notifications
- `POST /api/v1/generations` - Create image/video/3D/audio generation

## Pricing

- 1 credit = $0.02 USD
- Images: 1-10 credits depending on model and resolution
- Videos: 10-50 credits depending on model and duration
- 3D Models: 15-40 credits depending on model

## Payment

- **Asset**: USDC (USD Coin)
- **Chains**: Base, Polygon, Ethereum mainnet
- **Method**: Deposit to treasury address, then verify via API
- **x402 Support**: Include `X-Payment-Proof: chain:txHash` header for inline payments

## Documentation

- API Docs: https://api.renderful.ai/docs
- OpenAPI Spec: https://api.renderful.ai/api/v1/openapi.json

## Contact

- Website: https://renderful.ai
- Support: support@renderful.ai