Dokumentasjon

Freezetale er ein lynrask tale-til-tekst-API-teneste med base i Noreg, som nyttar straum frå Islands 100 % fornybare vass- og geotermiske energinett.

Med automatisk talardiarisering (talaretikettar) klart til bruk for alle språk, er Freezetale den perfekte løysinga for alle dine behov for tale-til-tekst.

Tilkopling og autorisering

For å bruke Freezetale-API-ane, lag først eit prosjekt og ein API-token. Deretter finn du ID-en til prosjektet ditt ovanfor transkripsjonslista.

Merk: Både prosjekt-ID og API-token er skiljeteiknsensitive. Føresegner mot API-et må sendast over HTTPS. Føresegner sendt over vanleg HTTP vil feile. API-føresegner utan autentisering vil òg feile.

Praktisk kan du fylle inn prosjekt-ID og token her, og vi bruker dei i døma nedanfor i staden for plasshaldarar.

Prosjekt-ID

API-nøkkel

Base-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 ei transkripsjon

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

Sjå støtta språk for kodar som skal nyttast 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"

Døme 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 ein transkripsjon

Hent ein transkripsjonsjobb ved hjelp av ID-en.

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

Svaret inneheld ein Last-Modified header som du kan bruke når du pingar API-et for å sjekke etter oppdateringar 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"

Døme 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"

Døme 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 ønskjer at eit språk skal bli lagt til, ver venleg å ta 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

Grenser

API-forespørslane dine er avgrensa ut frå detaljane i abonnementet ditt. Elles er dette dei generelle grensene:

Maksimal filstorleik: 1024 MB
Maksimal lydlengd: 180 minutt

100 % fornybar?

Selv om Freezetales datasenter ligg i Noreg, er GPU-ane som køyrer transkripsjonane våre plasserte på Island og drivne av 100 % fornybar vass- og geotermisk energi frå Island. Dette gjer at vi kan levere transkripsjonar med nærast null karbonavtrykk, og samstundes vere fullt ut i samsvar med EUs personvernforordning (GDPR).

Eit produkt frå Nattskiftet

•

Laga i Noreg

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