Skip to main content
Vertaling starten

Vertaling starten

Maak een nieuw vertaalproject aan door een video- of audiobestand te uploaden. Het vertaalproces draait asynchroon op de achtergrond. Gebruik het status-eindpunt om de voortgang te volgen en resultaten op te halen. Gebruik Projectdetails ophalen wanneer u vertaalde versiegeschiedenis of lipsynchronisatie-geschiedenis nodig heeft.

Gelijktijdigheidslimiet

U kunt maximaal 10 vertalingen tegelijk uitvoeren per account. Als er al 10 vertalingen bezig zijn, retourneren nieuwe verzoeken CONCURRENT_TRANSLATION_LIMIT_REACHED (HTTP 429).

Verzoek

Dit eindpunt accepteert multipart/form-data met een bestandsupload.

Headers

string
vereist
Uw VoiceCheap API-sleutel. Verkrijg er een via app.voicecheap.ai/page-api.

Body-parameters

file
vereist
Het video- of audiobestand dat moet worden vertaald.Ondersteunde videoformaten: video/mp4, video/quicktime, video/x-matroska, video/webm, video/mpegOndersteunde audioformaten: audio/mpeg, audio/wav, audio/mp4, audio/x-m4a, audio/flac, audio/ogg, audio/aac, audio/webmMaximale bestandsgrootte per abonnement: Beginner 5 GB, Starter 10 GB, Creator 20 GB, Pro 30 GB, Scale 40 GB en Enterprise 60 GB.
string
vereist
De taal waarin de inhoud moet worden vertaald. Moet in kleine letters zijn.Toegestane waarden (70+): afrikaans, albanian, amharic, arabic, armenian, assamese, azerbaijani, basque, belarusian, bengali, bosnian, bulgarian, catalan, croatian, czech, danish, dutch, english, british english, estonian, finnish, french, french canadian, galician, german, greek, gujarati, hebrew, hindi, hungarian, icelandic, indonesian, irish, italian, japanese, kannada, kazakh, khmer, korean, lao, latvian, lithuanian, macedonian, malay, malayalam, mandarin, marathi, mongolian, nepali, norwegian, persian, polish, portuguese, brazilian portuguese, punjabi, romanian, russian, serbian, slovak, slovenian, spanish, swahili, swedish, tagalog, tamil, telugu, thai, turkish, ukrainian, urdu, vietnamese, welsh, yoruba, zulu
string
De brontaal van de inhoud met behulp van ISO-taalcodes (bijv. en, es, fr, de, ja, zh).
Sterk aanbevolen: laat dit leeg voor automatische detectie.Geef deze parameter alleen op als u 100% zeker weet dat de taalcode correct is en in het juiste ISO-formaat staat. Onjuiste taalcodes leiden tot transcriptiefouten. Onze automatische detectie ondersteunt 80+ talen en is zeer nauwkeurig.
Standaard: auto-detect
string
Een aangepaste naam voor het project. Handig voor het identificeren van projecten in uw dashboard.Standaard: De project-ID wordt gebruikt als er geen naam is opgegeven.
string
Een https-eindpunt dat de webhook-gebeurtenissen voor dit project ontvangt, waarbij het eindpunt dat op uw account is geconfigureerd wordt overschreven.Standaard: Het webhook-eindpunt van het account, indien geconfigureerd.
string
auto-detect of een geheel getal van 1 tot 32. Een bekend aantal sprekers kan de diarizatie verbeteren.Standaard: auto-detect
string
Een JSON-stringarray van verzoekspecifieke namen, merken, acroniemen of specialistische termen. Deze termen worden samengevoegd met de opgeslagen woordenlijst van het account of team.
boolean
Verwijder veelvoorkomende stopwoorden uit de brontranscriptie vóór vertaling.Standaard: true
string
Een bestaande SRT-transcriptie in de brontaal. originalLanguage moet expliciet zijn wanneer dit veld wordt verstrekt.
boolean
Of achtergrondaudio in de uitvoer moet worden behouden.Indien ingeschakeld, blijft achtergrondmuziek, ambiance, gelach, applaus en omgevingsgeluid behouden terwijl alleen de originele stem wordt verwijderd (stem-scheiding). Schakel dit uit als uw bron geen achtergrondaudio bevat.Standaard: true
boolean
Houd de originele spreker zachtjes hoorbaar onder de vertaalde stem.Standaard: false
number
Volume van de originele stem van 1 tot 70 wanneer keepOriginalVoice is ingeschakeld.Standaard: 30
string
Stemisolatiemodus wanneer keepBackgroundMusic is ingeschakeld. Regelt de kwaliteit en kenmerken van de stem-scheiding.
Onze standaard stemverwerking, ontworpen voor professionele audiokwaliteit:
  • Verwijdert echo’s en galm
  • Reinigt technische onvolkomenheden
  • Produceert een heldere en scherpe stem
Aanbevolen voor: De meeste projecten waarbij audiokwaliteit van het grootste belang is. Ideaal voor tutorials, educatieve inhoud, marketingvideo’s en alle inhoud die optimale stemhelderheid vereist.
Behoudt de natuurlijke kenmerken van de opnameomgeving:
  • Behoudt een geluid dat dichter bij de originele opname ligt
  • Behoudt omgevingskenmerken
Aanbevolen voor: Inhoud waarbij de authenticiteit van de omgeving belangrijk is, zoals buiten-vlogs, documentaires of inhoud waarbij de geluidsambiance een integraal onderdeel van de ervaring is.
Deze optie kan in sommige gevallen artefacten of onverwachte effecten creëren vanwege het behoud van achtergrondelementen.
Toegestane waarden: studio, realisticStandaard: studio
boolean
Of er ondertitels moeten worden gegenereerd voor de vertaalde video.Indien ingeschakeld, worden er strakke zwart-witte ondertitels in Netflix-stijl toegevoegd. Gebruik subtitlesSource om te kiezen voor originele (brontaal) of vertaalde (doeltaal) tekst. Ondertitels worden automatisch gesynchroniseerd voor optimale leesbaarheid.Opmerking: Voor ingebrande ondertitels is FFmpeg met het subtitles-filter (libass) vereist. Indien niet beschikbaar, valt de API terug op het insluiten van een ondertiteltrack in plaats van hard-burned styling.Standaard: false
string
Kies de bron voor de ondertitels wanneer subtitles is ingeschakeld.Toegestane waarden: translated, originalStandaard: translatedOpmerking: Als original is geselecteerd maar de originele transcriptie niet beschikbaar is, vallen de ondertitels terug op translated.
string
Activeer lipsynchronisatie-verwerking nadat de vertaling is voltooid.
  • standard = Lip Sync
  • pro = Lip Sync Pro
  • studio = Lip Sync Studio
Premium-modi handhaven hun normale vereisten voor abonnement, duur en credits.Standaard: laat het veld leeg om lipsynchronisatie over te slaan.
boolean
Schakel detectie van de actieve spreker in voor de aangevraagde lipsynchronisatie.Standaard: false
boolean
Verouderde lipsynchronisatie-selector behouden voor achterwaartse compatibiliteit.
  • false = Standaard lipsynchronisatie (4 minuten aan credits per 1 minuut video)
  • true = Lip Sync Pro (9 minuten aan credits per 1 minuut video)
Lip Sync Pro is beschikbaar vanaf het Creator-abonnement.
Maximale duur: 30 minuten per video.Latentie: Lipsynchronisatie-verwerking voegt doorgaans 2x-4x de oorspronkelijke videoduur toe.
E-mails over voltooiing en mislukking van lipsynchronisatie worden niet verzonden voor via de API geactiveerde verzoeken. Gebruik het status-endpoint om de voortgang te volgen.
Standaard: niet ingeschakeld (laat het veld leeg om lipsynchronisatie over te slaan)Form-data: Verstuur booleaanse waarden als true of false strings (bijv. -F "lipsyncPro=false").
Combineer lipsyncPro niet met een tegenstrijdige lipSyncMode.
string
Stemstrategie: cloning of custom.Standaard: cloning
string
Vereist wanneer voiceMode gelijk is aan custom. De stem moet toebehoren aan de effectieve projecteigenaar. Willekeurige of niet-toegekende stem-ID’s worden geweigerd.
object
Verfijn de parameters voor stemklonen voor geavanceerde controle over de gegenereerde stem. Geef door als een JSON-string bij gebruik van form-data. Alle waarden moeten tussen 0 en 1 liggen (met een stap van 0,01).
Deze instellingen zijn alleen van toepassing wanneer voiceMode gelijk is aan cloning.
Standaardwaarden (gebalanceerd):
Aanbevolen om accentreproductie te vermijden:
string
Een JSON-array van bron-tijdbereiken die in de oorspronkelijke taal moeten blijven.
Tijdoverslaan vereist video-input en keepBackgroundMusic=true. Ze kunnen niet worden gecombineerd met keepOriginalVoice en kunnen niet overlappen met transcriptsegmenten.

Antwoord

boolean
vereist
Altijd true voor succesvolle verzoeken
string
vereist
Een voor mensen leesbaar bericht dat het resultaat beschrijft
string
vereist
De unieke identificatiecode voor het gemaakte vertaalproject. Gebruik deze ID om de status te controleren.
number
vereist
Ruwe schatting van de verwerkingstijd in minuten. De huidige schatting is vijf minuten verwerkingstijd per gestarte minuut aan bronmedia.

Voorbeelden

Opgeslagen woordenlijst-regels en aangepaste vertaalinstructies van het actieve account of team worden automatisch toegepast.

Reactievoorbeeld

Fouten