Dokumentasjon

Freezetale er ein lynrask tale-til-tekst API-teneste som vert hosta i Noreg, og som nyttar Islands 100 % fornybare vass- og geotermiske energi.

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

Tilkobling og autorisering

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

Merk: Både prosjekt-ID-en og API-tokenet skil mellom store og små bokstavar. Førespurnader til API-et må sendast over HTTPS. Anrop gjort over ubeskytta HTTP vil feile. API-forespurnader utan autentisering vil òg feile.

Du kan enkelt fylle inn prosjekt-ID-en og tokenet her, så nyttar vi dei i døma under 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 ein transkripsjon

Start ein ny transkripsjonsjobb. Identiske førespurnader blir automatisk slått saman.

Sjå støtta språk for kodar som kan 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 ei URL som inneheld resultatet av transkripsjonen og anna metadata, som så kan lastast ned.

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

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. Dersom du ynskjer at eit språk skal leggast 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

Grensar

API-forespørslene dine er avgrensa basert på detaljane i abonnementet ditt. Elles gjeld desse generelle grensene:

Maks filstorleik: 1024 MB
Maks lydlengd: 180 minuttar

100 % fornybar?

Sjølv om Freezetales datasenter ligg i Noreg, er GPU-ane våre som køyrer transkripsjonane plasserte i, og drivne av, Islands 100 % fornybare vass- og geotermiske energinett. 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)