Quickstart
Create a key, submit a generation, and fetch the result.
API basics
Regional base URLs, authentication, endpoints, envelopes, and rate limits.
Generations
Create, track, cancel, delete, and list image and video generations.
TypeScript SDK
Use the official client for retries, typed responses, and webhook
verification.
Webhooks
Receive, verify, and process signed generation and credit events.
Playground
Test models in the browser without writing setup code.
What BabySea gives you
| Capability | What it means |
|---|---|
| Unified schema | Common fields such as generation_prompt, generation_ratio, generation_input_file, and generation_provider_order work across supported models. |
| Provider routing | Requests use generation_provider_order for the selected model. Failed inference providers can be skipped and retried through the chain. |
| Standard responses | Success responses include status, request_id, message, timestamp, and data. Error responses include status, request_id, and error. |
| Credit accounting | One credit equals $1 USD. Credits are reserved before generation, charged on success, and refunded on failure or eligible cancellation. |
| Operational tools | Metrics, playground, models, API keys, webhooks, logs, credits, notifications, domains, members, settings, billing, and activity are managed from the dashboard. |
Core API flow
Create an API key
Create a key from the dashboard and choose a preset such as
Generate Only,
Read Only, or Full Access.Submit a generation
Call
POST /v1/generate/image/{model_identifier} or POST /v1/generate/video/{model_identifier} with a Bearer key.Track the job
Use
GET /v1/content/{generation_id} to poll, or subscribe to
webhook events for asynchronous delivery.Regions
| Region value | Base URL | SDK value |
|---|---|---|
us | https://api.us.babysea.ai/v1 | us |
eu | https://api.eu.babysea.ai/v1 | eu |
jp | https://api.jp.babysea.ai/v1 | jp |
API keys are region-specific. Use the API hostname that matches the region
where the key was created.