Skjöl

Freezetale er eldsnögg tal‑í‑texta API‑þjónusta sem er hýst í Noregi og nýtir 100% endurnýjanlega vatns‑ og jarðvarmaorku Íslands.

Með sjálfvirkri talaraaðgreiningu (talamerkingar) sem er innbyggð fyrir öll tungumál, er Freezetale hin fullkomna lausn fyrir allar þarfir þínar varðandi ræðu‑til‑texta.

Tenging og heimild

Til að nota Freezetale API-in skaltu fyrst búa til verkefni og API-lykil. Finndu síðan auðkenni verkefnisins fyrir ofan umritalistann.

Athugið: Bæði verkefnaauðkennið og API-lykillinn greina á milli stórra og smárra stafa. Beiðnir til API verða að vera gerðar yfir HTTPS. Köll sem send eru yfir hreint HTTP munu mistakast. API-beiðnir án auðkenningar munu einnig mistakast.

Þægilega getur þú fyllt inn verkefnaauðkennið og lykilinn þinn hér, og við munum nota þau í dæmunum hér að neðan í stað staðhaldartexta.

Verkefnisauðkenni

API-lykill

Grunnslóð

https://freezetale.com/api

Staðfest 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 sams konar beiðnum.

Sjá stuðningsmál fyrir kóða sem nota má í 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 eftir auðkenni þess.

Þegar umritunarverkefninu er lokið breytist status í completed. Einnig er resultUrl stillt á slóð (URL) 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 haus sem þú getur notað þegar þú sendir API-ið fyrirspurn 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

Fá 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 að við bætum við tungumáli, 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á

Takmörk

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

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

100% endurnýjanlegt?

Þótt gagnamiðstöð Freezetale sé í Noregi, eru GPU-tölvur sem sjá um umritunarvinnslu staðsettar á Íslandi og knúnar af raforkukerfi landsins sem byggir alfarið á endurnýjanlegri vatns- og jarðvarmaorku. Þetta gerir okkur kleift að skila umritunum með nánast núllu kolefnisspori og vera jafnframt algjörlega í samræmi við persónuverndarlöggjöf ESB (GDPR).

Vara frá Nattskiftet

•

Gert í Noregi

Samband•Persónuverndarstefna•Notkunarskilmálar•Icelandic