Nasynchronisatieproject maken
Maak een nasynchronisatieproject vanuit een geüpload bestand (file) of een bron-URL (source_url).
Retourneert zodra het projectrecord bestaat, voordat de bron is opgehaald: het project start als queued en wordt ready zodra de bron is getranscribeerd. Voeg voor elke gewenste taal een taaldoel toe, of geef target_language door om hier het eerste doel in de wachtrij te zetten.
Voor het maken van een project worden minimaal de kosten voor één taal in rekening gebracht: bij het maken van het project worden kosten voor nasynchronisatie in ten minste één taal berekend, voordat er uitvoer bestaat. Deze kosten betalen het eerste taaldoel vooraf — het eerste doel dat je toevoegt, of het doel dat via target_language in de wachtrij is gezet, gebruikt dit — en voor elke extra taal worden afzonderlijke kosten berekend.
De voorbereiding kan bij een lange bron minuten duren. We raden daarom aan webhook_ids door te geven, zodat je een melding krijgt wanneer het project ready of failed wordt, in plaats van ernaar te pollen.
Headers
Request
Het bronmediabestand voor nasynchronisatie: een audio- of videobestand van maximaal 3 GiB. Geef dit of source_url op, niet beide.
Openbare HTTP(S)-URL waarvandaan de bronmedia server-side worden opgehaald, onderhevig aan dezelfde limieten voor omvang en indeling als een upload. Geef deze of file op, niet beide.
Optionele vrije tekenreeks (maximaal 500 tekens) om het project aan jouw kant te identificeren. Wordt letterlijk opgeslagen en teruggegeven; heeft geen invloed op de nasynchronisatie.
BCP-47-taaltag van de bronmedia; moet een taal zijn die het transcriptiemodel ondersteunt. Elke subtag voor regio of schrift wordt genegeerd, aangezien transcriptie per taal plaatsvindt. Laat weg voor automatische detectie.
Nasynchronisatiemodel (dubbing_v1 of dubbing_v2) waarmee elk taaldoel van dit project van nasynchronisatie wordt voorzien. Standaard is dubbing_v2. Wordt vastgelegd bij het maken — de bron wordt voorbereid voor dit model, dus noch het project noch een afzonderlijk doel kan dit later wijzigen.
Kerntermen om de transcriptie en vertaling op te sturen (bijvoorbeeld product- of merknamen). Maximaal 1.000 termen; elke term maximaal 50 tekens en 5 woorden; de tekens <>{}[]\ zijn niet toegestaan. Termen worden ingekort en ontdubbeld. Herhaal het veld één keer per term of geef één JSON-array door.
ID’s van workspace-webhooks die een melding ontvangen naarmate dit project vordert — het aanbevolen alternatief voor polling. Elke webhook ontvangt een dubbing_project_ready- of dubbing_project_failed-event voor het project, en een dubbing_language_completed- of dubbing_language_failed-event voor elke onderliggende taal; dubbing_language_completed bevat de download-URL’s voor de output. Maximaal 3 ID’s, die elk al in je workspace zijn geconfigureerd — zie Webhooks voor informatie over het maken van een webhook en het verifiëren van de handtekening. Herhaal het veld eenmaal per ID, of geef één JSON-array of door komma’s gescheiden string door. Bezorging gebeurt naar beste vermogen en kan worden herhaald, dus we raden aan events idempotent te verwerken.
Optionele snelkoppeling: maak ook een taaldoel in deze BCP-47-taal, dat in de wachtrij wordt geplaatst om te starten zodra het project klaar is — gelijk aan het maken van het project en daarna één taaldoel. Moet een van de talen zijn die het nasynchronisatiemodel ondersteunt, en een tag met regioaanduiding moet een van de ondersteunde dialecten zijn. Dit is het eerste taaldoel en verbruikt daarom de minimale kosten van het project in plaats van deze te verhogen. De ID wordt geretourneerd in language_ids.
Alleen voor Enterprise. Optioneel JSON-transcript om te gebruiken in plaats van de bron te transcriberen: een document {"segments": [...]}, met maximaal 20.000 segmenten en 4 MiB. Zie Gebruik je eigen transcript voor de segmentvelden en hun beperkingen. source_language is vereist wanneer een transcript wordt opgegeven. Als een segment een translation bevat, is target_language vereist en moet elk segment er een bevatten; deze vertalingen vormen de basis voor het via target_language gemaakte doel, dat machinevertaling vervolgens overslaat.
Response
Levenscyclusstatus van het project: queued voordat de bron wordt opgepakt, preparing tijdens de transcriptie, ready zodra de transcriptie klaar is en taaldoelen kunnen starten, of failed. Een project wordt nooit gerapporteerd als processing — die waarde hoort bij taaldoelen.
Monotone teller die wordt verhoogd wanneer het brontanscript wordt bewerkt (segment toevoegen/bewerken/verwijderen).
De vrije tekenreeks die je bij het maken van het project hebt opgegeven als reference, of null als je niets hebt opgegeven.
BCP-47-taaltag van de bronmedia (null indien automatisch gedetecteerd).
Metadata van bronmedia, ingevuld zodra de bron is opgehaald en gedecodeerd (kort na create, voordat het project ready is); tot die tijd null.
ID’s van de taaldoelen onder dit project. Wordt ingevuld wanneer één project wordt opgehaald en bij het maken wanneer target_language er een maakt. Is altijd leeg in lijstreacties — vraag in plaats daarvan de taaldoelen van het project op.
ID’s van de workspace-webhooks die een melding ontvangen wanneer dit project en de bijbehorende talen de status ready, completed of failed bereiken.
Waarom het project is mislukt; null tenzij status failed is. Ook null voor de enkele projecten die mislukten voordat foutmeldingrapportage werd geïntroduceerd.
Niet-fatale omstandigheden die zijn opgetreden tijdens het voorbereiden van de bron, of leeg als er geen zijn. Weerspiegelt de nieuwste voorbereiding. Omstandigheden die zijn opgetreden tijdens het nasynchroniseren van een specifieke taal worden in plaats daarvan bij die taal gerapporteerd.