Skjölun

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

Með sjálfvirkri talaraðgreiningu (talaramerkingar) sem fylgja með fyrir öll tungumál, er Freezetale fullkomin lausn fyrir allar þínar tal-til-texta þarfir.

Tenging og heimild

Til að nota Freezetale API-ana, búðu fyrst til verkefni og API-aðgangstákni. Finndu síðan auðkennið (ID) verkefnisins þíns fyrir ofan umskriftalistann.

Athugið: Því bæði verkefnaauðkennið og API-aðgangstáknið gera greinarmun á há- og lágstöfum. Fyrirspurnir til API-sins verða að fara yfir HTTPS. Köll sem gerð eru yfir HTTP munu mistakast. API-fyrirspurnir án auðkenningar munu einnig mistakast.

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

Verkefnisauðkenni

API-lykill

Grunn-URL

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 sömu beiðnum.

Sjá stuðningsmál 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 umskriftarverkefni eftir auðkenni þess.

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

Svarið inniheldur Last-Modified haus sem þú getur notað þegar þú biður 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 niðurstöðusvar

{
	"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 umritunarverk í 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 talaraað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-beiðnir þínar eru takmarkaðar miðað við áskriftaráætlunina þína. Að öðru leyti gilda eftirfarandi 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 sjá um umritunarvinnsluna staðsettir á Íslandi og knúnir af 100% endurnýjanlegu vatns- og jarðvarmaorkukerfi. Þetta gerir okkur kleift að skila umritunum með nær núlli kolefnisspori og vera einnig í fullu samræmi við Almenna persónuverndarreglugerð Evrópusambandsins (GDPR).

Vara frá Nattskiftet

•

Gert í Noregi

Samband•Persónuverndarstefna•Notkunarskilmálar•Icelandic