Skjöl

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

Með sjálfvirkri aðgreiningu talenda (merkingar um talendur) sem er innbyggð fyrir öll tungumál, er Freezetale fullkomin lausn fyrir allar þínar radd-til-texta þarfir.

Tenging og heimild

Til að nota Freezetale API-ana þarf fyrst að búa til verkefni og API-tákni. Finndu síðan auðkenni (ID) verkefnisins fyrir ofan umritunarlistann.

Athugið: Bæði verkefnisauðkennið (ID) og API-táknið greina á milli hástafa og lágstafa. Fyrirspurnir til API þurfa að fara fram yfir HTTPS. Köll sem gerð eru yfir venjulegt HTTP munu mistakast. Fyrirspurnir til API án auðkenningar munu einnig mistakast.

Auðveldlega getur þú fyllt inn verkefnis-ID og tákni 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. Eyðir sjálfkrafa afritum af samlíkum beiðnum.

Sjá 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"
	}
}

Fá umrit

Sækja umritunarverkefni með auðkenni þess.

Þegar umritunarverkefninu er lokið breytist status í completed. Einnig er resultUrl stillt á vefslóð (URL) sem inniheldur niðurstöðu umritunarinnar og önnur lýsigögn, sem hægt er að hlaða niður.

Svarið inniheldur Last-Modified haus sem þú getur notað við fyrirspurnir 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

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

Tungumál sem eru studd

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

Tungumál	Kóði	Styður ræðendagreiningu
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-fyrirspurnir þínar eru takmarkaðar eftir áskriftaráætlun þinni. 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ýjanleg?

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

Vara frá Nattskiftet

•

Gert í Noregi

Samband•Persónuverndarstefna•Notkunarskilmálar•Icelandic