Skjöl

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

Með sjálfvirkri talaraaðgreiningu (talaramerkingum) sem er innbyggð fyrir öll tungumál er Freezetale fullkomin lausn fyrir öll þín tal-til-texta þarfir.

Tenging og aðgangsheimild

Til að nota Freezetale API-ið skaltu fyrst búa til verkefni og API-lykil. Síðan finnur þú auðkenni verkefnisins fyrir ofan lista yfir umskriftir.

Athugið: Bæði verkefnaauðkennið og API-lykillinn eru há- og lágstafa. Beiðnir til API-ins verða að fara yfir HTTPS. Köll sem eru send yfir venjulegt HTTP munu mistakast. API-beiðnir án auðkenningar munu einnig mistakast.

Auðvelt er að fylla inn verkefnaauðkennið og lykilinn 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. Kemur sjálfkrafa í veg fyrir tvöfaldar beiðnir.

Sjá stuðningstungumál fyrir kóða til 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 á vefslóð sem inniheldur niðurstöðu umritunarinnar og önnur fylgigögn, sem hægt er 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 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

Sækja lista yfir öll umritunarverkefni í tilteknu 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 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-fyrirspurnir þínar eru takmarkaðar miðað við áskriftaráætlunina þína. Annars gilda eftirfarandi almennu takmarkanir:

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

100% endurnýjanleg?

Þó gagnaver Freezetale sé í Noregi eru GPU-arnir sem keyra umritunarúrvinnsluna staðsettir á Íslandi og knúnir af 100% endurnýjanlegu vatns- og jarðvarmaorkuneti Íslands. Þetta gerir okkur kleift að skila umritum með næstum því engu kolefnisspori og vera jafnframt í fullu samræmi við almennu reglugerð Evrópusambandsins um vernd persónuupplýsinga (GDPR).

Vara frá Nattskiftet

•

Gert í Noregi

Samband•Persónuverndarstefna•Notkunarskilmálar•Icelandic