API-referentie

Een transcriptie aanmaken

Zet elk gehost mediabestand om in nauwkeurige ondertitels met tijdstempels, zonder dat iemand de studio hoeft te openen — voed je CMS, archief of publicatiepijplijn rechtstreeks.

Precies één van source_url en upload_id is verplicht.

De duur van de media wordt vastgesteld voordat het verzoek wordt geaccepteerd; het afschrijven van het tegoed en het in de wachtrij zetten van de job gebeuren in één atomaire stap. Geeft 201 terug met de transcriptie-resource.

Credits: 4 credits per begonnen minuut media, afgeschreven zodra de job wordt geaccepteerd. Mislukte jobs worden automatisch terugbetaald.

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
}

Transcripties weergeven

Stem je catalogus af op de verwerkte jobs of bouw een dashboard over alles wat je hebt getranscribeerd.

Via de API aangemaakte transcripties, nieuwste eerst. Standaardpaginering.

Credits: Gratis.

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

Een transcriptie ophalen

Zowel de voortgangspoll als het eindresultaat: zie de status omslaan naar completed en lees vervolgens de duur, taal en afgeschreven credits uit dezelfde response.

Poll tot de status completed is (of registreer een webhook, zie hieronder). Het opvragen van een mislukte transcriptie activeert ook de automatische terugbetaling.

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

Een transcriptie verwijderen

Verwijder een taak op verzoek — volledige controle over uw gegevens in één aanroep.

Verwijdert de transcriptie permanent met alles wat ervoor is opgeslagen: mediabestanden, transcriptie-inhoud, revisies, vertalingen en opmerkingen. Geaggregeerde factureringstellers blijven bewaard — ze bevatten geen inhoud.

Alleen voltooide of mislukte taken kunnen worden verwijderd; een taak die nog wordt verwerkt geeft 409, net als een met een lopende verbetering of vertaling. Verwijdering is onmiddellijk en onomkeerbaar.

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

Ondertitels ophalen

Haal uitzendklare ondertitelbestanden rechtstreeks binnen in je speler, MAM of leveringspijplijn — geen handmatige exports, geen formaatconversie aan jouw kant. In een videoproductiepijplijn valt de voltooide SRT of VTT direct in je NLE, reviewtool of packagingstap zodra een montage is getranscribeerd.

Geeft de ruwe inhoud van het ondertitelbestand terug met het bijbehorende Content-Type — niet verpakt in JSON. Antwoordt met 409 not_ready totdat de transcriptie is voltooid.

Credits: Gratis.

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

Het json-formaat is een geversioneerd contract: { version: 1, language, segments: [{ index, start, end, text, speaker? }] } — seconden met millisecondeprecisie; binnen een versie worden er alleen velden toegevoegd.

Vertalingen horen bij de versie waarvoor ze zijn gemaakt — de revision_id van de vertaalresource benoemt die, en de versie van een latere verbetering erft ze niet. Geef die revision_id door als revision om de vertaalde versie op te halen.

Een upload aanmaken

Transcribeer een bestand rechtstreeks vanuit een desktop-app, een montageplugin of een privéserver, zonder het eerst ergens publiek te hosten.

Geeft 201 terug met de upload-resource. De signed URL is vier uur geldig en is gebonden aan de headers in upload_headers: stuur ze bij de PUT precies mee zoals ze zijn teruggegeven, anders wijst de opslag het verzoek af. De length-range-header is wat de limiet van 4 GB afdwingt.

Idempotency-Key wordt gerespecteerd: een opnieuw verstuurd aanmaakverzoek geeft dezelfde upload terug in plaats van een tweede slot aan te maken.

Credits: Gratis. Credits worden afgeschreven zodra de upload als transcriptie wordt ingediend, tegen het transcriptietarief.

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

Audio is voldoende voor transcriptie: door alleen het audiospoor te exporteren blijft een speelfilm onder de 100 MB.

Een upload wordt precies één transcriptie. Opnieuw indienen antwoordt met 409 upload_already_used.

Een upload ophalen

Controleer of een bestand al is ingediend en welke transcriptie het is geworden.

De uploadresource zonder de eenmalige uploadvelden. status is consumed en transcription_id wordt gezet zodra de upload is ingediend.

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

Een verbetering starten

Timing en regelbalans op uitzendniveau, volledig automatisch — lever ondertitels die de QC doorstaan zonder dat er een redacteur aan te pas komt. Voor productiehuizen automatiseert dit de ondertitel-conformstap van de leveringspijplijn: elke aflevering vertrekt met consistente ondertitels die aan de specificaties voldoen.

Geeft 202 terug met de verbeteringsresource.

Credits: Berekend op basis van de omvang van de ondertitelinhoud, tegen hetzelfde tarief als de studio, en afgeschreven zodra de job wordt geaccepteerd. Bij mislukking automatisch terugbetaald.

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
}

Een verbetering ophalen

Poll en resultaat in één: zodra de status completed is, levert het captions-endpoint al de verbeterde versie.

Poll tot completed. Het opvragen van een mislukte verbetering activeert de automatische terugbetaling.

Credits: Gratis.

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

Een vertaling starten

Eén aanroep per taal maakt van een afgeronde ondertiteltrack een gelokaliseerde versie met identieke timing — vermenigvuldig het bereik van elke video die je al hebt.

Geeft 202 terug. Antwoordt met 409 translation_exists als die taal al bestaat voor de huidige versie.

Credits: Berekend op basis van de omvang van de ondertitelinhoud, tegen hetzelfde tarief als de studio, per doeltaal, afgeschreven bij acceptatie. Bij mislukking automatisch terugbetaald.

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
}

Een vertaling ophalen

Poll en resultaat in één: eenmaal completed haal je het vertaalde ondertitelbestand op van het captions-endpoint met de language-parameter.

Poll tot completed en haal daarna de vertaalde ondertitels op van het captions-endpoint met de language-queryparameter.

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