Skjöl

Freezetale er blixthrað tal-til-texta API-þjónusta sem er hýst í Noregi og knúin af 100% endurnýjanlegu vatns- og jarðvarmaorkukerfi Íslands.

Með innbyggðum stuðningi við sjálfvirka aðgreiningu ræðumanna (rædumerkingar) fyrir öll tungumál, er Freezetale fullkomin lausn fyrir allar þarfir þínar varðandi tal-til-texta.

Tenging og heimild

Til að nota Freezetale API-ið skaltu fyrst búa til verkefni og API-tákni. Síðan finnur þú ID verkefnisins fyrir ofan umskriftalistann.

Athugið: Bæði ID verkefnisins og API-táknið eru há- og lágstafa-næm. Fyrirspurnir til API verða að vera sendar yfir HTTPS. Fyrirspurnir sendar yfir venjulegt HTTP munu mistakast. API-fyrirspurnir án auðkenningar munu einnig mistakast.

Auðveldlega getur þú fyllt inn verkefnis-ID og API-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. Fjarlægir sjálfkrafa endurtekningar af samsvarandi beiðnum.

Sjá tungumál sem við styðjum 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 sett á slóð (URL) sem inniheldur niðurstöðuna úr umrituninni 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 þú spyrð API-ið 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 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 talaraðgreiningu
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 miðað við skilmála áskriftaráætlunar þinnar. Annars eru þetta almennu mörkin:

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

100% endurnýjanlegt?

Þó gagnamiðstöð Freezetale sé í Noregi eru GPU-arnir sem keyra umritunarvinnsluna staðsettir á Íslandi og knúnir af 100% endurnýjanlegu vatns- og jarðvarmaorku landsins. Þetta gerir okkur kleift að afhenda umritanir með nánast núlli kolefnisfótspori og vera jafnframt í fullu samræmi við Almenna persónuverndarreglugerð ESB (GDPR).

Vara frá Nattskiftet

•

Framleitt í Noregi

Samband•Persónuverndarstefna•Notkunarskilmálar•Icelandic