Hoppa till navigering

Skapa målspråk för dubbning

Lägg till ett språk att dubba ett projekt till och köa dubbningen.

Det här anropet skapar dubbat ljud och debiteras per generering. Målet skapas som queued och startar så snart projektet är ready, så det kan läggas till när som helst efter att projektet har skapats. Det ärver projektets dubbningsmodell och kan inte välja en annan.

Ett projekt som skapats med webhook_ids skickar händelsen dubbing_language_completed med nedladdnings-URL:er för resultatet. Vi rekommenderar därför att du prenumererar i stället för att polla målet tills det är klart.

Sökvägsparametrar

project_idstringObligatorisk

Identifierare för det överordnade dubbningsprojektet.

Headers

xi-api-keystringValfri

Förfrågan

This endpoint expects an object.
target_languagestringObligatorisk

BCP-47-språktagg att dubba projektet till (till exempel fr eller es-MX). Måste vara ett av de språk som projektets dubbningsmodell stöder, och en regionsspecificerad tagg måste vara en av de dialekter som stöds.

voice_settingsobject or nullValfri

Röstinställningar som tillämpas på varje talare på detta språk. Utelämna för att använda standardinställningarna.

translationsmap from strings to strings or nullValfri

Endast Enterprise. Valfria översättningar att använda i stället för maskinöversättning. En mappning från varje källsegments external_id (eller dess id, om du inte har angett något) till den översatta texten; varje källsegment måste täckas exakt en gång. Högst 20 000 poster, med totalt högst 4 MiB text. Se Använd din egen transkription.

Svar

Lyckat svar
language_idstring

Unik identifierare för målspråket.

project_idstring

Identifierare för det överordnade dubbningsprojektet.

target_languagestring

BCP-47-språktagg som detta mål dubbas till.

statusenum

Livscykelstatus: queued (väntar på att projektet ska bli klart eller på en arbetare), processing medan det dubbas, completed när utdata är tillgänglig, stale när transkriptet har ändrats efter att utdata skapades, eller failed.

Tillåtna värden:
revisioninteger

Monoton räknare som ökas varje gång det här målets transkription ändras (en källredigering som påverkar den eller en ändring av dess översättning).

created_atstringformat: "date-time"

När målspråket skapades.

updated_atstringformat: "date-time"

När målspråket senast uppdaterades.

model_idstring or nullValfri

Dubbningsmodell som det här målet dubbas med, ärvs från projektet och kan inte väljas per språk.

voice_settingsobject or nullValfri

Röstinställningar som tillämpas på varje talare på detta språk, eller null om standardinställningarna används.

outputsobject or nullValfri

Signerade utdata-URL:er; null tills målet har producerat utdata (finns när completed har uppnåtts och behålls medan stale — jämför output_revision med revision för att avgöra om utdatan är aktuell).

output_revisioninteger or nullValfri

Den revision som den aktuella dubbade utdatan genererades från; lika med revision när den är uppdaterad och lägre när den är stale. Detta är null tills en generering har slutförts.

errorobject or nullValfri

Varför det här språket misslyckades; null om inte status är failed, och även null för de få språk som misslyckades innan felrapportering infördes. Koden project_failed betyder att det överordnade projektet misslyckades, så läs projektet för att se den bakomliggande orsaken.

warningslist of objectsValfri

Icke-kritiska villkor som uppstod vid dubbning till det här språket; tomt om inga finns. Återspeglar den senaste genereringen. Villkor som uppstår när källan förbereds rapporteras i stället för projektet.

Fel

422
Unprocessable Entity Error