Dokumentasjon

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

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, 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 skiller mellom store og små bokstaver. Forespørsler mot API-et må gjøres over HTTPS. Forespørsler gjort 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, og vi vil bruke 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. Dupliserte 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"

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

Responsen 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"

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 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 våre transkripsjons‑GPU-er plassert i, og drevet av, Islands 100 % fornybare vann- og geotermiske energikilder. 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)