Skjöl

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

Með sjálfvirkri aðgreiningu ræðumanna (merkingum ræðumanna) sem fylgir með fyrir öll tungumál, er Freezetale fullkomin lausn fyrir allar þarfir þínar varðandi tal-til-texta.

Tenging og heimild

Til að nota Freezetale-API-ana, stofnaðu fyrst verkefni og búðu til API-aðgangstákni. Finndu síðan auðkenni verkefnisins þíns fyrir ofan listann yfir umritanir.

Athugasemd: Bæði verkefnaauðkennið og API-aðgangstáknið gera greinarmun á há- og lágstöfum. Beiðnir til API-sins verða að vera yfir HTTPS. Köll sem gerð eru yfir venjulegt HTTP munu mistakast. API-beiðnir án auðkenningar munu einnig mistakast.

Auðveldlega getur þú fyllt inn verkefnaauðkennið og API-aðgangstáknið hér, og við munum nota þau í dæmunum hér að neðan í stað staðgengla.

Verkefnisauðkenni

API-auðkenni

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. Fjarlægir sjálfkrafa tvítekningar af sams konar beiðnum.

Sjá studd tungumá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 á slóð (URL) sem inniheldur niðurstöðuna úr umrituninni og önnur fylgigögn, sem þá 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 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ð einhverju tungumáli, vinsamlegast hafðu samband.

Tungumál	Kóði	Styður talarað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 samkvæmt áskriftaráætluninni þinni. Annars gilda eftirfarandi almennu mörk:

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

100% endurnýjanlegt?

Þó gagnaver Freezetale sé í Noregi eru keyrslugreinar okkar fyrir umskriftir (GPU) staðsettar á Íslandi og knúnar af 100% endurnýjanlegri vatns- og jarðvarmaorku þar. Þetta gerir okkur kleift að skila umskriftum með nær-núllu kolefnisspori og vera jafnframt í fullu samræmi við reglur ESB um vernd persónuupplýsinga (GDPR).

Vara frá Nattskiftet

•

Framleitt í Noregi

Samband•Persónuverndarstefna•Notkunarskilmálar•Icelandic