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 API-er, opprett 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 er store-/småbokstavsfølsomme. Forespørsler mot API-et må gjøres over HTTPS. Anrop 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, og vi bruker 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. Identiske forespørsler fjernes automatisk.

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

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 transkripsjon

Hent en transkripsjonsjobb ved hjelp av ID-en.

Når transkripsjonsjobben er ferdig, endres status til completed. I tillegg settes resultUrl til en URL som inneholder resultatet av transkripsjonen og annen metadata, som deretter kan lastes ned.

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

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

Støttede språk

Freezetale støtter følgende språk. Hvis du ønsker at et språk skal legges til, ta gjerne 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 basert på detaljene i abonnementet ditt. Ellers gjelder disse generelle grensene:

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

100 % fornybar?

Mens Freezetales datasenter ligger i Norge, er våre transkripsjons-GPU-er plassert i Island og drives av Islands 100 % fornybare vann- og geotermiske energi. 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)