Skjöl

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

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

Tenging og heimild

Til að nota Freezetale API-ið, stofnaðu fyrst verkefni og API-tákni. Síðan finnur þú auðkenni verkefnisins þíns fyrir ofan umritalistann.

Athugið: Bæði verkefnisauðkennið og API-táknið greina á milli há- og lágstafa. Beiðnir til API verða að vera sendar yfir HTTPS. Beiðnir sem sendar eru með venjulegu HTTP munu mistakast. API-fyrirspurnir án auðkenningar munu einnig mistakast.

Til þæginda geturðu fyllt inn verkefnisauðkennið og táknið þitt hér, og við munum nota þau í dæmunum hér fyrir 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. Sjálfkrafa fjarlægir tvítekningar af sams konar beiðnum.

Sjá stuðningstungumá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 á 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 beiðni til API-sins 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 tekið 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áðu 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ð tungumál verði 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á

Takmörk

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

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 umritunina staðsettir á Íslandi og knúnir af 100% endurnýjanlegri vatns- og jarðvarmaorku Íslands. Þetta gerir okkur kleift að skila umritunum með nánast núllu kolefnisfótspori og vera jafnframt fullkomlega í samræmi við almennu persónuverndarreglugerð Evrópusambandsins (GDPR).

Vara frá Nattskiftet

•

Gert í Noregi

Samband•Persónuverndarstefna•Notkunarskilmálar•Icelandic