Dokumentaatio

Freezetale on Norjassa isännöity salamannopea puheentunnistuksen API-palvelu, jonka käyttövoimana on Islannin 100-prosenttisesti uusiutuvaa vesi- ja geotermistä energiaa hyödyntävä sähköverkko.

Automaattisen puhujantunnistuksen (puhujatunnisteet) tuella kaikilla kielillä Freezetale on täydellinen ratkaisu kaikkiin puheentunnistustarpeisiisi.

Yhteys ja valtuutus

Freezetale API-rajapintojen käyttämiseksi luo ensin projekti ja API-tunniste. Etsi sitten projektisi tunnus transkriptioluettelon yläpuolelta.

Huomautus: Sekä projektin tunnuksessa että API-tunnisteessa kirjainkoolla on merkitystä. API-rajapintaan tehtävät pyynnöt on lähetettävä HTTPS-yhteyden kautta. Tavallisen HTTP:n kautta tehdyt kutsut epäonnistuvat. Myös API-pyynnöt ilman todennusta epäonnistuvat.

Voit kätevästi syöttää projektisi tunnuksen ja tunnisteen tähän, jolloin käytämme niitä alla olevissa esimerkeissä paikkamerkkien sijaan.

Projektin tunnus

API-tunnus

Perus-URL-osoite

https://freezetale.com/api

Todennettu pyyntö

curl -X GET \
-H "Authorization: Bearer API_TOKEN" \
"https://freezetale.com/api/v1/app/transcriptions?project-id=PROJECT_ID"

Luo transkriptio

Aloita uusi transkriptiotyö. Identtiset pyynnöt poistetaan automaattisesti päällekkäisyyksien välttämiseksi.

Katso tuetut kielet saadaksesi koodit, joita käytetään language-kentässä.

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"

Esimerkkivastaus

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

Hae litterointi

Hae litterointityö sen tunnisteen perusteella.

Kun litterointityö on valmis, sen status muuttuu arvoksi completed. Lisäksi resultUrl asetetaan osoitteeseen, joka sisältää litteroinnin tuloksen ja muita metatietoja, jotka voidaan sen jälkeen ladata.

Vastaus sisältää Last-Modified-otsakkeen, jota voit käyttää kysellessäsi API:lta päivityksiä If-Modified-Since-otsakkeen avulla.

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"

Esimerkkivastaus

{
	"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 voi olla yksi seuraavista arvoista: pending, errored, timeout, cancelled, completed.

Esimerkkivastaus tuloksesta

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

Huomautus: Kaikki aika-arvot ilmoitetaan millisekunteina.

Hae kaikki litteroinnit

Hae projektin kaikki litterointityöt sisältävä luettelo.

GET /v1/app/transcriptions

curl -X GET \
-H "Authorization: Bearer API_TOKEN" \
"https://freezetale.com/api/v1/app/transcriptions?project-id=PROJECT_ID"

Esimerkkivastaus

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

Tuetut kielet

Freezetale tukee seuraavia kieliä. Jos haluat, että palveluun lisätään jokin kieli, ota yhteyttä.

Kieli	Koodi	Tukee puhujien erottelua
English	en	Kyllä
Danish	da	Kyllä
German	de	Kyllä
Spanish	es	Kyllä
Finnish	fi	Kyllä
French	fr	Kyllä
Icelandic	is	Kyllä
Dutch	nl	Kyllä
Norwegian (Nynorsk)	nn	Kyllä
Norwegian (Bokmål)	no	Kyllä
Swedish	sv	Kyllä

Rajoitukset

API-pyyntöjesi määrät on rajoitettu tilauksesi tietojen perusteella. Muutoin voimassa ovat seuraavat yleiset rajoitukset:

Tiedoston enimmäiskoko: 1024 Mt
Äänitiedoston enimmäispituus: 180 minuuttia

100 % uusiutuvaa?

Vaikka Freezetalen datakeskus sijaitsee Norjassa, litterointiin käytettävät grafiikkaprosessorit sijaitsevat Islannissa ja saavat energiansa Islannin 100-prosenttisesti uusiutuvasta vesi- ja geotermisestä energiasta koostuvasta sähköverkosta. Näin voimme tuottaa litterointeja lähes olemattomalla hiilijalanjäljellä ja noudattaa täysin EU:n yleistä tietosuoja-asetusta (GDPR).

Nattskiftetin tuote Nattskiftet

•

Valmistettu Norjassa

Yhteystiedot•Tietosuojakäytäntö•Käyttöehdot•Finnish