API-referens

Skapa en transkribering

Förvandla vilken publikt lagrad mediefil som helst till korrekta, tidsstämplade undertexter utan att någon öppnar studion — mata ditt CMS, arkiv eller publiceringsflöde direkt.

Exakt ett av source_url och upload_id krävs.

Mediets längd kontrolleras innan anropet accepteras; plånboken debiteras och jobbet köläggs i ett atomärt steg. Returnerar 201 med transkriberingsresursen.

Krediter: 4 krediter per påbörjad minut media, debiteras när jobbet accepteras. Misslyckade jobb återbetalas automatiskt.

curl -X POST https://api.inwista.ai/v1/transcriptions \
  -H "Authorization: Bearer inw_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "source_url": "https://cdn.example.com/interview.mp4",
    "language": "en",
    "diarization": true
  }'

{
  "id": "aB3dE9f2…",
  "object": "transcription",
  "status": "processing",
  "progress": 50,
  "language": "en",
  "duration_seconds": 1834,
  "diarization": true,
  "store_media": true,
  "retention": "standard",
  "source_url": "https://cdn.example.com/interview.mp4",
  "upload_id": null,
  "temperature": 0,
  "metadata": { "internal_ref": "case-42" },
  "credits_charged": 124,
  "error": null,
  "created": 1754558000
}

Lista transkriberingar

Stäm av din katalog mot bearbetade jobb eller bygg en dashboard över allt du har transkriberat.

API-skapade transkriberingar, nyast först. Standardpaginering.

Krediter: Gratis.

curl "https://api.inwista.ai/v1/transcriptions?limit=10" \
  -H "Authorization: Bearer inw_live_…"

Hämta en transkribering

Både förloppspollning och slutresultat: se status slå om till completed och läs sedan längd, språk och debitering ur samma svar.

Polla tills status är completed (eller registrera en webhook, se nedan). Att läsa en misslyckad transkribering utlöser även dess automatiska återbetalning.

Krediter: Gratis.

curl https://api.inwista.ai/v1/transcriptions/aB3dE9f2… \
  -H "Authorization: Bearer inw_live_…"

{
  "id": "aB3dE9f2…",
  "object": "transcription",
  "status": "processing",
  "progress": 50,
  "language": "en",
  "duration_seconds": 1834,
  "diarization": true,
  "store_media": true,
  "retention": "standard",
  "source_url": "https://cdn.example.com/interview.mp4",
  "upload_id": null,
  "temperature": 0,
  "metadata": { "internal_ref": "case-42" },
  "credits_charged": 124,
  "error": null,
  "created": 1754558000
}

Radera en transkription

Radera ett jobb på begäran — full kontroll över era data i ett enda anrop.

Raderar transkriptionen permanent med allt som lagrats för den: mediefiler, transkriptionsinnehåll, revisioner, översättningar och kommentarer. Aggregerade faktureringsräknare behålls — de innehåller inget innehåll.

Endast slutförda eller misslyckade jobb kan raderas; ett jobb som fortfarande bearbetas returnerar 409, liksom ett med en pågående förbättring eller översättning. Raderingen är omedelbar och kan inte ångras.

Krediter: endpoints.delete-transcription.pricing

curl -X DELETE https://api.inwista.ai/v1/transcriptions/aB3dE9f2… \
  -H "Authorization: Bearer inw_live_…"

{
  "id": "aB3dE9f2…",
  "object": "transcription",
  "deleted": true
}

Hämta undertexter

Hämta sändningsklara undertextfiler rakt in i din spelare, ditt MAM eller ditt leveransflöde — inga manuella exporter, ingen formatkonvertering på din sida. I ett videoproduktionsflöde landar färdig SRT eller VTT direkt i din NLE, ditt granskningsverktyg eller paketeringssteget i samma ögonblick som ett klipp är transkriberat.

Returnerar den råa undertextfilens innehåll med matchande Content-Type — inte inkapslat i JSON. Svarar 409 not_ready tills transkriberingen är slutförd.

Krediter: Gratis.

curl "https://api.inwista.ai/v1/transcriptions/aB3dE9f2…/captions?format=srt" \
  -H "Authorization: Bearer inw_live_…" -o interview.srt

Formatet json är ett versionerat kontrakt: { version: 1, language, segments: [{ index, start, end, text, speaker? }] } — sekunder med millisekundsprecision, fält kan bara läggas till inom en version.

Översättningar hör till den version de skapades för — översättningsresursens revision_id anger den, och versionen från en senare förbättring ärver dem inte. Skicka detta revision_id som revision för att hämta den översatta versionen.

Skapa en uppladdning

Transkribera en fil direkt från en skrivbordsapp, ett redigeringsplugin eller en privat server, utan att först behöva lägga upp den någonstans publikt.

Returnerar 201 med uppladdningsresursen. Den signerade URL:en är giltig i fyra timmar och är bunden till headrarna i upload_headers: skicka dem exakt som de returnerades i PUT-anropet, annars avvisar lagringen förfrågan. Det är length-range-headern som upprätthåller gränsen på 4 GB.

Idempotency-Key respekteras, så ett omförsök av skapandet returnerar samma uppladdning i stället för att skapa en andra plats.

Krediter: Gratis. Krediter debiteras när uppladdningen skickas in som en transkribering, till transkriberingstaxan.

# 1. Create the upload
curl -X POST https://api.inwista.ai/v1/uploads \
  -H "Authorization: Bearer inw_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "filename": "interview.m4a", "content_type": "audio/mp4" }'

# 2. PUT the file to upload_url with upload_headers
curl -X PUT "<upload_url>" \
  -H "Content-Type: audio/mp4" \
  -H "x-goog-content-length-range: 0,4294967296" \
  -H "x-goog-if-generation-match: 0" \
  --data-binary @interview.m4a

# 3. Submit it
curl -X POST https://api.inwista.ai/v1/transcriptions \
  -H "Authorization: Bearer inw_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "upload_id": "7hKq2mZp…", "language": "en" }'

{
  "id": "7hKq2mZp…",
  "object": "upload",
  "status": "pending",
  "filename": "interview.m4a",
  "content_type": "audio/mp4",
  "size_bytes": 84213770,
  "transcription_id": null,
  "created": 1754558000,
  "upload_url": "https://storage.googleapis.com/…",
  "upload_method": "PUT",
  "upload_headers": {
    "Content-Type": "audio/mp4",
    "x-goog-content-length-range": "0,4294967296",
    "x-goog-if-generation-match": "0"
  },
  "upload_url_expires_at": 1754572400
}

Ljud räcker för transkribering: exporterar du bara ljudspåret håller sig en långfilm under 100 MB.

En uppladdning blir exakt en transkribering. Skickas den in igen svarar API:et 409 upload_already_used.

Hämta en uppladdning

Kontrollera om en fil har skickats in ännu och vilken transkribering den blev.

Uppladdningsresursen utan engångsfälten för uppladdning. status visar consumed och transcription_id sätts när uppladdningen har skickats in.

Krediter: Gratis.

curl https://api.inwista.ai/v1/uploads/7hKq2mZp… \
  -H "Authorization: Bearer inw_live_…"

{
  "id": "7hKq2mZp…",
  "object": "upload",
  "status": "consumed",
  "filename": "interview.m4a",
  "content_type": "audio/mp4",
  "size_bytes": 84213770,
  "transcription_id": "aB3dE9f2…",
  "created": 1754558000
}

Starta en förbättring

Tajming och radbalansering i sändningsklass på autopilot — leverera undertexter som klarar QC utan att en redaktör rör dem. För produktionsbolag automatiserar detta konformeringen av undertexter i leveransflödet: varje avsnitt lämnar huset med konsekventa undertexter som följer specen.

Returnerar 202 med förbättringsresursen.

Krediter: Beräknas utifrån undertextinnehållets storlek till samma taxa som studion tar, dras när jobbet accepteras. Återbetalas automatiskt vid fel.

curl -X POST https://api.inwista.ai/v1/transcriptions/aB3dE9f2…/enhance \
  -H "Authorization: Bearer inw_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "settings": { "maxCharactersPerLine": 37, "textCondensation": "smart" } }'

{
  "id": "rev8Xk3…",
  "object": "enhancement",
  "transcription_id": "aB3dE9f2…",
  "status": "processing",
  "progress": 0,
  "credits_charged": 12,
  "error": null,
  "created": 1754559000
}

Hämta en förbättring

Pollning och resultat i ett: när status visar completed serverar captions-endpointen redan den förbättrade versionen.

Polla tills completed. Att läsa en misslyckad förbättring utlöser dess automatiska återbetalning.

Krediter: Gratis.

curl https://api.inwista.ai/v1/transcriptions/aB3dE9f2…/enhancements/rev8Xk3… \
  -H "Authorization: Bearer inw_live_…"

Starta en översättning

Ett anrop per språk förvandlar ett färdigt undertextspår till en lokaliserad version med identisk tajming — mångfaldiga räckvidden för varje video du redan har.

Returnerar 202. Svarar 409 translation_exists om språket redan finns för den aktuella versionen.

Krediter: Beräknas utifrån undertextinnehållets storlek till samma taxa som studion tar, per målspråk, dras vid accept. Återbetalas automatiskt vid fel.

curl -X POST https://api.inwista.ai/v1/transcriptions/aB3dE9f2…/translate \
  -H "Authorization: Bearer inw_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "target_language": "es" }'

{
  "id": "es",
  "object": "translation",
  "transcription_id": "aB3dE9f2…",
  "target_language": "es",
  "revision_id": "TRkf2nY7…",
  "status": "processing",
  "progress": 0,
  "credits_charged": 6,
  "error": null,
  "created": 1754559600
}

Hämta en översättning

Pollning och resultat i ett: när den är completed hämtar du den översatta undertextfilen från captions-endpointen med parametern language.

Polla tills completed och hämta sedan de översatta undertexterna från captions-endpointen med query-parametern language.

Krediter: Gratis.

# Poll the translation resource
curl https://api.inwista.ai/v1/transcriptions/aB3dE9f2…/translations/es \
  -H "Authorization: Bearer inw_live_…"

# Once completed, fetch the translated subtitle file
curl "https://api.inwista.ai/v1/transcriptions/aB3dE9f2…/captions?format=vtt&language=es" \
  -H "Authorization: Bearer inw_live_…" -o interview-es.vtt