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.
- 1Create an account. Sign up with email or Google. Every new account starts with 10 free translation minutes.
- 2Pick two languages. Choose the language you speak and the language you want to hear. They can be swapped at any time.
- 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.
- 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.
<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 — 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.
<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.
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
{
"translated_text": "Hola, ¿cómo estás?",
"target_lang": "es"
}Examples
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"}'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.