Extracción de subtítulos

Usa este flujo de trabajo para crear archivos de subtítulos a partir de un video. Weydub admite dos vías de extracción:

• Extracción mediante OCR para subtítulos incrustados que ya son visibles en el fotograma del video.
• Extracción mediante ASR para diálogos hablados en la pista de audio.

¿Quieres inspeccionar la calidad de la salida antes de crear una integración? Prueba el flujo web correspondiente de Weydub: Generar subtítulos.

Para conocer la explicación a nivel de sistema del OCR temporal de video, el filtrado de texto de escenas y la segmentación ASR preparada para subtítulos, lee Generación de subtítulos con OCR de video y ASR.

Endpoint

POST /v-w-c/gateway/ve/work/free

La extracción de subtítulos es asíncrona. Guarda body.idProject y body.dataList[].id, y después usa el modelo de tareas asíncronas para la consulta periódica, los callbacks, el comportamiento de reintento y la firma de callbacks.

Acceso y límites

Elige OCR o ASR

No uses OCR para transcribir videos que solo contienen habla. No uses ASR para leer subtítulos incrustados en videos sin diálogo.

Carga útil de extracción OCR

Usa OCR cuando los subtítulos ya estén incrustados en la imagen del video.

{
  "urls": ["https://example.com/video.mp4"],
  "needChineseOcclude": 14,
  "videoInpaintLang": "en",
  "lang": "en",
  "videoInpaintMasks": "[{\"type\":\"trans_only_ocr\",\"region\":[[0,0.8],[1,0.8],[1,1],[0,1]]}]",
  "extraOptions": "{\"extra_inpaint_config\":{\"auto_correct_on\":false,\"strip_last_punct_on\":true,\"scene_filter_on\":false}}",
  "callback": "https://your-domain.example/webhooks/weydub"
}

Notas:

• needChineseOcclude debe ser 14.
• videoInpaintMasks es obligatorio para la extracción OCR y debe ser una cadena JSON compacta antes de firmar.
• type debe ser trans_only_ocr.
• Establece lang igual a videoInpaintLang cuando no se necesite traducción.
• Las coordenadas están normalizadas de 0 a 1 y ordenadas como esquina superior izquierda, esquina superior derecha, esquina inferior derecha y esquina inferior izquierda.

Máscaras OCR

Usa una o más máscaras cuando conozcas el área visible de los subtítulos. Las máscaras delimitadas por tiempo ayudan a evitar la extracción de indicios temporales de la trama o texto de registro como si fueran diálogos.

Regiones habituales:

Opciones de OCR

extraOptions.extra_inpaint_config permite ajustar la limpieza del OCR:

Mantén extraOptions como una cadena JSON compacta en las cargas útiles de la API pública, salvo que el contrato de tu cuenta indique lo contrario.

Carga útil de extracción ASR

Usa ASR cuando el video contenga habla y necesites una transcripción sincronizada.

{
  "urls": ["https://example.com/video.mp4"],
  "needWanyin": 1,
  "sourceLang": "en",
  "lang": "en",
  "wyTaskType": "ONLY_ASR",
  "needWyEdit": 0,
  "wyNeedText": 0,
  "extraOptions": "{\"asr_speaker_detect_on\":true,\"extra_video_translate_config\":{\"remove_last_punct_on\":true}}",
  "callback": "https://your-domain.example/webhooks/weydub"
}

Notas:

• wyTaskType debe ser ONLY_ASR.
• wyNeedText: 0 significa que no se deben renderizar subtítulos en un video nuevo.
• needWyEdit: 0 desactiva el comportamiento de edición manual/borrador profesional para esta tarea de extracción.
• sourceLang es el idioma hablado. lang es el idioma de salida de los subtítulos; usa el mismo código cuando no se necesite traducción.

Opciones de ASR

Parámetros

Resultados

Las tareas de extracción completadas correctamente pueden devolver:

• srcSrtUrl
• tgtSrtUrl
• processStatus
• processProgress
• paidPoint
• metadatos de la tarea dentro del elemento de trabajo devuelto

La extracción OCR y ASR no necesita renderizar un video nuevo. Consulta periódicamente hasta que processStatus === 1 antes de leer srcSrtUrl o tgtSrtUrl.

Los callbacks envían directamente la carga útil del elemento de trabajo, sin el envoltorio externo code / msg / body que usan las respuestas de consulta periódica.

Notas para agentes

• Elige OCR para texto de subtítulos incrustados; elige ASR para diálogos hablados.
• Mantén videoInpaintMasks y extraOptions compactos y convertidos en cadenas antes de firmar.
• No envíes las matrices de máscaras OCR como matrices nativas salvo que el contrato de tu cuenta lo indique.
• Usa la consulta de enumeraciones (POST /v-w-c/enum/query2) para obtener la compatibilidad actual de sourceLang y Lang; este endpoint de enumeración no requiere firma.
• Consulta periódicamente hasta que processStatus sea 1 antes de leer srcSrtUrl o tgtSrtUrl.
• Guarda los archivos de subtítulos antes de la limpieza por retención.