Dokumentaatio

Freezetale on salamannopea puheesta tekstiksi -API-palvelu, jonka palvelimet sijaitsevat Norjassa ja jonka toiminta perustuu Islannin 100-prosenttisesti uusiutuvaan vesivoimaan ja geotermiseen energiaan.

Koska automaattinen puhujien diarisointi (puhujamerkinnät) on valmiiksi tuettu kaikille kielille, Freezetale on täydellinen ratkaisu kaikkiin puheesta tekstiksi liittyviin tarpeisiisi.

Yhteys ja valtuutus

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

Huom: Sekä projektin ID että API-tunnus ovat kirjainkoosta riippuvaisia. API-pyynnöt on tehtävä HTTPS:n kautta. Tavallisella HTTP:llä tehdyt kutsut epäonnistuvat. Myös todennusta vailla olevat 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ä. Identtiset pyynnöt poistetaan automaattisesti.

Katso tuetut kielet nähdäksesi 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

Hae transkriptiotehtävä sen tunnuksella.

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

Vastauksessa on Last-Modified-otsake, jota voit käyttää, kun pingaat API:ta päivitysten tarkistamiseksi 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 jokin 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
		}
	}
}

Huom: Kaikki ajat ilmoitetaan millisekunneissa.

Hae kaikki transkriptiot

Hae luettelo kaikista projektin transkriptioista.

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 jonkin kielen lisättävä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 yksityiskohtien mukaan. Muutoin nämä ovat yleiset rajoitukset:

Suurin tiedostokoko: 1024 MB
Suurin äänitiedoston pituus: 180 minuuttia

100 % uusiutuvaa?

Vaikka Freezetalen datakeskus sijaitsee Norjassa, transkriptioiden suoritusajan GPU:t sijaitsevat Islannissa ja niiden energia tulee Islannin 100‑prosenttisesti uusiutuvasta vesi‑ ja geotermisestä sähköverkosta. Tämän ansiosta pystymme toimittamaan transkriptioita lähes nollahiilijalanjäljellä ja olemme myös täysin EU:n yleisen tietosuoja-asetuksen (GDPR) mukaisia.

Tuote yritykseltä Nattskiftet

•

Valmistettu Norjassa

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