Dokumentation

Freezetale är en blixtsnabb tal-till-text-API-tjänst hostad i Norge, som drivs av Islands 100 % förnybara vattenkraft- och geotermiska energinät.

Med automatisk talardiarisering (etiketter för talare) som fungerar direkt för alla språk är Freezetale den perfekta lösningen för alla dina tal-till-text-behov.

Anslutning och auktorisering

För att använda Freezetales API:er, skapa först ett projekt och en API-token. Hitta sedan ID:t för ditt projekt ovanför transkriptionslistan.

Observera: Både projekt-ID och API-token är skiftlägeskänsliga. Förfrågningar till API:et måste göras över HTTPS. Anrop som görs över vanlig HTTP kommer att misslyckas. API-förfrågningar utan autentisering kommer också att misslyckas.

För enkelhets skull kan du fylla i ditt projekt-ID och din token här, och vi kommer att använda dem i exemplen nedan istället för platshållare.

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

Skapa en transkription

Starta ett nytt transkriptionsjobb. Tar automatiskt bort dubbletter av identiska förfrågningar.

Se stödda språk för koder som ska användas i 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"
Exempel på svar
{
	"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"
	}
}

Hämta en transkription

Hämta ett transkriptionsjobb med dess ID.

När transkriptionsjobbet är färdigt ändras dess status till completed. Dessutom sätts resultUrl till en URL som innehåller resultatet av transkriptionen och annan metadata, vilken sedan kan laddas ner.

Svaret innehåller en Last-Modified header som du kan använda när du pingar API:et för uppdateringar med 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"
Exempel på svar
{
	"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 kan vara ett av följande värden: pending, errored, timeout, cancelled, completed.

Exempel på svar (resultat)
{
	"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
		}
	}
}

Observera: Alla tidsvärden anges i millisekunder.

Hämta alla transkriptioner

Hämta en lista över alla transkriptionsjobb i ett projekt.

GET /v1/app/transcriptions
curl -X GET \
-H "Authorization: Bearer API_TOKEN" \
"https://freezetale.com/api/v1/app/transcriptions?project-id=PROJECT_ID"
Exempel på svar
{
	"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"
		}
	]
}

Stödda språk

Freezetale stöder följande språk. Om du vill att ett språk ska läggas till, vänligen kontakta oss.

SpråkKodStöder talardiarisering
EnglishenJa
DanishdaJa
GermandeJa
SpanishesJa
FinnishfiJa
FrenchfrJa
IcelandicisJa
DutchnlJa
Norwegian (Nynorsk)nnJa
Norwegian (Bokmål)noJa
SwedishsvJa

Gränser

Dina API-anrop begränsas utifrån detaljerna i din prenumerationsplan. I övrigt gäller följande generella gränser:

  • Maximal filstorlek: 1024 MB
  • Maximal ljudlängd: 180 minuter

100 % förnybar?

Även om Freezetales datacenter ligger i Norge, är våra GPU:er för transkriptionskörning placerade i, och drivs av, Islands 100% förnybara vatten- och geotermiska energinät. Det gör att vi kan leverera transkriptioner med nästintill noll klimatpåverkan, samtidigt som vi är fullt förenliga med EU:s allmänna dataskyddsförordning (GDPR).

En produkt från Nattskiftet
Tillverkad i Norge
KontaktIntegritetspolicyAnvändarvillkor