Dokumentaatio

Freezetale on salamannopea puheesta tekstiksi -API-palvelu, joka on isännöity Norjassa ja jota pyörittää Islannin 100‑prosenttisesti uusiutuvaa vesivoimaa ja geotermistä energiaa hyödyntävä sähköverkko.

Koska automaattinen puhujien diarisaatio (puhujatunnisteet) on valmiiksi tuettuna kaikille kielille, Freezetale on täydellinen ratkaisu kaikkiin puheesta tekstiksi liittyviin tarpeisiisi.

Yhteys ja valtuutus

Käyttääksesi Freezetale-rajapintoja, luo ensin projekti ja API-tunnus. Etsi sitten projektisi ID transkriptioiden listan yläpuolelta.

Huom: Sekä projektin ID että API-tunnus ovat kirjainkoon huomioivia. API-pyynnöt on tehtävä HTTPS-yhteydellä. Tavalliset HTTP-pyynnöt epäonnistuvat. Myös todennusta vailla lähetetyt API-pyynnöt epäonnistuvat.

Kätevästi voit täyttää projektisi ID:n ja API-tunnuksen tähän, ja käytämme niitä alla olevissa esimerkeissä paikkamerkkien sijaan.

Projektin tunnus

API-avain

Perus-URL

https://freezetale.com/api

Autentikoitu pyyntö

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

Luo transkriptio

Aloita uusi transkriptiotehtävä. Järjestelmä poistaa automaattisesti identtiset pyynnöt.

Katso tuetut kielet saadaksesi koodit, joita käytetään 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"

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 transkriptio

Nouda transkriptiotehtävä sen ID:n perusteella.

Kun transkriptiotehtävä on valmis, sen status vaihtuu arvoksi completed. Lisäksi resultUrl asetetaan URL-osoitteeksi, joka sisältää transkription tuloksen ja muuta metatietoa, jotka voidaan sitten ladata.

Vastaus sisältää Last-Modified otsikon, jota voit käyttää pingatessasi API:ta päivitysten tarkistamiseen käyttämällä 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"

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

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

Huom: Kaikki ajat ilmoitetaan millisekunteina.

Hae kaikki transkriptiot

Hae luettelo kaikista projektin transkriptiotehtävistä.

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 haluaisit jonkin kielen lisättävän, ole hyvä ja ota yhteyttä.

Kieli	Koodi	Tukee puhujien diarisaatiota
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ä on rajoitettu tilauspakettisi ehtojen mukaan. Muuten nämä ovat yleiset rajoitukset:

Suurin tiedostokoko: 1024 MB
Suurin äänitteen kesto: 180 minuuttia

100 % uusiutuvaa?

Vaikka Freezetalen datakeskus sijaitsee Norjassa, transkriptioiden ajonaikaiset GPU:t sijaitsevat Islannissa ja ne toimivat Islannin 100-prosenttisesti uusiutuvaa vesivoima- ja geotermistä energiaa hyödyntävän sähköverkon voimalla. Tämä mahdollistaa transkriptioiden tuottamisen lähes nollahiilijalanjäljellä ja takaa myös täyden vaatimustenmukaisuuden EU:n yleisen tietosuoja-asetuksen (GDPR) kanssa.

Tuote yritykseltä Nattskiftet

•

Valmistettu Norjassa

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