API-reference

Opret en transskription

Forvandl enhver hostet mediefil til præcise, tidsstemplede undertekster, uden at nogen åbner studiet — og før resultatet direkte ind i dit CMS, arkiv eller din publiceringspipeline.

Mediets varighed aflæses, før requesten accepteres; saldoen trækkes, og jobbet sættes i kø i ét atomart trin. Returnerer 201 med transskriptionsressourcen.

Credits: 4 credits pr. påbegyndt minut medie, trukket når jobbet accepteres. Fejlede jobs 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 transskriptioner

Afstem dit katalog mod behandlede jobs, eller byg et dashboard over alt, hvad du har transskriberet.

API-oprettede transskriptioner, nyeste først. Standardpaginering.

Credits: Gratis.

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

Hent en transskription

Både statuspolling og det endelige resultat: se status skifte til completed, og læs derefter varighed, sprog og trukket beløb fra samme svar.

Poll, indtil status er completed (eller registrér en webhook, se nedenfor). Læsning af en fejlet transskription udløser samtidig dens automatiske refusion.

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",
  "metadata": { "internal_ref": "case-42" },
  "credits_charged": 124,
  "error": null,
  "created": 1754558000
}

Slet en transskription

Slet et job på forespørgsel — fuld kontrol over jeres data i ét kald.

Sletter transskriptionen permanent med alt, der er gemt for den: mediefiler, transskriptionsindhold, revisioner, oversættelser og kommentarer. Aggregerede faktureringstællere bevares — de indeholder intet indhold.

Kun fuldførte eller fejlede jobs kan slettes; et job, der stadig behandles, returnerer 409, det samme gør et med en igangværende forbedring eller oversættelse. Sletningen er øjeblikkelig og kan ikke fortrydes.

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
}

Hent undertekster

Træk broadcast-klare undertekstfiler direkte ind i din player, MAM eller leveringspipeline — ingen manuelle eksporter, ingen formatkonvertering i din ende. I en videoproduktionspipeline lander færdig SRT eller VTT direkte i dit NLE, reviewværktøj eller pakketrin, i samme øjeblik et klip er transskriberet.

Returnerer den rå undertekstfil som body med den tilhørende Content-Type — ikke pakket ind i JSON. Svarer 409 not_ready, indtil transskriptionen er fuldført.

Credits: Gratis.

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

json-formatet er en versioneret kontrakt: { version: 1, language, segments: [{ index, start, end, text, speaker? }] } — sekunder med millisekundpræcision, og felter tilføjes kun inden for en version.

Oversættelser hører til den version, de blev oprettet ud fra — oversættelsesressourcens revision_id angiver den, og versionen fra en senere forbedring arver dem ikke. Send dette revision_id som revision for at hente den oversatte version.

Start en forbedring

Broadcast-kvalitet i timing og linjebalancering på autopilot — lever undertekster, der består QC, uden at en redigerer rører dem. For produktionsselskaber automatiserer det conform-trinnet for undertekster i leveringspipelinen: hvert afsnit sendes af sted med ensartede undertekster, der overholder specifikationerne.

Returnerer 202 med forbedringsressourcen.

Credits: Beregnes ud fra undertekstindholdets størrelse til samme takst som i studiet, og trækkes når jobbet accepteres. Refunderes automatisk ved fejl.

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

Polling og resultat i ét: når status viser completed, serverer captions-endpointet allerede den forbedrede version.

Poll indtil completed. Læsning af en fejlet forbedring udløser dens automatiske refusion.

Credits: Gratis.

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

Start en oversættelse

Ét kald pr. sprog forvandler et færdigt undertekstspor til en lokaliseret version med identisk timing — mangedobl rækkevidden af hver video, du allerede har.

Returnerer 202. Svarer 409 translation_exists, hvis sproget allerede findes for den aktuelle version.

Credits: Beregnes ud fra undertekstindholdets størrelse til samme takst som i studiet, pr. målsprog, og trækkes ved accept. Refunderes automatisk ved fejl.

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 oversættelse

Polling og resultat i ét: når den er completed, hentes den oversatte undertekstfil fra captions-endpointet med language-parameteren.

Poll indtil completed, og hent derefter de oversatte undertekster fra captions-endpointet med query-parameteren language.

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