API-referenssi

Luo litterointi

Muunna mikä tahansa verkossa isännöity mediatiedosto tarkoiksi, aikaleimatuiksi tekstityksiksi ilman, että kenenkään tarvitsee avata Studiota — syötä tulokset suoraan CMS:ääsi, arkistoosi tai julkaisuputkeesi.

Joko source_url tai upload_id on pakollinen, mutta ei molemmat.

Median kesto tarkistetaan ennen pyynnön hyväksymistä; saldo veloitetaan ja työ lisätään jonoon yhtenä atomisena vaiheena. Palauttaa 201 ja litterointiresurssin.

Krediitit: 4 krediittiä jokaiselta alkavalta mediaminuutilta, veloitetaan kun työ hyväksytään. Epäonnistuneet työt hyvitetään automaattisesti.

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
}

Listaa litteroinnit

Täsmäytä katalogisi käsiteltyihin töihin tai rakenna hallintanäkymä kaiken litteroimasi päälle.

API:n kautta luodut litteroinnit, uusimmat ensin. Vakiosivutus.

Krediitit: Maksuton.

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

Hae litterointi

Sekä edistymisen seuranta että lopputulos: seuraa, kun tila vaihtuu arvoon completed, ja lue sitten kesto, kieli ja veloitus samasta vastauksesta.

Pollaa, kunnes tila on completed (tai rekisteröi webhook, katso alla). Epäonnistuneen litteroinnin lukeminen käynnistää myös sen automaattisen hyvityksen.

Krediitit: Maksuton.

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
}

Poista transkriptio

Poista työ pyynnöstä — täysi hallinta omiin tietoihin yhdellä kutsulla.

Poistaa transkription pysyvästi kaikkine tallennettuine tietoineen: mediatiedostot, transkription sisällön, versiot, käännökset ja kommentit. Koostetut laskutuslaskurit säilyvät — ne eivät sisällä sisältöä.

Vain valmiit tai epäonnistuneet työt voi poistaa; yhä käsittelyssä oleva työ palauttaa 409, samoin työ, jolla on kesken oleva parannus tai käännös. Poisto on välitön eikä sitä voi perua.

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

Nouda tekstitykset

Vedä lähetysvalmiit tekstitystiedostot suoraan soittimeesi, MAM-järjestelmääsi tai jakeluputkeesi — ei manuaalisia vientejä, ei muotomuunnoksia omassa päässäsi. Videotuotantoputkessa valmis SRT tai VTT putoaa suoraan leikkausohjelmaasi, katselmointityökaluusi tai paketointivaiheeseen heti, kun leikkaus on litteroitu.

Palauttaa raa'an tekstitystiedoston rungon vastaavalla Content-Type-otsakkeella — ei JSON-käärittynä. Vastaa 409 not_ready, kunnes litterointi on valmis.

Krediitit: Maksuton.

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

json-muoto on versioitu sopimus: { version: 1, language, segments: [{ index, start, end, text, speaker? }] } — sekunteja millisekunnin tarkkuudella, ja version sisällä kenttiä ainoastaan lisätään.

Käännökset kuuluvat siihen versioon, jota varten ne luotiin — käännösresurssin revision_id nimeää sen, eikä myöhemmän parannuksen versio peri niitä. Käytä tätä revision_id-arvoa revision-parametrina noutaaksesi käännetyn version.

Luo lataus

Litteroi tiedosto suoraan työpöytäsovelluksesta, leikkausohjelman liitännäisestä tai yksityiseltä palvelimelta ilman, että sitä tarvitsee ensin isännöidä missään julkisesti.

Palauttaa 201 ja latausresurssin. Allekirjoitettu URL on voimassa neljä tuntia ja sidottu upload_headers-kentän otsakkeisiin: lähetä ne PUT-pyynnössä täsmälleen sellaisina kuin ne palautettiin, tai tallennustila hylkää pyynnön. Juuri length-range-otsake valvoo 4 GB:n ylärajaa.

Idempotency-Key otetaan huomioon, joten uudelleenyritetty luonti palauttaa saman latauksen uuden paikan luomisen sijaan.

Krediitit: Maksuton. Krediitit veloitetaan litteroinnin hinnalla, kun lataus lähetetään litteroitavaksi.

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

Litterointiin riittää pelkkä ääni: kun viet vain ääniraidan, kokoillan elokuvakin pysyy alle 100 MB:n kokoisena.

Yhdestä latauksesta syntyy täsmälleen yksi litterointi. Sen lähettäminen uudelleen vastaa 409 upload_already_used.

Hae lataus

Tarkista, onko tiedosto jo lähetetty ja mikä transkriptio siitä tuli.

Latausresurssi ilman kertakäyttöisiä latauskenttiä. status on consumed ja transcription_id asetetaan, kun lataus on lähetetty.

Krediitit: Maksuton.

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
}

Käynnistä parannus

Lähetystason ajoitus ja rivien tasapainotus automaattiohjauksella — toimita tekstitykset, jotka läpäisevät laaduntarkastuksen ilman, että editoija koskee niihin. Tuotantoyhtiöille tämä automatisoi toimitusputken tekstitysten viimeistelyvaiheen: jokainen jakso lähtee talosta yhdenmukaisin, vaatimusten mukaisin tekstityksin.

Palauttaa 202 ja parannusresurssin.

Krediitit: Lasketaan tekstityssisällön koosta samalla hinnalla, jonka Studio veloittaa, ja vähennetään, kun työ hyväksytään. Hyvitetään automaattisesti epäonnistuessa.

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
}

Hae parannus

Tilakysely ja tulos yhdessä: kun tila on completed, tekstityspäätepiste palauttaa jo parannetun version.

Pollaa, kunnes tila on completed. Epäonnistuneen parannuksen lukeminen käynnistää sen automaattisen hyvityksen.

Krediitit: Maksuton.

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

Käynnistä käännös

Yksi kutsu kieltä kohden muuttaa valmiin tekstitysraidan lokalisoiduksi versioksi identtisellä ajoituksella — moninkertaista jokaisen jo olemassa olevan videosi tavoittavuus.

Palauttaa 202. Vastaa 409 translation_exists, jos kieli on jo olemassa nykyiselle versiolle.

Krediitit: Lasketaan tekstityssisällön koosta samalla hinnalla, jonka Studio veloittaa, kohdekieltä kohden; vähennetään hyväksynnän yhteydessä. Hyvitetään automaattisesti epäonnistuessa.

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
}

Hae käännös

Tilakysely ja tulos yhdessä: kun tila on completed, nouda käännetty tekstitystiedosto tekstityspäätepisteestä language-parametrilla.

Pollaa, kunnes tila on completed, ja nouda sitten käännetyt tekstitykset tekstityspäätepisteestä language-kyselyparametrilla.

Krediitit: Maksuton.

# 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