Dokumentation

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

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

Anslutning och auktorisation

För att använda Freezetale API:er, skapa först ett projekt och en API-token. Sedan 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 ö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 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 med dess ID.

När transkriptionsjobbet är färdigt ä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 frågar API:et om 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"

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å resultat

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

Medan Freezetales datacenter ligger i Norge är våra GPU:er för transkriptionskörning placerade i Island och drivs av dess 100 % förnybara vatten- och geotermiska energinät. Det gör att vi kan leverera transkriptioner med nära 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