DOCSEARCHbyAlgolia
Submit Docs

BabySea Documentation

website·Indexed 32 days ago

https://babysea.ai

A platform for generative media orchestration featuring BabyChain, a self-hosted canvas studio and durable API for image and video model chains. The documentation covers technical architecture including adaptive provider selection on Databricks, request normalization with JSON Schema and TypeScript, atomic credit settlement via Stripe and Postgres, and regional event spines using Confluent and AWS.

Tokens
35.2K
Snippets
73
Records
240
Agent score
59%

What's inside BabySea

  1. Overview of Image Gallery Starter

    Image Gallery Starter is a one-page Next.js application used to build public creator galleries for hosted generative media. It is designed for deployable image portfolios rather than private dashboards. Key features include hero previews, featured image groups, archive cards, collection stacks, a lightbox for viewing prompt/model/size metadata, and protected image interactions to discourage downloads.

  2. Overview of BabySea AI generation services

    BabySea provides AI image and video generation accessible via a dashboard, Playground, SDK, and public API. The service operates by receiving requests in a BabySea-defined schema and routing them through one or more supported third-party inference providers.

  3. Overview of Ledger Fortress credit settlement primitive

    Ledger Fortress is an open-source (OSS) primitive that integrates Stripe and Supabase to handle credit settlement for asynchronous inference workloads. It establishes a concrete ledger boundary to manage reserves, charges, refunds, idempotency, and recovery. Key capabilities include:

    • Atomic lifecycles for reserves, charges, and refunds.
    • Idempotency for Stripe invoice and checkout webhooks.
    • Use of Supabase Row Level Security (RLS), security definer functions, and immutable ledger rows for data integrity.
    • Crash recovery mechanisms for orphaned reservations and low-balance alerts.

  4. Overview of BabySea Execution Control Plane

    BabySea acts as a unified execution layer for generative media workloads (image and video). It normalizes the differences between various inference providers—such as schemas, defaults, latency, and failure modes—into a single predictable execution contract. The platform handles request validation, provider selection, credit reservation, failover, artifact storage, and result delivery through a consistent API.

  5. Overview of Sherin for FLUX

    Sherin for FLUX is a self-hosted private creative workspace designed for a single owner. It provides a direct interface for Black Forest Labs image generation using the owner's own API keys, domain, and storage. The workspace includes a Studio for generation, a Gallery for outputs, a References manager for assets, and Usage/Profile dashboards for monitoring provider status, quotas, and deployment settings. Access is restricted via Supabase Google OAuth and an owner email allowlist.

  6. Overview of the Generative Media Starter

    The Generative Media Starter is a deployable SaaS baseline designed for BabySea-powered media generation. It provides a complete infrastructure for product builders, including user authentication, a prepaid credit system, and private output storage. It is specifically designed to handle the billing and settlement path (selling credit packs, verifying payments via Stripe, and managing credit reservations/charges) so developers can focus on building their creative interface.

  7. Overview of Sherin for Runway

    Sherin for Runway is a self-hosted private creative workspace designed for a single owner. It provides a direct interface for Runway image and video generation using the owner's own API keys, domain, and storage. The workspace includes a Studio for generation, a Gallery for outputs, a References manager, and Usage/Profile dashboards. Access is secured via Supabase Google OAuth and an owner email allowlist.

  8. Overview of Sherin creative workspace

    Sherin is a self-hosted private creative workspace designed for a single owner. It provides a private dashboard containing a Studio for image generation, a Gallery for outputs, a References manager, and Usage/Profile views. It is intended for users who prefer a deployable workspace over a managed SaaS product, allowing full control over keys, domains, and storage.

  9. Overview of BabySea Execution Control Plane

    BabySea is an execution control plane for generative media that allows developers to send image and video workloads through a single API. It abstracts the complexity of multiple inference providers by managing request validation, provider selection, failover, credit reservation/settlement, execution state, artifact delivery, events, webhooks, and observability.

    Key benefits include:

    • Unified Integration: One API/SDK replaces multiple provider-specific integrations (e.g., Alibaba Cloud, Black Forest Labs, BytePlus, Cloudflare, Fal, OpenAI, Replicate, Runway).
    • Reliability: Built-in circuit breakers and automatic failover. If a provider fails, BabySea can route the workload to another provider without requiring custom recovery logic in the application.
    • Consistent Error Model: Provider-specific errors are mapped into a consistent model for programmatic responses.
    • Observability: Tracks provider selection, latency, success rates, and costs for every workload.

  10. Overview of BabyChain

    BabyChain is an Apache-2.0 licensed, self-hosted canvas studio and durable chain API designed for image and video model workflows. It allows developers to design node-based media chains on a visual canvas and execute them via a product API (POST /api/v1/chains/runs). The system ensures that every output becomes the next input, providing a normalized contract across different model providers (e.g., OpenAI, Google, Runway).

  11. Overview of BabyChain capabilities

    BabyChain is a self-hosted canvas studio, Agentic Workflow planner, and durable API designed for image and video model chains. It allows users to design visual media workflows on a React Flow canvas and execute them via a production-ready API. Key features include:

    • Execution Modes:
      • Self Control: Users manually define models, prompts, and parameters.
      • Agentic Copilot: Amazon Nova suggests the next prompt and fields for user review.
      • Agentic Autopilot: Amazon Nova plans and applies downstream steps automatically.
    • Durable Infrastructure: Uses AWS Aurora to store runs, steps, checkpoints, callbacks, and saved canvases.
    • BYOK Execution: Supports 54 image and video model entries from providers including Alibaba Cloud, Black Forest Labs, BytePlus, Google, OpenAI, and Runway.
    • Storage: Optional output archival to AWS S3 or Vercel Blob.

  12. Understand BabySea infrastructure and data isolation

    BabySea operates three isolated data regions (US, EU, and APAC) with no cross-region data synchronization. All inbound traffic is protected by Cloudflare WAF and DDoS mitigation. API compute is handled by stateless Vercel edge functions, ensuring request data is not persisted between invocations.