API

De wout.
Yon repons chak.

Voye tèks, resevwa yon fichye WAV. Voye odyo, resevwa tèks kreyòl la. Chak apèl reponn dirèkteman, pa gen travay pou w swiv.

Ou bezwen yon kle API

Fè yon kle nan tablo w, nan Kle API, epi voye l ak chak demann: Authorization: Bearer lb_…. Nou montre yon kle yon sèl fwa; ou ka gen jiska 10, epi ou ka anile nenpòt nan yo lè ou vle. Kenbe l sekrè: rele API a depi sèvè w, pa janm depi yon paj entènèt. Chak adrès toujou limite tou a 90 demann tèks ak 30 transkripsyon chak dis minit.

Fè yon kle API

Pou asistan IA ak jeneratè kòd

Menm dokimantasyon an nan fichye senp yon asistan IA ka li yon sèl kou: ba li premye lyen an, l ap kapab ekri kòd ki mache pou ou.

https://www.lambbi.xyz/llms-full.txt · tout API a an Markdown, ak egzanp
https://www.lambbi.xyz/openapi.json · chema OpenAPI 3.1, pou zouti ak jeneratè SDK
https://www.lambbi.xyz/llms.txt · yon ti endèks (llms.txt)

Pri

1 kredi pou chak minit odyo.

1 kredi = 1 minit odyo = 2 HTG, yo konte l pa segonn: tèks an vwa konte segonn odyo li fè yo, vwa an tèks konte segonn li tande yo (120 pou pi plis chak demann). 5 minit gratis chak kont genyen chak mwa (lè Ayiti) pase anvan; ou pataje yo ak asistan w yo ak Studio a. Yon demann ki pa mache pa koute anyen. Ajoute kredi ak MonCash oswa ak kat nan tablo w.

Sa chak demann koute

X-Charged-Seconds header

Segonn odyo yo konte: sa li fè (tèks an vwa) oswa sa li tande (vwa an tèks).

X-Credits-Used header

Kredi demann sa a pran; 0 toutotan li antre nan minit gratis ou yo.

X-Credits-Left header

Kredi ki rete sou kont ou.

X-Free-Seconds-Left header

Segonn gratis ki rete sou kont ou mwa sa a.

De wout yo voye antèt sa yo. Vwa an tèks remete menm chif yo nan JSON li tou, nan charged.

Tèks an vwa

`POST /api/tts`

Li yon moso kreyòl ak Fatiman epi reponn an audio/wav, 24 kHz, 16 bit, mono. Antèt repons lan di konbyen tan odyo a dire (X-Audio-Seconds), konbyen tan sa pran pou fè l (X-Made-Ms) ak reglaj ki te sèvi (X-Settings).

text string, obligatwa

Jiska 1 200 karaktè. Chif, dat, lè, pri, pousantaj, nimewo telefòn ak adrès entènèt ekri an lèt jan moun di yo.

voice string

Youn nan female1, female2, female3, female4, female5, female6, man1, man2, man3, nouvo1, nouvo2, nouvo3, nouvo4. Pa defo female1. nouvo1 rive nouvo4 se Gason 4 rive 7: nouvo vwa ki fèt apati vwa gason Fatiman yo, yo pa vwa okenn moun ki egziste.

continues boolean

Tèks la kontinye yon fraz ou koupe sou yon vigil, konsa vwa a pa li l tankou yon nouvo fraz. Pa defo false.

model string

v1 (pa defo), v2 (li aprann sèlman ak vrè vwa moun) oswa v3, dènye a, ki pi natirèl nan tès nou yo. Antèt X-Model la di kiyès ki li tèks la.

temperature number

Nonm, soti 0,1 rive 1. Jan vwa a li lib: pi ba, li pi egal. Pa defo 0,7 pou v1 ak v2, 0,3 pou v3.

lsd_steps integer

Nonm antye, soti 1 rive 8. Etap pou chak son; plis, li pi dousman. Pa defo 1.

eos_threshold number

Nonm, soti −6 rive 2. Kilè vwa a deside tèks la fini: pi ba, li fini pi vit e li ka koupe dènye mo a; pi wo, li tann plis. Pa defo −4.

cfg number

Nonm, soti 1 rive 3. Pi wo pase 1, vwa a swiv tèks la pi pre, men li pran apeprè de fwa plis tan. Pa defo 1.

pause_ms integer

Nonm antye, 0 oswa soti 100 rive 2000. Silans ki pi long yo vin dire sa a; 0 kenbe tout poz yo. Pa defo 300.

Yon valè ki depase limit li vin sou limit ki pi pre a.

Vwa yo

id	Non	Sèks	Karaktè
`female1`	Fanm 1	Fanm	Klè, egal
`female2`	Fanm 2	Fanm	Vivan
`female3`	Fanm 3	Fanm	Dous
`female4`	Fanm 4	Fanm	Grav, trè estab
`female5`	Fanm 5	Fanm	Klè, briyan
`female6`	Fanm 6	Fanm	Kalm
`man1`	Gason 1	Gason	Klere
`man2`	Gason 2	Gason	Fon
`man3`	Gason 3	Gason	Cho, poze
`nouvo1`	Gason 4	Gason	Fon, kalmnouvo vwa
`nouvo2`	Gason 5	Gason	Klè, natirèlnouvo vwa
`nouvo3`	Gason 6	Gason	Lejènouvo vwa
`nouvo4`	Gason 7	Gason	Fèmnouvo vwa

Modèl: v1 (pa defo), v2 ak v3. Chak li ak pwòp tanperati pa defo pa l: 0.7 pou v1 ak v2, 0.3 pou v3.

Antèt repons lan

X-Audio-Seconds header

Konbyen tan odyo a dire, an segonn.

X-Made-Ms header

Konbyen tan vwa a pran pou fè l, an milisegonn.

X-Model header

Modèl ki li l la: v1, v2 oswa v3.

X-Settings header

Reglaj lekti ki te sèvi vre, an JSON, apre valè ki depase limit yo te vin sou limit ki pi pre a.

curl -X POST https://www.lambbi.xyz/api/tts \
  -H "Authorization: Bearer $LAMBBI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Bonjou! Ki jan ou ye jodi a?", "voice": "female1", "model": "v3"}' \
  -o bonjou.wav

Tèks long. Voye yon tèks long an moso, kòmanse ak yon ti moso kout, epi jwe chak moso touswit li rive. Vwa a fèt anviwon de fwa pi vit pase li jwe, kidonk moun nan tande premye mo yo nan anviwon yon segonn edmi, san li pa kanpe apre. Studio a fonksyone egzakteman konsa.

Vwa an tèks

`POST /api/asr`

Ekri kreyòl ki nan yon fichye odyo ak Oswald-ASR-0.6-V3. Voye fichye a kòm kò demann lan ak Content-Type li, oswa nan yon chan fòmilè multipart ki rele file. WAV, MP3, M4A, OGG ak WebM mache, jiska 25 MB; premye de minit yo ekri.

Demann

body / file fichye odyo, obligatwa

Odyo a kòm kò demann lan ak Content-Type li (audio/wav, audio/mpeg, audio/mp4, audio/ogg, audio/webm…), oswa yon voye multipart ak fichye a nan yon chan ki rele file. Pi plis 25 MB; premye de minit yo ekri.

?punctuate 0 | 1

0 voye tèks la egzakteman jan li te tande, apeprè yon segonn pi vit. Pa defo, ponktiyasyon ak lèt majiskil ajoute san yo pa chanje okenn mo.

?correct 0 | 1

1 korije tou mo Oswald pa t tande byen, òtograf la ak mo yo di de fwa. Yon koreksyon ki chanje plis pase 40% mo yo pa sèvi.

?translate en | fr | es

Tradui transkripsyon an tou an angle, franse oswa panyòl.

Repons (JSON)

text string

Sa moun nan di, ekri an kreyòl, ak ponktiyasyon ak lèt majiskil Lambbi AI (DeepSeek) ajoute; mo yo toujou egzakteman sa Oswald te ekri. Vid si yo pa tande anyen.

heard string

Sa Oswald te ekri, san ponktiyasyon. Menm jan ak text lè ponktiyasyon an fèmen oswa li pa t ajoute.

punctuated boolean

Si ponktiyasyon an te ajoute (pa ak ?punctuate=0).

corrected boolean

Si text te korije otomatikman (ak ?correct=1); heard kenbe sa Oswald te ekri.

translation string | null

Ak ?translate=en, fr oswa es: text tradui an angle, franse oswa panyòl pa Lambbi AI (DeepSeek). null si tradiksyon an pa mache; li pa la si ou pa mande translate.

translatedTo string

Lang translation la, lè yo mande yon tradiksyon.

seconds number

Konbyen odyo yo tande.

ms number

Konbyen tan sa pran sou sèvè a, ponktiyasyon, koreksyon ak tradiksyon ladan.

maxSeconds number

Pi plis odyo yo ekri pou chak demann, an segonn (120).

charged object

Sa demann lan koute: seconds yo konte ak credits li pran, apre sa creditsLeft ak freeSecondsLeft ki rete sou kont ou.

# the file as the body, with its type
curl -X POST "https://www.lambbi.xyz/api/asr?correct=1&translate=en" \
  -H "Authorization: Bearer $LAMBBI_API_KEY" \
  -H "Content-Type: audio/mp4" \
  --data-binary @recording.m4a

# or as a form upload
curl -X POST "https://www.lambbi.xyz/api/asr" \
  -H "Authorization: Bearer $LAMBBI_API_KEY" \
  -F file=@recording.m4a

{
  "text": "Doktè, ou ka esplike m ankò diferans ant timè benin ak timè malfezan?",
  "heard": "doktè ou ka esplike m ankò diferans ant timè benin ak timè malfezan",
  "punctuated": true,
  "corrected": true,
  "translation": "Doctor, can you explain to me again the difference between a benign tumor and a malignant tumor?",
  "translatedTo": "en",
  "seconds": 5.2,
  "ms": 3371,
  "maxSeconds": 120,
  "charged": {
    "seconds": 5.2,
    "credits": 0,
    "creditsLeft": 25,
    "freeSecondsLeft": 287
  }
}

Erè ak tan

400 / 405 / 413 demann ou

Kò a oswa yon paramèt pa sa wout la tann, metòd la pa t POST, oswa tèks la oswa fichye a te twò long. Kò a se JSON, {"error": "…"}, ki di kiyès.

401 pa gen kle

Pa gen kle API ("code": "no_key"), oswa kle a pa bon oswa yo anile l ("code": "bad_key"). Voye Authorization: Bearer lb_… ak yon kle ki soti nan tablo w.

402 pa gen kredi

Minit gratis ou yo ak kredi w fini ("code": "no_credit"). Ajoute kredi nan tablo w. Demann ki pati an menm tan ka fè kredi w desann yon ti kras anba zewo; lè sa a, demann ki vin apre a resevwa 402.

429 twòp

Tann kantite segonn ki nan Retry-After.

502 / 504 bò kote pa nou

Sèvis vwa a pa mache oswa li pran twòp tan. Premye apèl apre anviwon senk minit san aktivite limen yon machin epi chaje modèl yo, sa ka pran jiska 30 segonn: mete yon delè omwen 60 segonn epi eseye ankò yon fwa.

De wout.Yon repons chak.