Skip to main content

​
Prerequisites

Before adding a custom domain, make sure you:
  • Have an active Enterprise plan (monthly or yearly).
  • Are signed in to the dashboard.
  • Have the Owner or Primary Owner role on the account. Members can view the page but cannot manage domains.
  • Have access to your domain’s DNS settings to create a CNAME record.

​
Domains table

Navigate to Domains in the sidebar. The table shows all domains associated with your account:
ColumnDescription
TypeDefault API endpoint or Custom Domain
DomainThe domain name with a copy button
API URLFull API base URL (https://{domain}/v1) with a copy button
StatusCurrent domain status badge
CreatedDate the domain was added
Every account has a default API endpoint row that cannot be removed. Custom domains appear as additional rows.

​
Step by step

1

Open Domains

Navigate to Domains in the sidebar.
2

Click Custom domain

Click the Custom domain button in the top right corner of the page. A dialog opens with one field.
If the button is disabled, the tooltip explains why. Current dashboard messages are You do not have permission to manage domains, Upgrade to Enterprise plan to add a custom domain, and Custom domain already configured.
3

Enter your domain

Type the domain you want to use for API traffic in the Domain field:
api.yourcompany.com
The page accepts a lowercase domain between 4 and 253 characters.
4

Click Add

Click Add to register the domain. BabySea assigns the required CNAME target and adds the row with pending status.If creation succeeds, the page shows the success toast Custom domain added - configure DNS to activate.
5

Configure DNS

Open the domain row actions menu and click Setup and verify. The dialog shows the DNS record you need to create at your DNS provider:
FieldValue
TypeCNAME
NameYour domain (e.g. api.yourcompany.com)
ValueThe Value shown in the dialog
Each field has a copy button. Create this CNAME record at your DNS provider.
6

Verify DNS

After creating the CNAME record, click Verify DNS in the setup dialog. BabySea checks your DNS configuration and SSL certificate status.Verification can return one of these results:
ResultWhat it means
Domain is active or verified successDNS is correct and SSL is ready
DNS not configured - add the required CNAME recordThe CNAME is not pointing correctly yet
Generating SSL Certificate…DNS is correct but certificate issuance is still in progress
Failed to check domain statusRetry verification later
Domain verification in progress - SSL may still be generating. Try again shortly.Verification is still settling; wait and retry

​
After verification

Once verified, the row status changes from pending to active. You can then use the custom API URL shown in the table:
Terminal
curl -X POST https://api.yourcompany.com/v1/generate/image/bfl/flux-schnell \
  -H "Authorization: Bearer bye_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"generation_prompt": "A baby seal plays in Arctic"}'
Both your custom domain and the default endpoint remain active. Existing integrations using the default endpoint continue to work.

​
DNS propagation

DNS changes can take time to propagate. If verification reports that DNS is not configured, wait for propagation and try again. The dashboard does not provide provider-specific timing guarantees.

​
Notes

  • The current Domains page manages custom-domain actions for Owners and Primary Owners.
  • Members can view, search, and inspect rows, but all action buttons are disabled for them.

​
Permissions

ActionPrimary OwnerOwnerMember
View domainsYesYesYes
Add custom domainYesYesNo
Verify domainYesYesNo
Remove domainYesYesNo