Dokumentasjon

Freezetale er en lynrask tale-til-tekst API-tjeneste hostet i Norge, drevet av Islands 100 % fornybare vannkraft- og geotermiske energikilder.

Med automatisk talerdiarisering (taleretiketter) støttet som standard for alle språk, er Freezetale den perfekte løsningen for alle dine tale-til-tekst-behov.

Tilkobling og autorisasjon

For å bruke Freezetale API-ene må du først opprette et prosjekt og et API-token. Deretter finner du ID-en til prosjektet ditt over transkripsjonslisten.

Merk: Både prosjekt-ID-en og API-tokenet skiller mellom store og små bokstaver. Forespørsler mot API-et må gjøres over HTTPS. Anrop som gjøres over vanlig HTTP vil feile. API-forespørsler uten autentisering vil også feile.

For enkelhets skyld kan du fylle inn prosjekt-ID og token her, så bruker vi dem i eksemplene nedenfor i stedet for plassholdere.

Prosjekt-ID

API-nøkkel

Base-URL

https://freezetale.com/api

Autentisert forespørsel

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

Opprett en transkripsjon

Start en ny transkripsjonsjobb. Fjerner automatisk duplikate forespørsler.

Se støttede språk for koder til bruk 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"

Eksempelrespons

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

Hent en transkripsjonsjobb ved hjelp av ID-en.

Når transkripsjonsjobben er ferdig, endres status til completed. I tillegg blir resultUrl satt til en URL som inneholder transkripsjonsresultatet og annen metadata, som deretter kan lastes ned.

Responsen inneholder en Last-Modified header som du kan bruke når du pinger API-et for oppdateringer ved å bruke 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"

Eksempelrespons

{
	"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 av følgende verdier: pending, errored, timeout, cancelled, completed.

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

Merk: Alle tidsverdier er i millisekunder.

Hent alle transkripsjoner

Hent en liste over alle transkripsjonsjobber i et prosjekt.

GET /v1/app/transcriptions

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

Eksempelrespons

{
	"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øttede språk

Freezetale støtter følgende språk. Hvis du ønsker å få et språk lagt til, vennligst ta kontakt.

Språk	Kode	Stø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

Grenser

Dine API-forespørsler er begrenset ut fra detaljene i abonnementet ditt. Ellers er dette de generelle begrensningene:

Maksimal filstørrelse: 1024 MB
Maksimal lydlengde: 180 minutter

100 % fornybar?

Selv om Freezetales datasenter ligger i Norge, er GPU-ene som kjører transkripsjonene våre plassert i og drevet av Islands 100 % fornybare vann- og geotermiske energinett. Dette gjør at vi kan levere transkripsjoner med nærmest null karbonavtrykk, og samtidig være fullt i samsvar med EUs personvernforordning (GDPR).

Et produkt fra Nattskiftet

•

Laget i Norge

Kontakt•Personvernerklæring•Vilkår for bruk•Norwegian (Bokmål)