Documentatie

Freezetale is een razendsnelle spraak-naar-tekst API-dienst gehost in Noorwegen, aangedreven door IJslands 100% hernieuwbare water- en geothermische energie netwerk.

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, moet u eerst een project aanmaken en een API-token. Zoek vervolgens de ID van uw project hierboven in de transcriptielijst.

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

Handig kunt u hier uw project-ID en token invullen, en we zullen deze in de onderstaande voorbeelden gebruiken 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. Dedupeert automatisch identieke verzoeken.

Zie ondersteunde talen voor codes die u 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"

Voorbeeldantwoord

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

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.

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"

Voorbeeldantwoord

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

Een lijst ophalen van alle transcriptiewerkzaamheden 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"

Voorbeeldantwoord

{
	"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 een taal toegevoegd wilt zien, neem dan contact 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

Uw API-verzoeken zijn beperkt op basis van de details van uw abonnementsplan. Dit zijn anders de algemene limieten:

Maximale bestandsgrootte: 1024 MB
Maximale audiolengte: 180 minuten

100% hernieuwbaar?

Hoewel het datacenter van Freezetale zich in Noorwegen bevindt, zijn onze transcriptie-runtime GPU's gevestigd in en worden ze aangedreven door IJslands 100% hernieuwbare hydro- en geothermische energienetwerk. Dit stelt ons in staat om transcripties te leveren met een vrijwel nul koolstofvoetafdruk en tegelijkertijd volledig te voldoen aan de Algemene Verordening Gegevensbescherming (AVG) van de EU.

Een product van Nattskiftet

•

Gemaakt in Noorwegen

Contact•Privacybeleid•Gebruiksvoorwaarden•Dutch