Dokumentasjon

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

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

Tilkobling og autorisering

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

Merk: Både prosjekt-ID og API-token er følsomme for store og små bokstaver. Forespørsler mot API-et må gjøres over HTTPS. Kall gjort over vanlig HTTP vil mislykkes. API-forespørsler uten autentisering vil også mislykkes.

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-token

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 duplikater av identiske forespørsler.

Se støttede språk for koder som kan brukes 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 resultatet av transkripsjonen og annen metadata, som deretter kan lastes ned.

Responsen inneholder en Last-Modified header som du kan bruke når du spør API-et om 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 at et språk skal legges 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

API-forespørslene dine er begrenset av detaljene i abonnementsplanen din. Ellers gjelder disse generelle begrensningene:

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

100 % fornybar?

Mens Freezetales datasenter ligger i Norge, er våre GPU-er for transkripsjonskjøringer lokalisert i Island og drevet av Islands 100 % fornybare vannkraft- 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•Personvern•Vilkår for bruk•Norwegian (Bokmål)