Documentation

Babl product and API guide

How the app works, what each plan includes, and how to embed translation in your own site with the widget or the public API.

What Babl is

Babl is a voice translation app: you speak your language, the other person hears theirs. Around it sits a social layer (feeds, live stages, random chat, dating) and a business layer (translated meetings, team directory, meeting recaps).

  • Personal shell — translated video calls, group calls, face-to-face mode, random chat matchmaking, a global feed, live stages and dating.
  • Business shell — scheduled translated meetings, a team directory, call history, meeting recaps with action items, a pinned-terms glossary and a product catalog with live selling.
  • One codebase — the same app runs on the web and as a native iOS and Android build.

Both shells share one account and one minute balance. You switch mode from the mode menu in the header; the app remembers your choice.

Quick start

From sign-up to a translated conversation in four steps.

  1. 1Create an account. Sign up with email or Google. Every new account starts with 10 free translation minutes.
  2. 2Pick two languages. Choose the language you speak and the language you want to hear. They can be swapped at any time.
  3. 3Start or join a call. Open a call and share the room code, schedule a meeting in Business, or join someone else with their code.
  4. 4Talk normally. Speech is transcribed, translated and spoken back in the listener’s language, with captions on screen.

New here? Create an account to get the trial minutes, or read plans & pricing first.

Features

Everything the app does today, grouped by shell. Personal and business features use the same minute balance.

Personal & social

Translated video calls
One-to-one calls with live translated captions and spoken translation in the other person’s language.
Group calls
Up to six people on one room code, each hearing the conversation in their own language.
Face-to-face
One device between two people, with each side of the screen in a different language.
Join with a code
Every room has a short shareable code; anyone signed in can join it.
Voice profiles
Save a voice and have translations spoken in it. Voice cloning is part of Pro.
Random chat
Get matched with a speaker of another language for an instant practice conversation.
Feed & dubbing
Post photos and videos, and watch posts dubbed into your language.
Live Stage
Broadcast to viewers who watch with translated captions and pick the voice preset they hear.
Dating
A separate dating experience with its own profile, discover deck and random video calls.

Business

Meetings & scheduling
Schedule a translated meeting, get a room code and share the join link with the other side.
Team directory
Keep the people you meet with, their language and their contact details in one list.
Call history
Every past call with participant, date, direction and status, plus a way to open the room again.
Meeting recaps
Turn a completed meeting into a summary, key points and action items, readable by everyone in the call.
Glossary
Pin product names, client names and acronyms so they are never translated literally.
Products & live selling
A product catalog you can pin during a live stage so viewers can buy while watching.

Languages

The picker offers 34 languages. Language codes below are the ISO-639-1 codes the API and the widget use — the same codes the app sends.

  • Englishen
  • Germande
  • Frenchfr
  • Spanishes
  • Italianit
  • Portuguesept
  • Dutchnl
  • Polishpl
  • Russianru
  • Japaneseja
  • Koreanko
  • Chinesezh
  • Arabicar
  • Hindihi
  • Turkishtr
  • Swedishsv
  • Greekel
  • Ukrainianuk
  • Indonesianid
  • Czechcs
  • Bulgarianbg
  • Croatianhr
  • Danishda
  • Finnishfi
  • Hebrewhe
  • Hungarianhu
  • Malayms
  • Malayalamml
  • Norwegianno
  • Romanianro
  • Slovaksk
  • Tamilta
  • Vietnamesevi
  • Catalanca

Translation is symmetric: any of these languages can be the spoken language or the language you want to hear. When the source language is left out of an API request, it is detected automatically.

Plans & minutes

Every translated minute is metered. Plans include a monthly allowance; purchased top-ups are used on any plan.

Trial

$0

10 minutes, one time

Default voice, shareable and solo rooms, watching live stages.

Pro

$24.99 / month

200 minutes per month

Voice cloning, random chat matchmaking, live stage broadcasting, social discovery.

Business

$34.99 / month

200 minutes per month

Everything in Pro plus business mode: meetings, team, call history, recaps and glossary.

Minute top-ups: 100 minutes or 500 minutes, bought once and used whenever you need them. Rates and top-up options are always listed on plans & pricing.

Business accounts also include 10 free trial minutes before a subscription, so a team can test a real conversation first.

Embed the widget

A drop-in translation panel for any website. Visitors speak or type in their language and immediately hear and read the translation — no Babl account needed.

HTML — embed
<iframe
  src="https://babl.pro/widget?partner=your-company&key=babl_sk_your_key"
  title="Babl live translation"
  width="380"
  height="620"
  style="border:0;border-radius:16px;max-width:100%"
  allow="microphone; autoplay"
  loading="lazy"
></iframe>

API key. The widget authenticates every translation with a Business key: create one under Your API keys below and replace babl_sk_your_key with it. Without a key the widget shows a notice instead of translating. Because the key sits in the page URL, anyone who opens your page’s source can read it — use a key made just for this widget, and delete it if you ever see usage you do not recognise. To keep the key off the page entirely, use the proxy route below instead.

Placement. Drop the snippet anywhere in your page. It is responsive: on narrow screens the panel fills the available width, so a fixed width plus max-width:100% is enough.

Microphone. The allow attribute is required for speech input inside an iframe; the browser still asks the visitor for permission the first time. Where speech recognition is unavailable, the widget falls back to a typed input.

Partner attribution. Replace your-company in ?partner= to label usage coming from your site. Leave the parameter out if you do not need attribution.

Direct page. The widget is also a standalone page at /widget, handy for a QR code or a link on a tablet at a reception desk.

Keep the key off the page

A key in the embed URL is readable by any visitor who opens your page’s source. To hide it, put a small route on your own server that holds the key and forwards each request to Babl, then point the widget at that route with ?proxy=. The browser then only ever talks to your domain.

Your server — proxy route (Next.js shown)
// Your server — the Babl key never leaves this machine.
const BABL_KEY = process.env.BABL_KEY;
const CORS = {
  "Access-Control-Allow-Origin": "*",
  "Access-Control-Allow-Headers": "Content-Type",
  "Access-Control-Allow-Methods": "POST, OPTIONS",
};

export async function OPTIONS() {
  return new Response(null, { status: 204, headers: CORS });
}

export async function POST(request) {
  const { text, source_lang, target_lang } = await request.json();
  const res = await fetch("https://babl.pro/functions/widget-translate", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization: `Bearer ${BABL_KEY}`,
    },
    body: JSON.stringify({ text, source_lang, target_lang }),
  });
  return new Response(await res.text(), {
    status: res.status,
    headers: { ...CORS, "Content-Type": "application/json" },
  });
}

Any HTTPS endpoint works — Node, PHP, Python, Go. It must allow cross-origin POSTs (the CORS headers above), and it must return Babl’s JSON unchanged: the widget reads translated_text and shows error when a request fails. Keep the key in an environment variable on that server, never in the page.

HTML — embed through your proxy
<iframe
  src="https://babl.pro/widget?partner=your-company&proxy=https://your-site.com/api/babl-translate"
  title="Babl live translation"
  width="380"
  height="620"
  style="border:0;border-radius:16px;max-width:100%"
  allow="microphone; autoplay"
  loading="lazy"
></iframe>

That embed carries no key. Because the widget calls the route from the visitor’s browser, the route cannot sit behind a login or an IP allowlist — protect it with your own rate limit or per-site token if you need to.

API reference

One endpoint, used by the embeddable widget and available to partners for server-to-server translation. Every call needs an API key from a Business account.

POSThttps://babl.pro/functions/widget-translate

Content type: application/json · Authentication: Authorization: Bearer <key> (required)

Also served on the platform hostname, https://babl.base44.app/functions/widget-translate — either address works.

Your API keys

Business accounts can create keys here and send one as Authorization: Bearer <key>. Delete a key and it stops working immediately.

API keys are for Business accounts

Sign in to see your keys, or read the plans to start a Business subscription.

Request body

text

string · required

The text to translate. Trimmed and capped at 500 characters per request.

target_lang

string · required

ISO-639-1 code of the language to translate into, e.g. es, ja, ar.

source_lang

string · optional

ISO-639-1 code of the spoken language. Omit it to let the service detect the language.

api_key

string · optional

The key, for callers that cannot set an Authorization header — the browser widget sends it this way. Prefer the header everywhere else.

Response

JSON — 200 OK
{
  "translated_text": "Hola, ¿cómo estás?",
  "target_lang": "es"
}

Examples

Shell — curl
curl -X POST https://babl.pro/functions/widget-translate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $BABL_API_KEY" \
  -d '{"text":"Hello, how are you?","source_lang":"en","target_lang":"es"}'
JavaScript — fetch
const res = await fetch("https://babl.pro/functions/widget-translate", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${apiKey}`, // Business plan key
  },
  body: JSON.stringify({
    text,
    source_lang: "en",   // optional — omit to auto-detect
    target_lang: "es",   // required
  }),
});

const { translated_text, target_lang, error } = await res.json();

Errors

400

bad request · optional

text or target_lang is missing or empty.

401

unauthorized · optional

The key is missing, unknown, or was deleted.

503

unavailable · optional

The translation service is not configured on our side.

500

server error · optional

The upstream translation call failed. The body contains an error message.

Scale. One request translates one utterance. For a conversation, send each final transcribed sentence as its own request; the widget does exactly this. Widget translations are not counted against a plan’s minutes.

From a browser. Use the embeddable widget rather than calling the endpoint straight from your page — the widget already handles permission prompts, playback and continuous listening, and with a proxy URL it keeps your key on your own server instead of in the page.

Everything else. The app’s other endpoints (calls, rooms, stages, recaps, billing) require a signed-in Babl session and are private to the app, not part of this public API.

Limits & fair use

  • One API request translates up to 500 characters. Send long passages as separate requests.
  • Translated minutes on calls are metered against your plan’s allowance; widget translations are not.
  • Babl is for people 18 and over, across every part of the app.
  • Reports on posts, comments, profiles and stages are reviewed by moderators.

Questions about higher volumes, custom integrations or a partner agreement: contact@babl.social.