Skip to main content
Everything is Apache 2.0 and self-hostable. The hosted platform at api.oanim.dev provides managed infrastructure so you don’t have to run your own.

​
Platform services

Media Gateway

Multi-provider AI image generation. Currently backed by fal.ai with Runway and other providers planned. Handles routing, cost metering, and usage tracking.

Cloud Rendering

oanim render --cloud sends your composition to hosted infrastructure (Remotion Lambda) and streams back the rendered MP4. No local Chromium or ffmpeg needed.

Authentication

Browser-based OAuth via oanim login. API keys (prefixed anim_) for CI/CD and programmatic access.

Usage & Billing

Pay-as-you-go credits with per-operation cost tracking. New accounts start with 5.00incredits.PurchasemoreviaStripewitha105.00 in credits. Purchase more via Stripe with a 10% bonus on purchases over 50.

​
How it connects

oanim CLI → api.oanim.dev → fal.ai (media generation)
                           → S3 + Remotion Lambda (cloud rendering)
                           → PostgreSQL (usage tracking)
                           → Stripe (billing)

​
Authentication chain

Credentials resolve in this order:
  1. ANIMATE_API_KEY environment variable
  2. ~/.oanim/credentials.yaml (saved by oanim login)
  3. Direct provider key (ANIMATE_FAL_KEY) — bypasses platform, goes direct to fal.ai

​
Rate limits

EndpointLimit
Media gateway (/api/v1/media/*)60 requests/minute per user
Auth endpoints (/api/v1/auth/cli/*)10 requests/minute per IP

​
Free vs Hosted

FeatureSelf-hostedHosted platform
@oanim/core libraryYesYes
oanim init / oanim render (local)YesYes
AI asset generationBring your own fal.ai keyPay-per-use via credits
Cloud renderingRun your own infraoanim render --cloud
Usage trackingN/ABuilt-in dashboard
API keysN/ACreate & manage via CLI

​
Getting started

# Sign in
oanim login

# Check your balance ($5.00 free credits on signup)
oanim usage

# Purchase credits
oanim billing buy --amount 10

# Generate an image
oanim assets gen-image --prompt "dark gradient" --out public/bg.png