Skip to main content
BabySea gives you one API for image and video generation across multiple providers. In this guide, you will sign in, create an API key, verify that key, and send your first generation request.

​
Before you start

After you sign in, the main team workspace navigation includes Metrics, API keys, Webhook, Logs, Credits, Playground, Models, Domains, Settings, Members, Billing, My profile, and Activity.

​
Step 1 - Open your workspace

From https://us.babysea.ai/home, open the account you want to use. What you see:
  • The workspace home page.
  • The left navigation with API keys and the rest of the account tools.
  • The Playground link, which opens a separate page where you can test models in the browser before integrating.

​
Step 2 - Create an API key

Open API keys from the sidebar, then click Create API key. This is the dashboard flow you use before calling any public /v1 route.

​
Step 3 - Verify the key

Use GET /v1/status to confirm your key works before you send generation traffic.
Terminal
curl https://api.us.babysea.ai/v1/status \
  -H "Authorization: Bearer bye_your_api_key"
If the key is valid, BabySea returns a successful response envelope. This route is useful for smoke tests, deployment checks, and secret validation.

​
Step 4 - Send your first generation request

Use POST /v1/generate/image/{model_identifier} to start an image generation job.
Terminal
curl -X POST https://api.us.babysea.ai/v1/generate/image/bfl/flux-schnell \
  -H "Authorization: Bearer bye_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"generation_prompt": "A baby seal on a sunny beach"}'
How the public flow works:
  1. Your app sends a signed request to the BabySea /v1 API.
  2. BabySea authenticates the API key and checks the key scope for the route.
  3. BabySea accepts the generation request and returns a generation_id.
  4. BabySea continues processing the generation asynchronously.

​
Step 5 - Check the result

After you receive the generation_id, fetch the generation record with GET /v1/content/{generation_id}.
Terminal
curl https://api.us.babysea.ai/v1/content/your_generation_id \
  -H "Authorization: Bearer bye_your_api_key"
For application code, you can either:
  • Poll GET /v1/content/{generation_id} until the generation finishes.
  • Configure Webhook in your workspace and let BabySea notify your server.

​
Step 6 - Move from test to integration

For a local or server application, use the official SDK:
TypeScript
import { BabySea } from 'babysea';

const client = new BabySea({
  apiKey: process.env.BABYSEA_API_KEY,
  region: 'us',
});

const result = await client.generate('google/nano-banana', {
  generation_prompt: 'A cute baby seal on the beach',
});

console.log(result.data.generation_id);
See SDK overview for installation and client setup.

​
Next steps

SDK

Install the official TypeScript SDK and call BabySea from code

Models

Review model identifiers and parameter schemas before you integrate