Dokumentation

Freezetale är en blixtsnabb tal-till-text-API-tjänst som körs i Norge och drivs av Islands 100 % förnybara vatten- och geotermiska energinät.

Med automatisk talardiarisering (talaretiketter) som ingår som standard för alla språk, är Freezetale den perfekta lösningen för alla dina tal-till-text-behov.

Anslutning och auktorisering

För att använda Freezetales API:er, skapa ett projekt och en API-token. Därefter hittar du ID:t för ditt projekt ovanför transkriptionslistan.

Observera: Både projekt-ID och API-token är skiftlägeskänsliga. Förfrågningar mot API:et måste göras över HTTPS. Anrop som görs över vanlig HTTP kommer att misslyckas. API-förfrågningar utan autentisering kommer också att misslyckas.

För enkelhets skull kan du fylla i ditt projekt-ID och din token här, så använder vi dem i exemplen nedan istä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 transkription

Starta ett nytt transkriptionsjobb. Tar automatiskt bort dubbletter av identiska förfrågningar.

Se stödda språk 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"

Exempel på svar

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

Hämta ett transkriptionsjobb via dess ID.

När transkriptionsjobbet är klart ändras dess status till completed. Dessutom sätts resultUrl till en URL som innehåller transkriptionens resultat och annan metadata, som sedan kan laddas ner.

Svaret innehåller en Last-Modified header som du kan använda när du pingar API:et för uppdateringar med 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"

Exempel på svar

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

Exempel på svar

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

Observera: Alla tidsvärden anges i millisekunder.

Hämta alla transkriptioner

Hämta en lista över alla transkriptionsjobb 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"

Exempel på svar

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

Stödda språk

Freezetale stöder följande språk. Om du vill att ett språk ska läggas till, vänligen kontakta oss.

Språk	Kod	Stöder talardiarisering
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. Annars gäller följande allmänna begränsningar:

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

100 % förnybart?

Medan Freezetales datacenter ligger i Norge är våra transkriptions-GPU:er placerade i Island och drivs av landets 100 % förnybara vatten- och geotermiska energinät. Detta gör att vi kan leverera transkriptioner med nästintill noll koldioxidavtryck och samtidigt vara fullt förenliga med EU:s allmänna dataskyddsförordning (GDPR).

En produkt från Nattskiftet

•

Tillverkad i Norge

Kontakt•Integritetspolicy•Användarvillkor•Swedish