Documentatie
Freezetale is een razendsnelle spraak-naar-tekst API-service, gehost in Noorwegen en aangedreven door het 100% hernieuwbare hydro- en geothermische energienet van IJsland.
Met automatische sprekerdiarisatie (sprekerlabels) die standaard wordt ondersteund voor alle talen, is Freezetale de perfecte oplossing voor al uw spraak-naar-tekstbehoeften.
https://freezetale.com/apicurl -X GET \
-H "Authorization: Bearer API_TOKEN" \
"https://freezetale.com/api/v1/app/transcriptions?project-id=PROJECT_ID"Maak een transcriptie aan
Start een nieuwe transcriptietaak. Voert automatisch deduplicatie uit voor identieke verzoeken.
Zie ondersteunde talen voor de codes die u kunt gebruiken in language.
curl -X POST \
-H "Authorization: Bearer API_TOKEN" \
--json '{"audioUrl": "https://example.com/audio.mp3", "language": "en"}' \
"https://freezetale.com/api/v1/app/transcriptions?project-id=PROJECT_ID"{
"success": true,
"transcription": {
"id": "o3V8FEvUHG21BcuQBCwSZXqO7BV3",
"status": "pending",
"audio": {
"url": "https://example.com/audio.mp3",
"language": "en"
},
"creationDate": "2025-06-07T12:00:00.000Z",
"modificationDate": "2025-06-07T12:00:00.000Z"
}
}Transcriptie ophalen
Haal een transcriptietaak op met het bijbehorende ID.
Wanneer de transcriptietaak is voltooid, verandert de status in completed. Ook wordt resultUrl ingesteld op een URL met het resultaat van de transcriptie en andere metadata, die vervolgens gedownload kunnen worden.
De respons bevat een Last-Modified header die u kunt gebruiken bij het pingen van de API voor updates met behulp van If-Modified-Since.
curl -X GET \
-H "Authorization: Bearer API_TOKEN" \
"https://freezetale.com/api/v1/app/transcriptions?id=TRANSCRIPTION_ID&project-id=PROJECT_ID"{
"success": true,
"transcription": {
"id": "pkbvMEdhVavGa80K4zBU53N3XiCR",
"status": "completed",
"audio": {
"url": "https://example.com/audio.mp3",
"language": "en",
"length": 1034947.4375
},
"resultUrl": "https://example.com/36c16505-0fb5-4b8c-8e22-0240d95e1eb5-pkbvMEdhVavGa80K4zBU53N3XiCR.json",
"creationDate": "2025-06-07T12:00:00.000Z",
"modificationDate": "2025-06-07T12:00:00.000Z",
"completionDate": "2025-06-07T12:00:00.000Z"
}
}status kan een van de volgende waarden zijn: pending, errored, timeout, cancelled, completed.
{
"id": "b25129c7-6354-4676-923f-c997ba8fb3db",
"reference": "pkbvMEdhVavGa80K4zBU53N3XiCR",
"words": [
{
"start": 1448,
"end": 2108,
"word": "Hello!",
"speaker": 1
}
],
"metadata": {
"speakers": 1,
"confidence": 0.988733,
"language": {
"input": "en",
"detected": "en"
},
"audio": {
"type": "audio/mpeg",
"size": 788013,
"length": 1034947.4375
}
}
}Opmerking: Alle tijdwaarden zijn in milliseconden.
Alle transcripties ophalen
Haal een lijst op van alle transcriptieopdrachten in een project.
curl -X GET \
-H "Authorization: Bearer API_TOKEN" \
"https://freezetale.com/api/v1/app/transcriptions?project-id=PROJECT_ID"{
"success": true,
"transcriptions": [
{
"id": "o3V8FEvUHG21BcuQBCwSZXqO7BV3",
"status": "pending",
"audio": {
"url": "https://example.com/audio.mp3",
"language": "en"
},
"creationDate": "2025-06-07T12:00:00.000Z",
"modificationDate": "2025-06-07T12:00:00.000Z",
"estimatedCompletionDate": "2025-06-07T12:00:00.000Z"
},
{
"id": "pkbvMEdhVavGa80K4zBU53N3XiCR",
"status": "completed",
"audio": {
"url": "https://example.com/audio.mp3",
"language": "en",
"length": 1034947.4375
},
"resultUrl": "https://example.com/36c16505-0fb5-4b8c-8e22-0240d95e1eb5-pkbvMEdhVavGa80K4zBU53N3XiCR.json",
"creationDate": "2025-06-07T12:00:00.000Z",
"modificationDate": "2025-06-07T12:00:00.000Z",
"completionDate": "2025-06-07T12:00:00.000Z"
}
]
}Ondersteunde talen
Freezetale ondersteunt de volgende talen. Als u graag wilt dat er een taal wordt toegevoegd, neem dan contact met ons op.
| Taal | Code | Ondersteunt sprekersdiarisatie |
|---|---|---|
| English | en | Ja |
| Danish | da | Ja |
| German | de | Ja |
| Spanish | es | Ja |
| Finnish | fi | Ja |
| French | fr | Ja |
| Icelandic | is | Ja |
| Dutch | nl | Ja |
| Norwegian (Nynorsk) | nn | Ja |
| Norwegian (Bokmål) | no | Ja |
| Swedish | sv | Ja |
Limieten
Uw API-aanvragen zijn beperkt op basis van de details van uw abonnementsplan. Daarnaast gelden de volgende algemene limieten:
- Maximale bestandsgrootte: 1024 MB
- Maximale audiolengte: 180 minuten
100% hernieuwbaar?
Hoewel het datacenter van Freezetale in Noorwegen staat, bevinden onze transcriptie-runtime-GPU's zich in IJsland en worden ze gevoed door het IJslandse energiesysteem dat voor 100% draait op hernieuwbare waterkracht- en geothermische energie. Dit stelt ons in staat transcripties te leveren met een vrijwel nul CO2-voetafdruk en daarnaast volledig te voldoen aan de Algemene verordening gegevensbescherming van de EU (AVG).