1
Regjistrohu dhe merr çelësin API Shko te flasim.ai 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 U kopjua!
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 Kopjo
curl -F "audio=@audio.wav" -F "api_key=ÇELËSI_YT_API_KËTU" https://fol-shqip-api.onrender.com/v1/transcribe Python Kopjo
import requests
response = requests.post(
"https://fol-shqip-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 Kopjo
const formData = new FormData();
formData.append("audio", audioFile);
formData.append("api_key", "ÇELËSI_YT_API_KËTU");
const response = await fetch(
"https://fol-shqip-api.onrender.com/v1/transcribe",
{ method: "POST", body: formData }
);
const result = await response.json();
console.log(result.text); PHP Kopjo
<?php
$ch = curl_init("https://fol-shqip-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; API-ja kthen JSON me tekstin e transkriptuar, kohëzgjatjen e audios, modelin dhe kohën e procesimit:
JSON përgjigje Kopjo
{
"text": "Mirëdita, sot do të flasim për teknologjinë...",
"language": "sq",
"duration_seconds": 5.2,
"model": "zeri-stt",
"processing_time_ms": 1850
} Fusha Përshkrimi textTeksti i transkriptuar në shqip duration_secondsKohëzgjatja e audios në sekonda modelModeli i përdorur processing_time_msKoha e procesimit në milisekonda
Kontrollo sa minuta ke përdorur dhe sa të kanë mbetur:
Përdorimi Kopjo
curl -X POST https://fol-shqip-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"
} Dërgo tekst shqip (deri në 800 karaktere) dhe merr audio WAV (24 kHz). Zgjidh zërinfemale ose male dhe shpejtësinë (0.5 – 2.0). Kohëzgjatja e audios llogaritet te minutat e tua mujore dhe kthehet në header-in X-Audio-Duration.
cURL Kopjo
curl -X POST https://fol-shqip-api.onrender.com/v1/tts \
-H "Content-Type: application/json" \
-d '{"api_key": "ÇELËSI_YT_API_KËTU", "text": "Mirëdita, si jeni?", "voice": "female"}' \
-o flasim.wav Python Kopjo
import requests
response = requests.post(
"https://fol-shqip-api.onrender.com/v1/tts",
json={
"api_key": "ÇELËSI_YT_API_KËTU",
"text": "Mirëdita, si jeni?",
"voice": "female", # ose "male"
"speed": 1.0, # 0.5 – 2.0
},
)
response.raise_for_status()
with open("flasim.wav", "wb") as f:
f.write(response.content)
print("Kohëzgjatja:", response.headers["X-Audio-Duration"], "s")