Dokumentasjon

Freezetale er ein lynrask API-teneste for tale-til-tekst, hosta i Noreg og får energien sin frå Islands 100 % fornybare vass- og geotermiske kraft.

Med automatisk talardiarisering (talarmarkeringar) støtta som standard for alle språk, er Freezetale den perfekte løysinga for alle dine tale-til-tekst-behov.

Tilkopling og autorisering

For å bruke Freezetale-API-ane, opprett først eit prosjekt og eit API-token. Finn deretter ID-en til prosjektet ditt over transkripsjonslista.

Merk: Både prosjekt-ID-en og API-tokenet er følsame for store og små bokstavar. Førespurnader mot API-et må sendast over HTTPS. Anrop gjort over vanleg HTTP vil feile. API-forespurnader utan autentisering vil òg feile.

For enkelheits skuld kan du fylle inn prosjekt-ID-en og tokenet ditt her, så brukar vi dei i døma nedanfor i staden for plasshaldarar.

Prosjekt-ID

API-token

Grunnleggjande URL

https://freezetale.com/api

Autentisert førespurnad

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

Opprett ein transkripsjon

Start ein ny transkripsjonsjobb. Fjernar automatisk duplikatar av identiske førespurnader.

Sjå støtta språk for kodar som skal brukast 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 ei transkripsjon

Hent ein transkripsjonsjobb ved hjelp av ID-en.

Når transkripsjonsjobben er ferdig, endrar status seg til completed. I tillegg blir resultUrl sett til ein URL som inneheld resultatet av transkripsjonen og andre metadata, som deretter kan lastast ned.

Svaret inneheld ein Last-Modified header som du kan bruke når du pingar API-et for oppdateringar ved hjelp av 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 vere ein av følgjande verdiar: 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 tidsverdiar er i millisekund.

Hent alle transkripsjonar

Hent ei liste over alle transkripsjonsjobbar i eit 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øtta språk

Freezetale støttar følgjande språk. Om du vil at eit språk skal bli lagt til, ta gjerne kontakt.

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

Grensar

API-forespurnadene dine er avgrensa ut frå detaljane i abonnementet ditt. Elles er dette dei generelle grenseverdiane:

Maksimal filstorleik: 1024 MB
Maksimal lydlengd: 180 minutt

100 % fornybart?

Sjølv om Freezetale sitt datasenter er i Noreg, er GPU‑ane som køyrer transkripsjonane våre lokalisert i, og drivne av, Island sitt 100 % fornybare vasskraft- og geotermiske energinett. Dette gjer at vi kan levere transkripsjonar med nær sagt null karbonavtrykk, og òg vere fullt i samsvar med EUs personvernforordning (GDPR).

Eit produkt frå Nattskiftet

•

Laga i Noreg

Kontakt•Personvernerklæring•Bruksvilkår•Norwegian (Nynorsk)