Skjöl

Freezetale er ofurhrað API fyrir umritun talmáls í texta, hýst í Noregi og knúið af 100% endurnýjanlegri vatns- og jarðvarmaorku Íslands.

Með sjálfvirkri aðgreiningu ræðumanna (merkingar um hver talar) sem er innbyggð fyrir öll tungumál, er Freezetale fullkomin lausn fyrir allar þínar tal-til-texta þarfir.

Tenging og heimild

Til að nota Freezetale-API-ana skaltu fyrst búa til verkefni og API-lykil. Síðan finndu auðkenni verkefnisins (ID) fyrir ofan umritalistann.

Athugið: Bæði verkefnis-ID og API-lykill greina á milli stórra og litla stafa. Fyrirspurnir til API verða að fara yfir HTTPS. Köll yfir venjulegt HTTP munu mistakast. API-fyrirspurnir án auðkenningar munu einnig mistakast.

Þægilegt er að fylla inn verkefnis-ID og lykil hér, og við munum nota þau í dæmunum hér að neðan í stað staðgengla.

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. Kerfið fjarlægir sjálfkrafa tvítekningar af samstæðum beiðnum.

Sjá studd tungumál fyrir kóða til 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 talgreiningarverkefninu er lokið breytist status í completed. Einnig er resultUrl stillt á slóð sem inniheldur niðurstöðu talgreiningarinnar og önnur lýsigögn, sem síðan er hægt að hlaða niður.

Svarið inniheldur Last-Modified haus sem þú getur notað þegar þú kallar á API-ið til að athuga 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 svarsnið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

Sækja 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 ræðumanna
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-beiðnir þínar eru takmarkaðar samkvæmt skilmálum áskriftar þinnar. Að öðru leyti gilda eftirfarandi almennu takmörk:

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

100% endurnýjanlegt?

Þó gagnamiðstöð Freezetale sé í Noregi eru GPU-tækin sem keyra umskriftarvinnsluna staðsett á Íslandi og knúin af 100% endurnýjanlegri vatns- og jarðvarmaorku. Þetta gerir okkur kleift að afhenda umskriftir með nánast engu kolefnisspori og vera í fullu samræmi við almennu persónuverndarreglugerð ESB (GDPR).

Vara frá Nattskiftet

•

Gert í Noregi

Samband•Persónuverndarstefna•Notkunarskilmálar•Icelandic