Documentatie

Freezetale is een razendsnelle spraak-naar-tekst-API-dienst, gehost in Noorwegen en aangedreven door het 100% hernieuwbare waterkracht- en geothermische energienetwerk van IJsland.

Met automatische sprekerdiarisatie (sprekerlabels) die standaard voor alle talen wordt ondersteund, is Freezetale de perfecte oplossing voor al uw spraak-naar-tekstbehoeften.

Verbinding en autorisatie

Om de Freezetale API's te gebruiken, moet je eerst een project aanmaken en een API-token genereren. Zoek vervolgens de ID van je project boven de transcriptielijst.

Opmerking: Zowel de project-ID als het API-token zijn hoofdlettergevoelig. Verzoeken aan de API moeten via HTTPS worden verstuurd. Aanroepen via gewoon HTTP mislukken. API-verzoeken zonder authenticatie mislukken ook.

Je kunt hier eenvoudig je project-ID en token invullen; in de onderstaande voorbeelden gebruiken we deze vervolgens in plaats van tijdelijke aanduidingen.

Project-ID

API-token

Basis-URL

https://freezetale.com/api

Geauthenticeerd verzoek

curl -X GET \
-H "Authorization: Bearer API_TOKEN" \
"https://freezetale.com/api/v1/app/transcriptions?project-id=PROJECT_ID"

Een transcriptie maken

Start een nieuwe transcriptietaak. Identieke verzoeken worden automatisch ontdubbeld.

Bekijk de ondersteunde talen voor codes die je kunt gebruiken in language.

POST /v1/app/transcriptions

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"

Voorbeeldreactie

{
	"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"
	}
}

Een transcriptie ophalen

Haal een transcriptietaak op aan de hand van de 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 metagegevens, die vervolgens kunnen worden gedownload.

De respons bevat een Last-Modified-header die je kunt gebruiken wanneer je de API met If-Modified-Since op updates bevraagt.

GET /v1/app/transcriptions

curl -X GET \
-H "Authorization: Bearer API_TOKEN" \
"https://freezetale.com/api/v1/app/transcriptions?id=TRANSCRIPTION_ID&project-id=PROJECT_ID"

Voorbeeldreactie

{
	"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 hebben: pending, errored, timeout, cancelled, completed.

Voorbeeld van een antwoord met resultaten

{
	"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 tijdswaarden zijn in milliseconden.

Alle transcripties ophalen

Bekijk een lijst van alle transcriptietaken in een project.

GET /v1/app/transcriptions

curl -X GET \
-H "Authorization: Bearer API_TOKEN" \
"https://freezetale.com/api/v1/app/transcriptions?project-id=PROJECT_ID"

Voorbeeldreactie

{
	"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 je wilt dat er een taal wordt toegevoegd, neem dan contact met ons op.

Taal	Code	Ondersteunt sprekerdiarisatie
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

Je API-verzoeken zijn beperkt op basis van de details van je abonnementsplan. Daarnaast gelden de volgende algemene limieten:

Maximale bestandsgrootte: 1024 MB
Maximale audiolengte: 180 minuten

100% hernieuwbaar?

Hoewel het datacenter van Freezetale zich in Noorwegen bevindt, bevinden onze GPU’s voor transcriptieverwerking zich in IJsland en worden ze aangedreven door het 100% hernieuwbare waterkracht- en geothermische energienetwerk van IJsland. Hierdoor kunnen we transcripties leveren met een vrijwel nul uitstoot van koolstof en bovendien volledig voldoen aan de Algemene Verordening Gegevensbescherming (AVG) van de EU.

Een product van Nattskiftet

•

Gemaakt in Noorwegen

Contact•Privacybeleid•Gebruiksvoorwaarden•Dutch