Dokumentaatio

Freezetale on salamannopea puheesta tekstiksi -API-palvelu, joka on isännöity Norjassa ja jonka toimintaa tukee Islannin 100 % uusiutuvaa vesivoimaa ja geotermistä energiaa hyödyntävä sähköverkko.

Koska automaattinen puhujien diarisaatio (puhujatunnisteet) on käyttövalmiina kaikille kielille, Freezetale on täydellinen ratkaisu kaikkiin puheesta tekstiksi liittyviin tarpeisiisi.

Yhteys ja valtuutus

Käyttääksesi Freezetale-palvelun API:n, luo ensin projekti ja API-avain. Etsi sen jälkeen projektisi ID transkriptioiden listan yläpuolelta.

Huom: Sekä projektin ID että API-avain ovat kirjainkoolle herkkiä. API-kutsut on tehtävä HTTPS-yhteyden kautta. Tavallisella HTTP:llä tehdyt kutsut epäonnistuvat. Myös ilman todennusta tehdyt API-kutsut epäonnistuvat.

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

Projektin tunnus

API-avain

Perus-URL

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 transkriptiotehtävä. Järjestelmä poistaa automaattisesti identtiset pyynnöt.

Katso tuetut kielet nähdäksesi koodit, joita käytetään kohdassa 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 ID:n perusteella.

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

Vastauksessa on Last-Modified-otsake, jota voit käyttää pingatessasi APIa 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 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 aika-arvot ovat millisekunteina.

Hae kaikki transkriptiot

Hae luettelo kaikista projektin transkriptiotöistä.

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, että lisäisimme jonkin kielen, 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ösi ovat rajoitettuja tilaussuunnitelmasi yksityiskohtien perusteella. Muutoin nämä ovat yleiset rajoitukset:

Tiedoston enimmäiskoko: 1024 MB
Äänitteen enimmäiskesto: 180 minuuttia

100 % uusiutuvaa?

Vaikka Freezetalen datakeskus sijaitsee Norjassa, transkriptioiden ajoon käytettävät GPU:t sijaitsevat Islannissa ja saavat virtansa Islannin 100‑prosenttisesti uusiutuvasta vesi‑ ja geotermisestä energiaverkosta. Tämän ansiosta voimme toimittaa transkriptioita lähes nollahiilijalanjäljellä ja olla myös täysin EU:n yleisen tietosuoja-asetuksen (GDPR) mukaisia.

Tuote yritykseltä Nattskiftet

•

Valmistettu Norjassa

Ota yhteyttä•Tietosuojaseloste•Käyttöehdot•Finnish