Skip to Content
GenerationProviders

Providers

Registry

Edge provider selection (supabase/functions/_shared/providers/registry.ts):

EnvProvider
GENERATION_PROVIDER=falfal.ai
GENERATION_PROVIDER=muapiMuAPI (when MUAPI_API_KEY is set)
GENERATION_PROVIDER=mockLocal simulation
FAL_API_KEY set (auto)fal

replicate / custom are stubs that route to mock until implemented — do not use in production.

fal.ai

  • Queue mode with generation-webhook callback URL
  • GENERATION_WEBHOOK_SECRET required in production
  • Output URLs validated against allow-list (SSRF protection)

Adding a provider

  1. Implement GenerationProvider in supabase/functions/_shared/providers/
  2. Register in registry.ts
  3. Add catalog entries in libs/generation-core
  4. Run npm run catalog:sync

UI and features stay unchanged — they only pass logical modelId and parameters.

See ADR docs/adr/0005-generation-multi-provider.md in the monorepo.

Last updated on