Documentatie

Freezetale is een razendsnelle spraak-naar-tekst-API-service die gehost wordt in Noorwegen, 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.

Verbinding en autorisatie

Om de Freezetale-API's te gebruiken, maak eerst een project aan en een API-token. Zoek vervolgens de ID van uw project boven de transcriptielijst.

Opmerking: Zowel de project-ID als het API-token zijn hoofdlettergevoelig. Verzoeken naar de API moeten via HTTPS worden verzonden. Oproepen via onbeveiligd HTTP zullen mislukken. API-verzoeken zonder authenticatie zullen ook mislukken.

Handig: u kunt hier uw project-ID en token invullen; wij gebruiken deze vervolgens in de voorbeelden hieronder in plaats van voorbeeldwaarden.

Project-ID

API-token

Basis-URL

https://freezetale.com/api

Geauthenticeerde aanvraag

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

Maak een transcriptie

Start een nieuwe transcriptietaak. Detecteert en verwijdert automatisch dubbele verzoeken.

Zie ondersteunde talen voor codes die gebruikt kunnen worden 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"

Voorbeeldrespons

{
	"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 het ID.

Wanneer de transcriptietaak is voltooid, verandert de status in completed. Ook wordt resultUrl ingesteld op een URL die het resultaat van de transcriptie en andere metadata bevat, die vervolgens gedownload kunnen worden.

Het antwoord bevat een Last-Modified header die u kunt gebruiken wanneer u de API om updates pingt met behulp van If-Modified-Since.

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"

Voorbeeldrespons

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

Voorbeeld van een resultaatrespons

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

GET /v1/app/transcriptions

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

Voorbeeldrespons

{
	"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 zou zien 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-verzoeken zijn beperkt op basis van de details van uw abonnementsplan. In andere gevallen gelden de volgende algemene limieten:

Maximale bestandsgrootte: 1024 MB
Maximale audioduur: 180 minuten

100% hernieuwbaar?

Hoewel het datacenter van Freezetale in Noorwegen staat, bevinden onze transcriptie-runtime-GPU's zich in IJsland en worden ze aangedreven door het IJslandse, 100% hernieuwbare waterkracht- en geothermische energiesysteem. Dit stelt ons in staat om transcripties te leveren met een nagenoeg nul CO2-voetafdruk en tegelijkertijd volledig te voldoen aan de Algemene verordening gegevensbescherming (AVG) van de EU (GDPR).

Een product van Nattskiftet

•

Gemaakt in Noorwegen

Contact•Privacybeleid•Gebruiksvoorwaarden•Dutch