Dokumentation

Freezetale är en blixtsnabb API-tjänst för taligenkänning, med hosting i Norge och drivs av Islands elnät, som till 100 % baseras på förnybar vattenkraft och geotermisk energi.

Med automatisk talardiarisering (talaretiketter) som stöds direkt för alla språk är Freezetale den perfekta lösningen för alla dina behov av tal-till-text.

Anslutning och auktorisering

För att använda Freezetales API:er måste du först skapa ett projekt och en API-token. Leta sedan reda på projektets ID ovanför transkriptionslistan.

Obs! Både projekt-ID:t och API-token är skiftlägeskänsliga. Förfrågningar till API:et måste göras via HTTPS. Anrop via vanlig HTTP kommer att misslyckas. API-förfrågningar utan autentisering kommer också att misslyckas.

Du kan enkelt fylla i ditt projekt-ID och din token här, så använder vi dem i exemplen nedan i stället för platshållare.

Projekt-ID

API-token

Bas-URL

https://freezetale.com/api

Autentiserad begäran

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

Skapa en transkribering

Starta ett nytt transkriberingsjobb. Identiska förfrågningar dedupliceras automatiskt.

Se språk som stöds för koder att använda i 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"

Exempelsvar

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

Hämta en transkribering

Hämta ett transkriberingsjobb med dess ID.

När transkriberingsjobbet är klart ändras dess status till completed. Dessutom anges resultUrl som en URL som innehåller resultatet av transkriberingen och andra metadata, vilka sedan kan laddas ned.

Svaret innehåller en Last-Modified—header som du kan använda när du frågar API:et efter uppdateringar med hjälp av 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"

Exempelsvar

{
	"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 ha något av följande värden: pending, errored, timeout, cancelled, completed.

Exempelsvar

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

Obs! Alla tidsvärden anges i millisekunder.

Hämta alla transkriberingar

Hämta en lista över alla transkriberingsjobb i ett projekt.

GET /v1/app/transcriptions

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

Exempelsvar

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

Språk som stöds

Freezetale stöder följande språk. Om du vill se att ett språk läggs till kan du höra av dig.

Språk	Kod	Stöder talaridentifiering
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

Gränser

Dina API-förfrågningar är begränsade utifrån detaljerna i din prenumerationsplan. I övrigt gäller följande allmänna begränsningar:

Maximal filstorlek: 1024 MB
Maximal ljudlängd: 180 minuter

100 % förnybar?

Även om Freezetales datacenter finns i Norge, är våra GPU:er för transkribering placerade i och drivs av Islands elnät, som till 100 % består av förnybar vattenkraft och geotermisk energi. Detta gör det möjligt för oss att leverera transkriberingar med ett nästintill noll koldioxidavtryck och samtidigt fullt ut följa EU:s allmänna dataskyddsförordning (GDPR).

En produkt från Nattskiftet

•

Tillverkad i Norge

Kontakt•Integritetspolicy•Användarvillkor•Swedish