Skip to navigation

Doeltaal voor nasynchronisatie maken

Voeg een taal toe waarin je een project wilt nasynchroniseren en plaats de nasynchronisatie in de wachtrij.

Deze aanroep produceert nagesynchroniseerde audio en wordt per generatie gefactureerd. Het doel wordt gemaakt als queued en start zodra het project ready is. Je kunt het dus op elk moment toevoegen nadat het project is gemaakt. Het neemt het nasynchronisatiemodel van het project over en kan geen ander model kiezen.

Een project dat is gemaakt met webhook_ids stuurt een dubbing_language_completed-event met de download-URL’s van de uitvoer. Daarom raden we aan je te abonneren in plaats van dit doel te pollen tot het voltooid is.

Path parameters

project_idstringRequired
ID van het bovenliggende nasynchronisatieproject.

Headers

xi-api-keystringOptional

Request

This endpoint expects an object.
target_languagestringRequired

BCP-47-taaltag voor de taal waarin het project moet worden nagesynchroniseerd (bijvoorbeeld fr of es-MX). Moet een van de talen zijn die het nasynchronisatiemodel van het project ondersteunt, en een tag met regioaanduiding moet een van de ondersteunde dialecten zijn.

voice_settingsobject or nullOptional
Steminstellingen die op elke spreker in deze taal worden toegepast. Laat weg om de standaardinstellingen te gebruiken.
translationsmap from strings to strings or nullOptional

Alleen voor Enterprise. Optionele vertalingen om te gebruiken in plaats van machinevertaling. Een toewijzing van de external_id van elk bronsegment (of de id als je er geen hebt opgegeven) naar de vertaalde tekst; elk bronsegment moet precies één keer worden opgenomen. Maximaal 20.000 vermeldingen, samen maximaal 4 MiB tekst. Zie Gebruik je eigen transcript.

Response

Geslaagde response
language_idstring
Unieke identificatiecode van het taaldoel.
project_idstring
ID van het bovenliggende nasynchronisatieproject.
target_languagestring

BCP-47-taaltag waarnaar dit doel wordt nagesynchroniseerd.

statusenum

Levenscyclusstatus: queued (wacht tot het project klaar is of op een worker), processing tijdens de nasynchronisatie, completed zodra de uitvoer beschikbaar is, stale wanneer het transcript is gewijzigd nadat de uitvoer is geproduceerd, of failed.

Allowed values:
revisioninteger

Monotone teller die wordt verhoogd wanneer het transcript van dit doel verandert (door een bronbewerking die het beïnvloedt of een bewerking van de vertaling).

created_atstringformat: "date-time"
Wanneer het taaldoel is gemaakt.
updated_atstringformat: "date-time"
Wanneer het taaldoel voor het laatst is bijgewerkt.
model_idstring or nullOptional
Nasynchronisatiemodel waarmee dit doel van nasynchronisatie wordt voorzien, overgenomen van het project en niet per taal selecteerbaar.
voice_settingsobject or nullOptional
Steminstellingen die op elke spreker in deze taal worden toegepast, of null als de standaardinstellingen gelden.
outputsobject or nullOptional

Ondertekende output-URL’s; null totdat het doel output heeft geproduceerd (aanwezig zodra completed, en behouden zolang stale — vergelijk output_revision met revision om te bepalen of de output actueel is).

output_revisioninteger or nullOptional

De revision waaruit de huidige nagesynchroniseerde uitvoer is gegenereerd; gelijk aan revision wanneer deze actueel is en lager wanneer deze stale is. Dit is null totdat een generatie is voltooid.

errorobject or nullOptional

Waarom deze taal is mislukt; null tenzij status failed is, en ook null voor de enkele talen die mislukten voordat foutrapportage werd ingevoerd. Een code van project_failed betekent dat het bovenliggende project is mislukt; raadpleeg dus het project voor de onderliggende oorzaak.

warningslist of objectsOptional

Niet-fatale omstandigheden die zijn opgetreden tijdens het nasynchroniseren van deze taal, of leeg als er geen zijn. Weerspiegelt de nieuwste generatie. Omstandigheden die zijn opgetreden tijdens het voorbereiden van de bron worden in plaats daarvan bij het project gerapporteerd.

Errors

422
Unprocessable Entity Error