Si ta përdorësh API-n

Transkripto audio shqip në tekst me vetëm 2 parametra: skedarin audio dhe çelësin API. Punon me çdo gjuhë programimi.

Vendos çelësin tënd API këtu — shembujt do të përditësohen automatikisht:
1

Regjistrohu dhe merr çelësin API

Shko te zeri.al dhe kliko "Merr çelësin API". Vendos email-in tënd dhe merr çelësin menjëherë. Çelësi duket kështu:

Çelësi API
zr_live_a1b2c3d4e5f6g7h8i9j0...

Ruaje çelësin në një vend të sigurt — nuk do të shfaqet përsëri.

2

Dërgo audio dhe merr tekst

Dërgo një kërkesë POST me 2 fusha: audio (skedari) dhe api_key (çelësi yt). Kaq. Pa header, pa token, pa komplikime.

curl
curl -F "audio=@audio.wav" -F "api_key=ÇELËSI_YT_API_KËTU" https://zeri-al-api.onrender.com/v1/transcribe
Python
import requests

response = requests.post(
    "https://zeri-al-api.onrender.com/v1/transcribe",
    files={"audio": open("audio.wav", "rb")},
    data={"api_key": "ÇELËSI_YT_API_KËTU"},
)

result = response.json()
print(result["text"])
# Përgjigja: "Mirëdita, sot do të flasim për..."
JavaScript
const formData = new FormData();
formData.append("audio", audioFile);
formData.append("api_key", "ÇELËSI_YT_API_KËTU");

const response = await fetch(
    "https://zeri-al-api.onrender.com/v1/transcribe",
    { method: "POST", body: formData }
);

const result = await response.json();
console.log(result.text);
PHP
<?php
$ch = curl_init("https://zeri-al-api.onrender.com/v1/transcribe");
$data = [
    "audio"   => new CURLFile("audio.wav"),
    "api_key" => "ÇELËSI_YT_API_KËTU",
];
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$result = json_decode(curl_exec($ch));
echo $result->text;
3

Përgjigja

API-ja kthen JSON me tekstin e transkriptuar, kohëzgjatjen e audios, modelin dhe kohën e procesimit:

JSON përgjigje
{
  "text": "Mirëdita, sot do të flasim për teknologjinë...",
  "language": "sq",
  "duration_seconds": 5.2,
  "model": "whisper-turbo-large-shqip",
  "processing_time_ms": 1850
}
FushaPërshkrimi
textTeksti i transkriptuar në shqip
duration_secondsKohëzgjatja e audios në sekonda
modelModeli i përdorur
processing_time_msKoha e procesimit në milisekonda
4

Kontrollo përdorimin

Kontrollo sa minuta ke përdorur dhe sa të kanë mbetur:

Përdorimi
curl -X POST https://zeri-al-api.onrender.com/v1/usage -F "api_key=ÇELËSI_YT_API_KËTU"

# Përgjigja:
{
  "email": "emri@juaj.com",
  "plan": "free",
  "minutes_used": 2.35,
  "minutes_limit": 60,
  "month_reset": "2026-03-01T00:00:00"
}
5

Formate të mbështetura

.wav.mp3.ogg.flac.m4a.webm.mp4.wma

Madhësia maksimale: 100MB për skedar.

6

Planet dhe limitet

Falas
€0
60 min/muaj
Pro
€29
500 min/muaj
Ndërmarrje
Me porosi
Pa limit
7

Kodet e gabimeve

KodiKuptimi
200Sukses — transkriptimi u krye
400Format audio i gabuar
401Çelësi API nuk është i vlefshëm
409Email-i është regjistruar tashmë
413Skedari tejkalon 100MB
429Ke arritur limitin mujor — përmirëso planin
Gati për të filluar?
Merr çelësin APISwagger UI