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.

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",
  "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",
  "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.

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