Skip to main content
Vertaalstatus ophalen

Vertaalstatus ophalen

Haal de huidige status van een vertaalproject op. Gebruik dit eindpunt om de voortgang te peilen en de URL van de vertaalde video te verkrijgen wanneer de verwerking is voltooid.

Aanvraag

Headers

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

Padparameters

string
vereist
De unieke identificatie van het vertaalproject die wordt geretourneerd door het Start Translation-eindpunt.

Antwoord

De antwoordstructuur varieert op basis van de vertaalstatus.

Algemene velden

string
vereist
De unieke identificatie van het project
string
vereist
De naam van het project
string
vereist
URL naar het originele geüploade video-/audiobestand
string
vereist
De gedetecteerde of opgegeven brontaal
string
vereist
De doeltaal voor vertaling
number
vereist
Duur van de inhoud in seconden
number
vereist
Unix-tijdstempel waarop het project is aangemaakt
string
vereist
API-workflow die het project heeft aangemaakt: translation of transcription.
string
vereist
Status van bron-transcriptie: processing, success of failed. Dit signaal staat los van de voltooiing van de nasynchronisatie.
object
vereist
Beschikbare genormaliseerde transcripties.
string
Identificatie van het vertaalwerk voor de momenteel gerapporteerde vertaalde versie.
string
Identificatie van de vertaalde versie voor de momenteel gerapporteerde vertaalde versie.
string
Huidige projectstap. Tijdens het aanmaken of transcriberen weerspiegelt dit de actieve aanmaakstap. Voorbeelden zijn downloading_content, content_validation en transcription_processing. Zodra de nasynchronisatie begint, kan dit overschakelen naar een actieve nasynchronisatiestap zoals smart_sync of audio_assembling. status: processing koppelt niet met actualProgressStep: done.
number
Geschat voortgangspercentage voor het aanmaken/transcriberen van het project (0-100)
string
Huidige nasynchronisatiestap voor de doeltaal (bijv. smart_sync, audio_enhancement, video_upload)
number
Geschat voortgangspercentage voor nasynchronisatie (0-100)
string
vereist
Huidige status van de vertaling: processing, success of failed

Lip Sync velden

Wanneer lipsynchronisatie werd aangevraagd, bevat het antwoord een extra lipSync-object:
object
Status en uitvoerdetails van lipsynchronisatie (alleen aanwezig wanneer lipsynchronisatie werd aangevraagd)
Wanneer lipsynchronisatie wordt aangevraagd, blijft de vertaling in processing totdat lipSync.status COMPLETED is. Als de lipsynchronisatie mislukt, wordt de status failed en de error.code is LIPSYNC_FAILED. Wanneer de lipsynchronisatie slaagt, lees het lipsynchronisatie-asset uit lipSync.videoUrl; translatedVideoUrl is de vertaalde video-output vóór de lipsynchronisatie-overlay.
Gebruik GET /v1/projects/{projectId} wanneer u de volledige vertaalde versiegeschiedenis of de volledige lipsynchronisatiegeschiedenis nodig heeft.

Velden voor succesvolle respons

Voor vertaalworkflows worden de volgende velden opgenomen wanneer status success is. Een workflow die alleen uit transcriptie bestaat, bereikt success zonder vertaalde mediavelden.
string
URL om het vertaalde videobestand te downloaden
string
URL om het vertaalde audiobestand afzonderlijk te downloaden

Velden voor mislukte respons

Wanneer status failed is, wordt het volgende extra veld opgenomen:
object
Foutdetails

Voorbeelden

Respons-voorbeelden

Verwerkingsstatus

Verwerkingsstatus (Lip Sync aangevraagd)

Status succes

Status succes (Lip Sync voltooid)

Status mislukt

Best practices voor polling

Aanbevolen polling-interval: 10-30 secondenDe vertaaltijd varieert op basis van videolengte en complexiteit. Reken voor een typische video van 2 minuten op 2-5 minuten verwerkingstijd.
Snelheidslimiet: 30 verzoeken per minuutVermijd vaker dan eens per 2 seconden te pollen om binnen de snelheidslimieten te blijven.

Fouten