Skip to main content
Obtener estado de la traducción

Obtener estado de la traducción

Recupere el estado actual de un proyecto de traducción. Utilice este endpoint para consultar el progreso y obtener la URL del video traducido cuando el procesamiento se haya completado.

Solicitud

Encabezados

string
requerido
Su clave API VoiceCheap. Obtenga una en app.voicecheap.ai/page-api.

Parámetros de ruta

string
requerido
El identificador único del proyecto de traducción devuelto desde el endpoint Start Translation.

Respuesta

La estructura de la respuesta varía según el estado de la traducción.

Campos comunes

string
requerido
El identificador único del proyecto
string
requerido
El nombre del proyecto
string
requerido
URL del archivo de video/audio original cargado
string
requerido
El idioma original detectado o especificado
string
requerido
El idioma de destino para la traducción
number
requerido
Duración del contenido en segundos
number
requerido
Marca de tiempo Unix de cuando se creó el proyecto
string
requerido
Flujo de trabajo de la API que creó el proyecto: translation o transcription.
string
requerido
Estado de la transcripción de origen: processing, success o failed. Esta señal es independiente de la finalización del doblaje.
object
requerido
Transcripciones normalizadas disponibles.
string
Identificador de trabajo de traducción para la versión traducida reportada actualmente.
string
Identificador de versión traducida para la versión traducida reportada actualmente.
string
Paso actual del proyecto. Durante la creación o transcripción, esto refleja el paso de creación activo. Los ejemplos incluyen downloading_content, content_validation y transcription_processing. Una vez que comienza el doblaje, puede cambiar a un paso de doblaje activo como smart_sync o audio_assembling. status: processing no se empareja con actualProgressStep: done.
number
Porcentaje de progreso aproximado para la creación/transcripción del proyecto (0-100)
string
Paso de doblaje actual para el idioma de destino (p. ej., smart_sync, audio_enhancement, video_upload)
number
Porcentaje de progreso aproximado para el doblaje (0-100)
string
requerido
Estado actual de la traducción: processing, success o failed

Campos de Lip Sync

Cuando se solicitó la sincronización labial, la respuesta incluye un objeto lipSync adicional:
object
Estado y detalles de salida de la sincronización labial (solo presente cuando se solicitó la sincronización labial)
Cuando se solicita la sincronización labial, la traducción permanece en processing hasta que lipSync.status sea COMPLETED. Si la sincronización labial falla, el estado se convierte en failed y el error.code es LIPSYNC_FAILED. Cuando la sincronización labial tiene éxito, lea el activo con sincronización labial desde lipSync.videoUrl; translatedVideoUrl es la salida de video traducido antes de la superposición de sincronización labial.
Utilice GET /v1/projects/{projectId} cuando necesite el historial completo de versiones traducidas o el historial completo de sincronización labial.

Campos de respuesta de éxito

Para los flujos de trabajo de traducción, se incluyen los siguientes campos cuando status es success. Un flujo de trabajo solo de transcripción llega a success sin campos de medios traducidos.
string
URL para descargar el archivo de video traducido
string
URL para descargar el archivo de audio traducido por separado

Campos de respuesta de error

Cuando status es failed, se incluye el siguiente campo adicional:
object
Detalles del error

Ejemplos

Ejemplos de respuesta

Estado de procesamiento

Estado de procesamiento (Lip Sync solicitado)

Estado de éxito

Estado de éxito (Lip Sync completado)

Estado de error

Mejores prácticas de sondeo

Intervalo de sondeo recomendado: 10-30 segundosEl tiempo de traducción varía según la duración y la complejidad del video. Para un video típico de 2 minutos, espere de 2 a 5 minutos de tiempo de procesamiento.
Límite de tasa: 30 solicitudes por minutoEvite realizar sondeos con una frecuencia superior a una vez cada 2 segundos para mantenerse dentro de los límites de tasa.

Errores