Dokumentaatio

Freezetale on salamannopea puheesta tekstiksi -API-palvelu, jota isännöidään Norjassa ja jonka laskentaa pyörittää Islannin 100-prosenttisesti uusiutuva vesivoima ja geoterminen energia.

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 Freezetalen API:ja, luo ensin projekti ja API-tunnus. Sitten löydät projektisi ID:n transkriptioiden listan yläpuolelta.

Huom: sekä projektin ID että API-tunnus erottelevat isot ja pienet kirjaimet. API-kutsut on tehtävä HTTPS-yhteyden kautta. Pelkän HTTP:n kautta tehdyt pyynnöt epäonnistuvat. Myös ilman todennusta tehdyt API-pyynnöt epäonnistuvat.

Voit kätevästi täyttää projektisi ID:n ja tunnuksen tässä, 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 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 transkriptio on valmis, sen status muuttuu arvoksi completed. Myös 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äen 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.

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 ajan arvot 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, 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 rajoittuvat tilaussuunnitelmasi yksityiskohtien mukaan. Muuten nämä ovat yleiset rajoitukset:

Suurin tiedostokoko: 1024 MB
Äänitiedoston enimmäiskesto: 180 minuuttia

100 % uusiutuvaa?

Vaikka Freezetalen datakeskus sijaitsee Norjassa, transkriptioiden ajonaikaiset GPU:t sijaitsevat Islannissa ja saavat energiansa Islannin 100 % uusiutuvasta vesivoima- ja geotermisestä energiaverkostosta. Tämä mahdollistaa transkriptioiden toimittamisen lähes nollahiilijalanjäljellä, ja lisäksi noudatamme täysin EU:n yleistä tietosuoja-asetusta (GDPR).

Tuote yritykseltä Nattskiftet

•

Valmistettu Norjassa

Yhteystiedot•Tietosuojaseloste•Käyttöehdot•Finnish