Dokumentation

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

Med automatisk talardiarisering (etiketter för talare) som stöds direkt ur lådan 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 först ett projekt och en API-token. Hitta sedan ID:t för ditt projekt ovanför transkriptionslistan.

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

Du kan bekvämt fylla i ditt projekt-ID och din token här, och 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. Avlägsnar automatiskt 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 med 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 HTTP-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å resultatrespons

{
	"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-anrop ä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örnybar?

Medan Freezetales datacenter ligger i Norge är våra GPU:er för transkription placerade på Island och drivs av Islands 100 % förnybara vatten- och geotermiska energinät. Detta gör att vi kan leverera transkriptioner med ett nästintill noll klimatavtryck 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