# Lumenfall

> A unified, OpenAI-compatible API for AI image and video generation that routes requests across 156+ models from major providers with zero markup and automatic failover.

Lumenfall is a unified API routing layer for AI image and video generation, providing a single OpenAI-compatible endpoint to access models from providers including OpenAI, Google, Black Forest Labs, ByteDance, Alibaba, fal.ai, Replicate, Runware, xAI, and Recraft. It is designed for developers who want to integrate multiple generative AI providers without managing separate SDKs, billing accounts, or provider-specific quirks. The platform is actively live with free credits on signup and no credit card required to start.

## What It Is

Lumenfall sits between your application and AI media generation providers, acting as a normalization and routing layer. Developers point their existing OpenAI SDK at `https://api.lumenfall.ai/openai/v1`, swap in a Lumenfall API key, and gain access to the full model catalog — text-to-image, image-to-video, and text-to-video — without changing their code structure. The platform handles parameter translation, async-to-sync bridging, output format conversion, and automatic failover across providers.

## How the Unification Layer Works

Lumenfall addresses three concrete integration problems that arise when working with multiple AI media providers:

- **Size normalization**: Developers send a standard size like `1024x1024`; Lumenfall translates it per model (e.g., `aspect_ratio: "1:1", megapixels: "1"` for fal.ai FLUX Pro).
- **Async-to-sync bridging**: Some providers only expose async job APIs. Lumenfall submits the job, polls with smart backoff for up to 5 minutes, and returns a synchronous response — invisible to the caller.
- **Output format emulation**: If a model only outputs PNG but the caller requests WebP, Lumenfall converts the output. Format, response type (URL or base64), and compression level are all controllable.

## Model Catalog and Provider Coverage

The platform's catalog includes models from OpenAI (GPT Image 2), Google (Gemini 3 Pro Image, Gemini 3.1 Flash Image), Black Forest Labs (FLUX.2 [max]), ByteDance (Seedream 4.5, Seedream 5.0 Lite), Alibaba (Wan 2.6, Qwen Image 2512), Reve AI, Vyro AI, and others. The homepage lists 156+ models accessible through the single endpoint. A model leaderboard and blind voting arena are available for comparing model outputs.

## Infrastructure and Reliability

Lumenfall's production infrastructure is described on the site as spanning 330+ edge locations with approximately 5ms of added overhead per request. Automatic failover routes traffic to the next available provider when one fails, with sub-second detection. The platform claims auto-scaling with no capacity planning required and a pay-per-generation model with no monthly minimums.

## Developer Tooling and Observability

The dashboard renders generated images and videos inline rather than as raw base64 in JSON, and exposes per-request timing broken down by gateway, provider, and response phases. A requests API (`GET /v1/requests`) lets developers pull the same data programmatically — including error codes, per-request cost in USD, model, modality, duration, and status — for use in Slack alerts, internal dashboards, or billing reconciliation. API key management supports multiple named keys with instant rotation and revocation.

## Pricing Model

Lumenfall's stated pricing model charges no platform fee, no subscription, and no markup over official provider rates. The site explains that at scale, volume-based provider margins cover infrastructure costs, while future premium features (analytics, team collaboration, custom fine-tuning, enterprise tools) are planned as an optional subscription. Developers start with a free credit on signup with no credit card required.

## Features
- OpenAI-compatible unified API endpoint
- 156+ AI image and video models from major providers
- Automatic parameter normalization across models
- Async-to-sync API bridging with smart polling
- Output format conversion (PNG, JPEG, WebP, GIF, AVIF)
- Automatic failover across providers
- 330+ edge locations with ~5ms overhead
- Per-request cost and latency observability dashboard
- Inline image and video rendering in dashboard
- Requests API for programmatic log access
- API key management with instant rotation and revocation
- Model leaderboard and blind voting arena
- No markup over official provider rates
- Single wallet and invoice across all providers
- Free credits on signup, no credit card required

## Integrations
OpenAI SDK (JavaScript/Python), OpenAI Python library, cURL, fal.ai, Replicate, Runware, xAI, Alibaba Cloud, BytePlus, Google (Gemini), Recraft, OpenAI, Black Forest Labs

## Platforms
API, WEB

## Pricing
Free

## Links
- Website: https://lumenfall.ai
- Documentation: https://docs.lumenfall.ai/
- Repository: https://github.com/lumenfall-ai
- EveryDev.ai: https://www.everydev.ai/tools/lumenfall