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

Projectaanmaak, vertaling en nasynchronisatie controleren allemaal de limiet van uw account voor actieve vertalingen (maximaal 10, mogelijk lager). Alleen lopende vertaal- of nasynchronisatietaken nemen plaatsen in; projecten met alleen transcriptie doen dat niet. Bij het bereiken van de limiet retourneert de API CONCURRENT_TRANSLATION_LIMIT_REACHED (HTTP 429). De toegepaste limiet staat in details.limit.

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, pt_brazil, 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.
string
De definitieve SRT in de doeltaal, door u geschreven. Als dit veld is gezet, slaat VoiceCheap de vertaalengine over en genereert het alleen de stemmen en mixt de uitvoer vanuit deze tekst. Zie de alleen-nasynchronisatiemodus voor de uitlijningsregels. Maximaal 1.000.000 tekens.
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 duidelijke zwart-witte ondertitels toegevoegd. Gebruik subtitlesSource om originele tekst (brontaal) of vertaalde tekst (doeltaal) te kiezen. De ondertitels worden automatisch gesynchroniseerd voor de leesbaarheid.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: 180 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 custom is. Gebruik een ID uit dubbing_voices_list: een catalogusstem of een aangepaste stem die door het geauthenticeerde account is opgeslagen. Teamfacturering geeft geen toegang tot de opgeslagen stemmen van andere leden.
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). Een speakerBoost-waarde uit eerdere integraties wordt nog geaccepteerd, maar heeft geen effect meer.
Deze instellingen zijn alleen van toepassing wanneer voiceMode gelijk is aan cloning.
Standaardwaarden (gebalanceerd):
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.

Alleen-nasynchronisatie (eigen vertaling)

Stuur translatedSrt wanneer u de vertaling al hebt en VoiceCheap alleen de stemmen moet genereren en de uitvoer moet mixen. In deze modus:
  • Geen AI-vertaling en geen SmartSync-herformulering. Elke cue wordt letterlijk ingesproken. Opgeslagen glossariumregels en aangepaste vertaalinstructies worden ook niet toegepast, omdat die alleen in de vertaalengine draaien.
  • De timing komt uit de bron. Elk segment houdt begin, einde en spreker van het brontranscript; de tijdcodes van uw SRT dienen alleen om cues aan segmenten te koppelen. De gegenereerde spraak wordt opgerekt of ingekort zodat ze in het segmentvenster past, zonder de formulering te wijzigen.
  • Dezelfde credits als een vertaling. De run wordt precies afgerekend als een standaardvertaling van hetzelfde medium.
  • Stem-, achtergrond-, ondertitel- en lip-sync-opties blijven gelden. voiceMode, keepBackgroundMusic, subtitles, lipSyncMode en de andere nasynchronisatie-opties gedragen zich zoals hierboven beschreven.
Het message van het antwoord bevestigt de modus, en de vertaalde versie meldt dubbingMode: "dub-only" in Projectdetails ophalen.

Uitlijningsregels

Uitlijningsproblemen in de modus timestamps zijn pas na de transcriptie bekend en worden asynchroon gemeld. Het statusendpoint geeft HTTP 200 met status: "failed" en een error met code en message terug; de webhook project.translation.failed bevat dezelfde code en melding. Bij TRANSLATED_SRT_UNMATCHED_CUES staan de niet gekoppelde cuenummers in de melding, bij TRANSLATED_SRT_MISSING_SEGMENTS de segmentindexen zonder cue. Deze antwoorden bevatten geen gestructureerd details-veld. Voor een eenduidige koppeling stuurt u sourceSrt samen met translatedSrt, of maakt u het project eerst aan met Project aanmaken, exporteert u het transcript, vertaalt u het cue voor cue en roept u Project nasynchroniseren aan.

Het tempo controleren

Lange zinnen moeten worden versneld om in hun segment te passen. Exporteer het vertaalde transcript met Projecttranscriptie exporteren: elk vertaald segment bevat finalSpeedFactor, de verhouding tussen de gegenereerde spraak en het segmentvenster vóór de laatste tempo-aanpassing. Kort de cues in die ongeveer boven 1.3 uitkomen en start de nasynchronisatie opnieuw met de herziene SRT.
translatedSrt wordt ook geaccepteerd door het JSON-endpoint Project nasynchroniseren, dat een al getranscribeerd project nasynchroniseert zonder het medium opnieuw te uploaden.

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