Skjölun

Freezetale er leifturhröð tal-í-texta API-þjónusta sem hýst er í Noregi og knúin af 100% endurnýjanlegu vatnsafls- og jarðvarmaneti Íslands.

Með sjálfvirkri þátttölugreiningu (merkingum fyrir talendur) sem er innbyggð fyrir öll tungumál er Freezetale fullkomin lausn fyrir allar þarfir þínar varðandi tal í texta.

Tenging og heimildaveiting

Til að nota API-kerfi Freezetale skaltu fyrst stofna verkefni og API-tákn. Finndu síðan auðkenni verkefnisins fyrir ofan umritunarlistann.

Athugið: Bæði auðkenni verkefnisins og API-táknið eru há- og lágstafanæm. Beiðnir til API-kerfisins verða að fara yfir HTTPS. Köll yfir venjulegt HTTP munu mistakast. API-beiðnir án auðkenningar munu einnig mistakast.

Til hægðarauka geturðu slegið inn auðkenni verkefnisins og táknið hér og við notum þau í dæmunum hér að neðan í stað staðgengla.

Auðkenni verkefnis

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 umritun

Hefjið nýtt umritunarverkefni. Afritar sjálfkrafa eins beiðnir aðeins einu sinni.

Sjá studda tungumála fyrir kóða til notkunar í 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 umritun

Sæktu umritunarverk eftir auðkenni þess.

Þegar umritunarverkefninu er lokið breytist status í completed. Einnig er resultUrl stillt á vefslóð 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 þú leitar að uppfærslum hjá API-inu 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 haft 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 allar uppskriftir

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

Studd tungumál

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

Tungumál	Kóði	Styður þátttakendagreiningu.
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 í samræmi við upplýsingar áskriftaráætlunar þinnar. Að öðru leyti gilda eftirfarandi almennar takmarkanir:

Hámarksstærð skráar: 1024 MB
Hámarkslengd hljóðs: 180 mínútur

100% endurnýjanleg?

Þótt gagnaver Freezetale sé í Noregi eru GPU-kortin sem notuð eru við umritun staðsett á Íslandi og knúin af 100% endurnýjanlegu vatnsafls- og jarðvarmukerfi Íslands. Þetta gerir okkur kleift að bjóða upp á umritanir með nánast engu kolefnisspori og vera jafnframt að fullu í samræmi við almenna persónuverndarreglugerð Evrópusambandsins (GDPR).

Vara frá Nattskiftet

•

Framleitt í Noregi

Samband•Persónuverndarstefna•Notkunarskilmálar•Icelandic