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.

Nøyaktig én av source_url og upload_id er påkrevd.

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",
  "upload_id": null,
  "temperature": 0,
  "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",
  "upload_id": null,
  "temperature": 0,
  "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.

Opprett en opplasting

Transkriber en fil rett fra et skrivebordsprogram, et tillegg i et klippeprogram eller en privat server, uten å måtte legge den ut offentlig først.

Returnerer 201 med opplastingsressursen. Den signerte URL-en er gyldig i fire timer og er bundet til headerne i upload_headers: send dem nøyaktig slik de ble returnert i PUT-forespørselen, ellers avviser lagringstjenesten forespørselen. Det er length-range-headeren som håndhever grensen på 4 GB.

Idempotency-Key respekteres, så et nytt forsøk på å opprette gir samme opplasting tilbake i stedet for å lage en ny.

Kreditter: Gratis. Kreditter belastes når opplastingen sendes inn som en transkribering, etter satsen for transkribering.

# 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
}

Lyd er nok for transkribering: eksporterer du bare lydsporet, holder en spillefilm seg under 100 MB.

En opplasting blir til nøyaktig én transkribering. Sender du den inn på nytt, svarer API-et med 409 upload_already_used.

Hent en opplasting

Sjekk om en fil er sendt inn ennå, og hvilken transkribering den ble til.

Opplastingsressursen uten engangsfeltene for opplasting. status viser consumed, og transcription_id settes når opplastingen er sendt inn.

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

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