Dokumentaatio

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

Automaattisen puhujantunnistuksen (puhujien merkinnät) ollessa tuettuna suoraan kaikilla kielillä Freezetale on täydellinen ratkaisu kaikkiin puheesta tekstiksi -tarpeisiisi.

Yhteys ja valtuutus

Freezetale-rajapintojen käyttöä varten luo ensin projekti ja API-tunnus. Etsi sitten projektisi tunnus transkriptioiden luettelon yläpuolelta.

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

Voit kätevästi syöttää projektisi tunnuksen ja API-tunnuksen 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 litterointityö. Samat pyynnöt käsitellään automaattisesti vain kerran.

Katso tuetut kielet kohdasta language käytettävät koodit.

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 URL-osoitteeksi, joka sisältää litteroinnin tuloksen ja muita metatietoja, jotka voidaan 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.

Esimerkkituloksen vastaus

{
	"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 ovat millisekunteina.

Hae kaikki transkriptiot

Hae kaikki projektin litterointitehtävä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ä jokin kieli lisätään, 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öjäsi rajoitetaan tilauspakettisi tietojen perusteella. Muussa tapauksessa voimassa ovat seuraavat yleiset rajoitukset:

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

100 % uusiutuvaa?

Vaikka Freezetalen palvelinkeskus sijaitsee Norjassa, transkriptioiden käsittelyyn käytettävät GPU:t sijaitsevat Islannissa, ja ne saavat virtansa Islannin 100-prosenttisesti uusiutuvalla vesi- ja geotermisellä energialla toimivasta sähköverkosta. Näin voimme tuottaa transkriptioita 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