Dokumentaatio

Freezetale on salamannopea puheesta tekstiksi -API-palvelu, joka isännöidään Norjassa ja jonka energia tulee Islannin 100 % uusiutuvasta vesi- ja geotermisestä energiajärjestelmästä.

Äänentunnistuksen automaattisen puhujan diarisaation (puhujatunnisteet) tuella kaikille kielille, Freezetale on täydellinen ratkaisu kaikkiin puheesta tekstiksi -tarpeisiisi.

Yhteys ja valtuutus

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

Huomautus: Sekä projektin tunnus että API-avain ovat kirjainkoon tarkkoja. API-pyynnöt on tehtävä HTTPS-yhteyden kautta. Tavallisen HTTP:n kautta tehtävät pyynnöt epäonnistuvat. Autentikoimattomat API-pyynnöt epäonnistuvat myös.

Kätevää on, että voit täyttää projektitunnuksesi ja avaimen tähän, ja käytämme niitä alla olevissa esimerkeissä paikkamerkkien sijaan.

Projektin tunnus

API-tunnus

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 tekstitys

Aloita uusi puhtaaksikirjoitustyö. Poistaa automaattisesti päällekkäiset identtiset pyynnöt.

Katsokaa tuetut kielet koodeja varten, 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"
	}
}

Hanki transkriptio

Hae transkriptiotehtävä sen tunnisteella.

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

Vastauksessa on Last-Modified -otsake, jota voit käyttää API:n päivitysten kyselyyn käyttäen If-Modified-Since:tä.

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 tuloksesta

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

Hanki luettelo kaikista projektin tekstityötehtä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 lisätä jonkin kielen, ota yhteyttä.

Kieli	Koodi	Tukee puhujan 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öjesi määrä on rajattu tilauspakettisi mukaan. Muuten nämä ovat yleiset rajoitukset:

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

100 % uusiutuvaa?

Vaikka Freezetalen datakeskus sijaitsee Norjassa, transkriptioiden suoritusajan GPU:t ovat Islannissa ja ne saavat energiansa Islannin 100 % uusiutuvasta vesivoima- ja geotermisestä energiaverkosta. Tämä mahdollistaa meille käytännössä hiilineutraalien transkriptioiden tarjoamisen sekä täyden EU:n yleisen tietosuoja-asetuksen (GDPR) noudattamisen.

Tuote yritykseltä Nattskiftet

•

Valmistettu Norjassa

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