Dokumentation

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

Med automatisk talardiarisering (talarmärkning) som stöds 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 och API-token är skiftlägeskänsliga. Anrop mot API:t måste göras över HTTPS. Anrop som görs över vanlig HTTP kommer att misslyckas. API-anrop utan autentisering kommer också att misslyckas.

För enkelhets skull kan du fylla i ditt projekt-ID och din API-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 anrop.

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 transkriberingsjobbet är klart ändras dess status till completed. Dessutom sätts resultUrl till en URL som innehåller resultatet av transkriberingen 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:t för 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å 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 är 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 din prenumerationsplan. I övrigt gäller följande generella begränsningar:

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

100 % förnybar?

Även om Freezetales datacenter ligger i Norge är våra GPU:er för transkriptionskörning placerade på Island och drivs av landets 100 % förnybara vatten- och geotermiska energinät. Det 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