Dokumentation

Freezetale er en lynhurtig tale-til-tekst API-tjeneste hostet i Norge, drevet af Islands 100 % vedvarende vand- og geotermiske energiforsyning.

Med automatisk talerdiarisering (taleretiketter) understøttet som standard for alle sprog, er Freezetale den perfekte løsning til alle dine tale-til-tekst-behov.

Forbindelse og autorisation

For at bruge Freezetale API'erne skal du først oprette et projekt og et API-token. Derefter finder du ID'et på dit projekt ovenfor på transskriptionslisten.

Bemærk: Både projekt-ID'et og API-tokenet er store-/småbogstavsfølsomme. Anmodninger til API'et skal sendes over HTTPS. Kald foretaget over almindelig HTTP vil mislykkes. API-anmodninger uden autentificering vil også mislykkes.

Du kan nemt udfylde dit projekt-ID og token her, og vi bruger dem i eksemplerne nedenfor i stedet for pladsholdere.

Projekt-id

API-token

Basis-URL

https://freezetale.com/api

Autentificeret anmodning

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

Opret en transkription

Start et nyt transkriptionsjob. Fjerner automatisk dubletter af identiske forespørgsler.

Se understøttede sprog for koder, der skal bruges 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"

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

Hent en transskription

Hent en transskriptionsopgave ved hjælp af dens ID.

Når transskriptionsjobbet er færdigt, ændres dets status til completed. Derudover sættes resultUrl til en URL, der indeholder resultatet af transskriptionen og andre metadata, som derefter kan downloades.

Svaret indeholder en Last-Modified header, som du kan bruge, når du pinger API'et for opdateringer ved hjælp af 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"

Eksempel 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 være en af følgende værdier: pending, errored, timeout, cancelled, completed.

Eksempel 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
		}
	}
}

Bemærk: Alle tidsværdier er angivet i millisekunder.

Hent alle transkriptioner

Hent en liste over alle transskriptionsjobs i et projekt.

GET /v1/app/transcriptions

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

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

Understøttede sprog

Freezetale understøtter følgende sprog. Hvis du gerne vil have et sprog tilføjet, så kontakt os.

Sprog	Kode	Understøtter talerdiarisering
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

Dine API-forespørgsler er begrænset af detaljerne i dit abonnement. Ellers gælder disse generelle begrænsninger:

Maksimal filstørrelse: 1024 MB
Maksimal lydlængde: 180 minutter

100 % vedvarende?

Mens Freezetales datacenter ligger i Norge, er vores GPU'er til transkriptionskørsel placeret i og drevet af Islands 100% vedvarende vandkraft- og geotermiske energiforsyning. Det gør os i stand til at levere transkriptioner med et næsten nul CO2-aftryk og samtidig være fuldt i overensstemmelse med EU's generelle forordning om databeskyttelse (GDPR).

Et produkt fra Nattskiftet

•

Fremstillet i Norge

Kontakt•Privatlivspolitik•Brugsbetingelser•Danish