Skjöl

Freezetale er afar hraðvirk API-þjónusta fyrir tal-í-texta, hýst í Noregi og knúin af 100% endurnýjanlegri vatns- og jarðvarmaorku Íslands.

Með sjálfvirkri talaraðgreiningu (sem býr til talaramerkingar) fyrir öll tungumál, er Freezetale fullkomin lausn fyrir allar þínar umritunarþarfir.

Tenging og heimild

Til að nota Freezetale API-ana, búðu fyrst til verkefnis og API-tákni. Finndu síðan auðkenni (ID) verkefnisins fyrir ofan umritalistann.

Athugið: Bæði ID verkefnisins og API-táknið gera greinarmun á há- og lágstöfum. Beiðnir til API verða að fara yfir HTTPS. Beiðnir gerðar yfir venjulegt HTTP munu mistakast. Beiðnir til API án auðkenningar munu einnig mistakast.

Þægilegt er að fylla inn ID verkefnisins og tákni hér, og við munum nota þau í dæmunum hér að neðan í stað fyllingartexta.

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ýja umritunarvinnu. Kerfið fjarlægir sjálfkrafa tvítekningar af samsvarandi beiðnum.

Sjá studd tungumál fyrir kóðana 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 lýsigögn, sem síðan er hægt að hlaða niður.

Svarið inniheldur Last-Modified fyrirsögn 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ð: Allar tímatölur eru í millisekúndum.

Sækja öll umrit

Sækja lista yfir öll umskriftarverkefni í 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á

Takmarkanir

API-beiðnir þínar eru takmarkaðar miðað við upplýsingar í áskriftaráætlun þinni. Annars gilda eftirfarandi almennu takmörk:

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

100% endurnýjanleg?

Þó gagnamiðstöð Freezetale sé í Noregi eru GPU-arnir sem keyra umritunina staðsettir á Íslandi og knúnir af 100% endurnýjanlegri vatns- og jarðvarmaorku. Þetta gerir okkur kleift að skila umritunum með nær-núllu kolefnisspori og að vera jafnframt í fullu samræmi við almennu persónuverndarreglugerð ESB (GDPR).

Vara frá Nattskiftet

•

Framleitt í Noregi

Samband•Persónuverndarstefna•Notkunarskilmálar•Icelandic