Skapa dubbningsprojekt
Skapa ett dubbningsprojekt från en uppladdad fil (file) eller en käll-URL (source_url).
Returneras så snart projektposten finns, innan källan har hämtats: projektet börjar som queued och blir ready när källan har transkriberats. Lägg till ett målspråk för varje språk du vill ha, eller skicka target_language för att köa det första här.
Att skapa ett projekt medför en minimiavgift för ett språk: du debiteras för dubbning till minst ett språk när projektet skapas, innan något resultat finns. Avgiften förskottsbetalar det första målspråket – det första målspråk du lägger till, eller det som köas via target_language, använder den – och varje ytterligare språk debiteras separat.
Förberedelsen kan ta flera minuter för en lång källa, så vi rekommenderar att du skickar webhook_ids för att få en avisering när projektet blir ready eller failed, i stället för att hämta status löpande.
Headers
Förfrågan
Källmediefilen som ska dubbas: en ljud- eller videofil på högst 3 GiB. Ange denna eller source_url, inte båda.
Offentlig HTTP(S)-URL som källmediet hämtas från på serversidan, med samma storleks- och formatbegränsningar som för en uppladdning. Ange denna eller file, inte båda.
Valfri fritextsträng (högst 500 tecken) för att identifiera projektet hos dig. Sparas och returneras ordagrant; den påverkar inte dubbningen.
BCP-47-språktagg för källmediet; måste vara ett språk som transkriberingsmodellen stöder. Alla underordnade taggar för region eller skriftsystem ignoreras, eftersom transkribering sker per språk. Utelämna för automatisk identifiering.
Dubbningsmodell (dubbing_v1 eller dubbing_v2) som varje språkmål i det här projektet dubbas med. Standardvärdet är dubbing_v2. Fastställs när projektet skapas – källan förbereds för denna modell, så varken projektet eller ett enskilt mål kan ändra den senare.
Nyckeltermer för att styra transkribering och översättning mot vissa ord (till exempel produkt- eller varumärkesnamn). Högst 1 000 termer; varje term får vara högst 50 tecken och 5 ord; tecknen <>{}[]\ är inte tillåtna. Termer trimmas och dubbletter tas bort. Upprepa fältet en gång per term eller skicka en enda JSON-array.
ID:n för workspace-webhooks som ska meddelas när projektet fortskrider – alternativet till polling och det vi rekommenderar. Varje webhook får en dubbing_project_ready- eller dubbing_project_failed-händelse för projektet och en dubbing_language_completed- eller dubbing_language_failed-händelse för varje språk under det. dubbing_language_completed innehåller URL:er för nedladdning av utdata. Högst 3 ID:n, där varje redan är konfigurerat i ditt workspace – se Webhooks för information om hur du skapar en och verifierar dess signatur. Upprepa fältet en gång per ID eller skicka en enda JSON-array eller kommaseparerad sträng. Leverans sker enligt bästa förmåga och kan upprepas, så vi rekommenderar att du hanterar händelser idempotent.
Valfri genväg: skapa även ett språkmål på detta BCP-47-språk, som köas för att starta när projektet är klart — motsvarar att skapa projektet och sedan skapa ett språkmål. Måste vara ett av de språk som dubbningsmodellen stöder, och en regionangiven tagg måste vara en av de dialekter som stöds. Detta är det första språkmålet och förbrukar därför projektets minimiavgift i stället för att läggas till den. Dess ID returneras i language_ids.
Endast Enterprise. Valfri JSON-transkription att använda i stället för att transkribera källan: ett {"segments": [...]}-dokument med högst 20 000 segment och 4 MiB. Se Använd din egen transkription för segmentfälten och deras begränsningar. source_language krävs när en transkription anges. Om något segment innehåller en translation krävs target_language och varje segment måste innehålla en; dessa översättningar används som underlag för målet som skapas via target_language, vilket sedan hoppar över maskinöversättning.
Svar
Unik identifierare för dubbningsprojektet.
Projektets livscykelstatus: queued innan källan hämtas, preparing medan den transkriberas, ready när transkriberingen är klar och språkmål kan starta, eller failed. Ett projekt rapporteras aldrig som processing – det värdet tillhör språkmål.
Monoton räknare som ökas varje gång källtranskriptionen redigeras (segment läggs till, ändras eller tas bort).
När projektet skapades.
När projektet senast uppdaterades.
Den fritextsträng du angav som reference när projektet skapades, eller null om du inte angav någon.
BCP-47-språktagg för källmediet (null om den identifieras automatiskt).
Dubbningsmodell som varje språkmål i det här projektet dubbas med. Fastställs när projektet skapas och kan inte väljas per språk.
Metadata för källmediet, fylls i när källan har hämtats och avkodats (kort efter skapandet, innan projektet är ready); null fram till dess.
Identifierare för språkmålen under det här projektet. Fylls i när ett enskilt projekt hämtas och vid skapande när target_language skapar ett. Är alltid tomt i listsvar – lista projektets språkmål i stället.
ID:n för workspace-webhooks som meddelas när projektet och dess språk når ready, completed eller failed.
Varför projektet misslyckades; null om inte status är failed. Även null för de få projekt som misslyckades innan felrapportering infördes.
Icke-kritiska villkor som uppstod när källan förbereddes; tomt om inga finns. Återspeglar den senaste förberedelsen. Villkor som uppstår vid dubbning till ett visst språk rapporteras i stället för det språket.