API-referanse

Opprett en transkribering

Gjør en hvilken som helst mediefil på nett om til presise undertekster med tidsstempler, uten at noen åpner studioet — koble API-et rett på CMS-et, arkivet eller publiseringsflyten din.

Varigheten på mediet måles før forespørselen godtas; saldoen belastes og jobben legges i kø i ett atomisk steg. Returnerer 201 med transkriberingsressursen.

Kreditter: 4 kreditter per påbegynte minutt med media, belastet når jobben godtas. Mislykkede jobber refunderes automatisk.

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
}

List opp transkriberinger

Avstem katalogen din mot behandlede jobber, eller bygg et dashbord over alt du har transkribert.

Transkriberinger opprettet via API-et, nyeste først. Standard paginering.

Kreditter: Gratis.

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

Hent en transkribering

Både fremdriftssjekk og endelig resultat: se status skifte til completed, og les deretter varighet, språk og kredittbelastning fra samme respons.

Spør jevnlig til status er completed (eller registrer en webhook, se nedenfor). Å lese en mislykket transkribering utløser også den automatiske refusjonen.

Kreditter: 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
}

Slett en transkripsjon

Slett en jobb på forespørsel — full kontroll over egne data i ett kall.

Sletter transkripsjonen permanent med alt som er lagret for den: mediefiler, transkripsjonsinnhold, revisjoner, oversettelser og kommentarer. Aggregerte faktureringstellere beholdes — de inneholder ikke innhold.

Bare fullførte eller feilede jobber kan slettes; en jobb som fortsatt behandles returnerer 409, det samme gjør en med en pågående forbedring eller oversettelse. Slettingen er umiddelbar og kan ikke angres.

Kreditter: 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
}

Hent undertekster

Hent kringkastingsklare undertekstfiler rett inn i avspilleren, MAM-systemet eller leveranseflyten din — ingen manuelle eksporter, ingen formatkonvertering på din side. I en videoproduksjonsflyt lander ferdig SRT eller VTT rett i klippeprogrammet, gjennomgangsverktøyet eller pakkesteget i det øyeblikket et klipp er transkribert.

Returnerer det rå filinnholdet med riktig Content-Type — ikke pakket inn i JSON. Svarer 409 not_ready til transkriberingen er fullført.

Kreditter: Gratis.

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

json-formatet er en versjonert kontrakt: { version: 1, language, segments: [{ index, start, end, text, speaker? }] } — sekunder med millisekundpresisjon, og felter blir bare lagt til innenfor en versjon, aldri fjernet.

Oversettelser hører til versjonen de ble laget for — oversettelsesressursens revision_id angir den, og versjonen fra en senere forbedring arver dem ikke. Send denne revision_id-en som revision for å hente den oversatte versjonen.

Start en forbedring

Timing og linjebalansering i kringkastingskvalitet, på autopilot — lever undertekster som består kvalitetskontrollen uten at noen må redigere dem manuelt. For produksjonsselskaper automatiserer dette tilpasningen av undertekster i leveranseflyten: hver episode leveres med konsekvente undertekster som følger spesifikasjonen.

Returnerer 202 med forbedringsressursen.

Kreditter: Beregnes ut fra størrelsen på undertekstinnholdet, etter samme sats som i studioet, og trekkes når jobben godtas. Refunderes automatisk ved feil.

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
}

Hent en forbedring

Statussjekk og resultat i ett: når status viser completed, leverer captions-endepunktet allerede den forbedrede versjonen.

Spør jevnlig til status er completed. Å lese en mislykket forbedring utløser den automatiske refusjonen.

Kreditter: Gratis.

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

Start en oversettelse

Ett kall per språk gjør et ferdig undertekstspor om til en lokalisert versjon med identisk timing — mangedoble rekkevidden til hver video du allerede har.

Returnerer 202. Svarer 409 translation_exists hvis språket allerede finnes for gjeldende versjon.

Kreditter: Beregnes ut fra størrelsen på undertekstinnholdet, etter samme sats som i studioet, per målspråk, og trekkes når forespørselen godtas. Refunderes automatisk ved feil.

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
}

Hent en oversettelse

Statussjekk og resultat i ett: når den er completed, henter du den oversatte undertekstfilen fra captions-endepunktet med language-parameteren.

Spør jevnlig til status er completed, og hent deretter de oversatte undertekstene fra captions-endepunktet med spørringsparameteren language.

Kreditter: 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