Skjöl

Freezetale er hraðvirk API-þjónusta fyrir talgreiningu (speech-to-text), hýst í Noregi og knúin af 100% endurnýjanlegri vatns- og jarðhitaorku Íslands.

Með sjálfvirkri ræðendaaðgreiningu (ræðendamerkingar) innbyggðri fyrir öll tungumál, er Freezetale fullkomin lausn fyrir allar þarfir þínar við að breyta tali í texta.

Tenging og auðkenning

Til að nota Freezetale API-ana skaltu fyrst búa til verkefni og API-lykil. Finndu síðan verkefnisauðkennið fyrir ofan listann yfir umrit.

Athugið: Bæði verkefnisauðkennið og API-lykillinn eru há-/lágstafa‑háð. Fyrirspurnir til API‑ins verða að vera sendar yfir HTTPS. Fyrirspurnir sem eru sendar yfir venjulegt HTTP munu mistakast. API-fyrirspurnir án auðkenningar munu einnig mistakast.

Auðveldlega getur þú fyllt inn verkefnisauðkennið og lykilinn hér, og við munum nota þau í dæmunum hér að neðan í stað plásshalda.

Verkefnisauðkenni

API-lykill

Grunnslóð

https://freezetale.com/api

Auðkennd beiðni

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

Búa til umrit

Byrjaðu nýtt umritunarverkefni. Sjálfkrafa útilokar tvítekningar á samskonar beiðnum.

Sjáðu lista yfir tungumál sem eru studd fyrir kóða sem á að nota í 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æmi um 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"
	}
}

Sækja umrit

Sækja umritunarverkefni eftir auðkenni þess.

Þegar umritunarverkefninu er lokið breytist status í completed. Einnig er resultUrl stillt á vefslóð sem inniheldur niðurstöðu umritunarinnar og önnur metadata, sem síðan er hægt að hlaða niður.

Svarið inniheldur Last-Modified fyrirsögn sem þú getur notað þegar þú sendir beiðni til API-ins um uppfærslur með 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æmi um 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 getur verið eitt af eftirfarandi gildum: pending, errored, timeout, cancelled, completed.

Dæmi um svar með niðurstöðu

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

Athugið: Öll tímagildi eru í millisekúndum.

Sækja öll umrit

Fá lista yfir öll umritunarverkefni í verkefni.

GET /v1/app/transcriptions

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

Dæmi um 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"
		}
	]
}

Stuðningur við tungumál

Freezetale styður eftirfarandi tungumál. Ef þú vilt sjá tungumál bætt við, vinsamlegast hafðu samband.

Tungumál	Kóði	Styður aðgreiningu talenda.
English	en	Já
Danish	da	Já
German	de	Já
Spanish	es	Já
Finnish	fi	Já
French	fr	Já
Icelandic	is	Já
Dutch	nl	Já
Norwegian (Nynorsk)	nn	Já
Norwegian (Bokmål)	no	Já
Swedish	sv	Já

Takmörk

API-fyrirspurnir þínar eru takmarkaðar í samræmi við áskriftaráætlun þína. Annars gilda eftirfarandi almennu takmörk:

Hámarks skráarstærð: 1024 MB
Hámarks hljóðlengd: 180 mínútur

100% endurnýjanlegt?

Þó gagnaver Freezetale sé í Noregi eru GPU-arnir sem keyra umritunina staðsettir á Íslandi og knúnir af 100% endurnýjanlegu vatns- og jarðvarmaorkukerfi Íslands. Þetta gerir okkur kleift að skila umritunum með nánast engu kolefnisfótspori og jafnframt vera að fullu í samræmi við almennu persónuverndarreglurnar Evrópusambandsins (GDPR).

Vara frá Nattskiftet

•

Framleitt í Noregi

Samband•Persónuverndarstefna•Notkunarskilmálar•Icelandic