Dokumentation

Freezetale ist ein blitzschneller Speech-to-Text-API-Dienst mit Hosting in Norwegen, der vom 100 % erneuerbaren Wasser- und Geothermienetz Islands mit Energie versorgt wird.

Mit der standardmäßig integrierten automatischen Sprecherdiarisierung (Sprecherkennzeichnung) für alle Sprachen ist Freezetale die perfekte Lösung für all Ihre Speech-to-Text-Anforderungen.

Verbindung und Autorisierung

Um die Freezetale-APIs zu verwenden, erstellen Sie zunächst ein Projekt und ein API-Token. Suchen Sie anschließend die ID Ihres Projekts oberhalb der Transkriptionsliste.

Hinweis: Sowohl bei der Projekt-ID als auch beim API-Token muss die Groß- und Kleinschreibung beachtet werden. Anfragen an die API müssen über HTTPS erfolgen. Aufrufe über unverschlüsseltes HTTP schlagen fehl. API-Anfragen ohne Authentifizierung schlagen ebenfalls fehl.

Praktischerweise können Sie hier Ihre Projekt-ID und Ihr Token eingeben. Wir verwenden sie dann in den folgenden Beispielen anstelle von Platzhaltern.

Projekt-ID

API-Token

Basis-URL

https://freezetale.com/api

Authentifizierte Anfrage

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

Transkription erstellen

Starten Sie einen neuen Transkriptionsauftrag. Identische Anfragen werden automatisch dedupliziert.

Siehe unterstützte Sprachen für die in language zu verwendenden Codes.

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"

Beispielantwort

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

Eine Transkription abrufen

Rufe einen Transkriptionsauftrag anhand seiner ID ab.

Wenn der Transkriptionsauftrag abgeschlossen ist, ändert sich sein status in completed. Außerdem wird resultUrl auf eine URL gesetzt, die das Ergebnis der Transkription und weitere Metadaten enthält, die anschließend heruntergeladen werden können.

Die Antwort enthält einen Last-Modified-Header, den Sie verwenden können, wenn Sie die API mithilfe von If-Modified-Since auf Aktualisierungen prüfen.

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"

Beispielantwort

{
	"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 kann einen der folgenden Werte annehmen: pending, errored, timeout, cancelled, completed.

Beispielantwort mit Ergebnis

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

Hinweis: Alle Zeitangaben sind in Millisekunden.

Alle Transkriptionen abrufen

Rufe eine Liste aller Transkriptionsaufträge in einem Projekt ab.

GET /v1/app/transcriptions

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

Beispielantwort

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

Unterstützte Sprachen

Freezetale unterstützt die folgenden Sprachen. Wenn Sie möchten, dass eine Sprache hinzugefügt wird, nehmen Sie bitte Kontakt mit uns auf.

Sprache	Code	Unterstützt die Sprecherdiarisierung
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

Grenzen

Ihre API-Anfragen sind abhängig von den Details Ihres Abonnements beschränkt. Ansonsten gelten die folgenden allgemeinen Limits:

Maximale Dateigröße: 1024 MB
Maximale Audiodauer: 180 Minuten

100 % erneuerbar?

Während sich das Rechenzentrum von Freezetale in Norwegen befindet, sind unsere GPUs für die Transkriptionsverarbeitung in Island angesiedelt und werden mit Islands zu 100 % erneuerbarem Wasserkraft- und Geothermie-Energienetz betrieben. Dadurch können wir Transkriptionen mit einem nahezu CO₂-freien Fußabdruck bereitstellen und gleichzeitig die vollständige Einhaltung der Datenschutz-Grundverordnung (DSGVO) der EU gewährleisten.

Ein Produkt von Nattskiftet

•

Hergestellt in Norwegen

Kontakt•Datenschutzerklärung•Nutzungsbedingungen•German