# Renderful AI API (Agent Quickstart)

> Agent-native API for image, video, audio, and 3D generation.

## Base URLs

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

## Authentication

1. API key auth (recommended):
- Header: `Authorization: Bearer rf_...`

2. x402 payment auth (permissionless):
- Header: `x-payment: <base64-encoded x402 payload>`
- Used on `POST /api/v1/generations`

## Core Agent Endpoints

- `POST /api/v1/agents/register`
- `POST /api/v1/agents/deposit`
- `GET /api/v1/agents/balance`
- `POST /api/v1/agents/quote`
- `PATCH /api/v1/agents/webhook`
- `POST /api/v1/generations`
- `GET /api/v1/generations/{id}`
- `GET /api/v1/models`

## Register Agent

```http
POST https://api.renderful.ai/api/v1/agents/register
Content-Type: application/json

{
  "agent_name": "MyAgent",
  "webhook_url": "https://example.com/webhook",
  "source": "directory",
  "agent_platform": "openclaw",
  "agent_version": "1.0.0"
}
```

## Generate Content

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

{
  "type": "text-to-image",
  "model": "flux-dev",
  "prompt": "A cinematic shot of a futuristic city at sunset"
}
```

Response includes:
- `id`
- `status` (queued)
- `poll_url`

Poll status:

```http
GET https://api.renderful.ai/api/v1/generations/{id}
Authorization: Bearer rf_your_api_key
```

## Deprecated Aliases

- `/api/v1/predictions/{taskId}/result` -> use `/api/v1/generations/{id}`
- `/v1/*` -> use `/api/v1/*`

## Contact

- support@renderful.ai