API-integraatio

Video Caption API suurivolyymiseen, QA-turvalliseen tekstitysautomaatioon

Automatisoi tekstityksen luonti eksplisiittisillä työtiloilla, kielihallinnalla ja tuotantoturvallisilla retry-toistoilla tiimeille, jotka toimittavat suuria määriä lyhytmuotoista sisältöä.

Ongelma

Mittakaavassa tekstitysoperaatiot epäonnistuvat usein QA:ssa ja johdonmukaisuudessa: manuaaliset ajoitustarkistukset, kielten yhteensopimattomuus ja toistuvat korjaukset muodostavat piilotetun tuotantopullonkaulan.

Tulos Ssemblen kanssa

Ssemble mahdollistaa deterministisen tekstityksen prosessoinnin selkeillä status/error-sopimuksilla, joten insinööritiimit voivat automatisoida rutiini-QA:n ja eskaloida vain aidot reunatapaukset.

Toteutuksen perusteet

Base URL: https://aiclipping.ssemble.com/api/v1

Integraatioarkkitehtuuri (ingest → prosessointi → poll/webhook → julkaisu)

1) Ingest

Tallenna lähde-URL / tiedosto-URL sekä tekstityksen konfigurointikentät (language, captionLanguage, templateId, preferredLength).

2) Prosessointi

Kutsu POST /shorts/create tekstitysparametreilla ja tallenna requestId + korrelaatio-id.

3) Poll / Webhook

Tarkista GET /shorts/:id/status (tai list-endpoint) hallitulla tahdilla, kunnes saavutetaan lopputila.

4) Julkaisu

Nouda valmiit resurssit, aja automaattiset tekstityksen QA-tarkistukset ja luovuta julkaisujonolle.

Endpoint-esimerkkejä

POST /shorts/create— Luo tekstitetty short kieli-/mallivaihtoehdoilla
GET /shorts/:id/status— Seuraa prosessointivaihetta ja failureReason-arvoa
GET /shorts— Valvo töitä eräkohtaisesti ilman yhden kutsun per työ -kuormaa

Autentikointiohjeet

Käytä vain palvelinpuolen X-API-Key-avainta. Pidä erilliset avaimet stagingille ja tuotannolle vähentääksesi kierrätysriskiä ja ympäristöjen kytköksiä.

Rate limit -rajat ja retry-toistot

Vältä tiukkoja poll-silmukoita. Käytä erätilan tarkistuksia, välimuistita pysyvät tulokset ja noudata 429-vastauksen tullessa reset/retryAfter-arvoja ennen backoff-toistoja.

Pyyntöesimerkki

POST /shorts/create
{
  "url": "https://www.youtube.com/watch?v=abc123",
  "start": 0,
  "end": 540,
  "language": "en",
  "captionLanguage": "en",
  "templateId": "660b8531aedb346bbe26eb43",
  "preferredLength": "under60sec",
  "layout": "auto"
}

Vastausesimerkki

200 OK
{
  "data": {
    "requestId": "665a1b2c3d4e5f6a7b8c9d0e",
    "status": "processing",
    "creditsUsed": 1,
    "estimatedCompletionTime": "2026-03-10T06:05:00.000Z"
  }
}

Virhetilanne-esimerkki

400 Bad Request
{
  "error": {
    "code": "invalid_request",
    "message": "Invalid captionLanguage code",
    "details": { "captionLanguage": "xx" }
  }
}

Versiointi

Kiinnitä endpoint-versiot ja validoi pyyntöskeemat CI:ssä, jotta integraatiopoikkeamat havaitaan ennen tuotantojulkaisua.

Tuki

Epäonnistuneille töille tallenna request payload -hash + requestId + error.details, jotta tiimit voivat erottaa virheelliset syötteet putken häiriöistä.

Pikaopas

Luo SSEMBLE_API_KEY hallintapaneelissa ja tallenna se backendin ajonaikaan.
Lähetä minimaalinen POST /shorts/create -payload lähteellä + ajoituksella + kielellä.
Kysele GET /shorts/:id/status 10 sekunnin välein, kunnes tila on completed/failed/cancelled.
Nouda lopputulos GET /shorts/:id -kutsulla ja aja tekstityksen QA-tarkistukset.
Lisää rajoitetut retry-toistot ohimeneville 429/5xx-virheille ja reititä loppuun kuluneet työt DLQ-jonoon.

Aloita tekstitys-endpointin dokumentaatiosta

Aloita integraatio

1) Autentikoinnin määritys

Turvallinen avainten käsittely ja autentikointivirheet

2) Create-endpoint

Pyynnön rungon kentät ja validointi

3) Virhekoodit

Retry-kelpoisten ja lopullisten virheiden taksonomia

4) Esimerkkejä

cURL/JavaScript/Python-integraatiokatkelmat

3-vaiheinen työnkulku

Kaappaa lähdemedia ja tekstitysasetukset (kieli/malli/haluttu pituus) jonomalliisi.
Lähetä create-pyynnöt, seuraa tilasiirtymiä ja reititä lopputilat automaattisesti.
Julkaise valmiit lopputulokset automaattisten tekstityksen luettavuus- ja käytäntötarkistusten jälkeen.

Miksi tiimit valitsevat Ssemblen

Suunniteltu tiimeille, joilla tekstityksen johdonmukaisuus vaikuttaa brändin laatuun ja katsojan sitoutumiseen.
Tukee tilapohjaista QA-reititystä manuaalisen inbox-triagen sijaan.
Skaalautuu useiden brändien kesken ulkoistamalla tyyli-/kielikäytännön integraatiokerrokseesi.

Seuraava vaihe

Avaa tekstitys-API:n pikaopas Katso hinnoittelu Kehittäjädokumentaatio

UKK

Mikä yleensä aiheuttaa tekstitysputken virheitä?

Yleisiä syitä ovat virheelliset ajoitusikkunat, saavuttamattomat lähde-URL:t ja virheelliset kieli-/malliarvot. Validoi nämä ennen jonoon lisäämistä.

Pitäisikö meidän kysellä jokaista työtä erikseen mittakaavassa?

Vain pienessä volyymissä. Suuremmassa volyymissa yhdistetty tilaseuranta vähentää API-kuormaa ja parantaa luotettavuutta.

Miten teemme retry-toistoista turvallisia?

Toista vain ohimeneviä tiloja (429/5xx/aikakatkaisut) ja käytä pyynnön sormenjälkiä duplikaattikäsittelyn estämiseksi.

Ovatko valmistumisajat kiinteitä?

Ei. Valmistuminen voi vaihdella lähteen pituuden, jonon tilan ja asetusten mukaan. Käsittele arvioitua aikaa ohjeellisena.

Voimmeko pakottaa asiakaskohtaiset tekstitystyylit?

Kyllä. Pidä tyyli-/mallimääritykset konfiguraatiokerroksessasi ja injektoi ne vuokralaiskohtaisesti pyynnön luonnin yhteydessä.

Mitkä tuotantohälytykset ovat tärkeimpiä?

Valvo virheprosenttia virhekoodin mukaan, jonon ikää ja jumiin jääneiden prosessointien määrää havaitaksesi häiriöt ajoissa.