자막 추출

이 워크플로를 사용하여 비디오에서 자막 파일을 생성하세요. Weydub에서는 두 가지 추출 경로를 지원합니다:

• OCR 추출: 비디오 프레임에 이미 표시된 하드코딩 자막.
• ASR 추출: 오디오 트랙의 음성 대화.

구축하기 전에 출력 품질을 확인하고 싶으신가요? 이에 해당하는 Weydub 웹 워크플로를 사용해 보세요: 자막 생성.

시간 기반 비디오 OCR, 장면 텍스트 필터링 및 자막에 적합한 ASR 분할에 대한 시스템 수준의 설명은 비디오 OCR 및 ASR을 활용한 AI 자막 생성을 참조하세요.

엔드포인트

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

자막 추출은 비동기 방식으로 처리됩니다. body.idProject 및 body.dataList[].id을 저장한 다음, 폴링, 콜백, 재시도 동작 및 콜백 서명에는 비동기 작업 모델을 사용하세요.

액세스 및 제한

OCR 또는 ASR 선택

음성만 있는 비디오를 전사하는 데 OCR을 사용하지 마세요. 무음 하드코딩 자막을 읽는 데 ASR을 사용하지 마세요.

OCR 자막 추출 페이로드

자막이 비디오 이미지에 이미 삽입되어 있으면 OCR 방식을 사용하세요.

{
  "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"
}

참고 사항:

• needChineseOcclude 값은 14이어야 합니다.
• videoInpaintMasks 필드는 OCR 추출에 필요하며, 서명하기 전에 간결한 JSON 문자열이어야 합니다.
• type 값은 trans_only_ocr이어야 합니다.
• 번역이 필요하지 않으면 lang 값을 videoInpaintLang과 동일하게 설정하세요.
• 좌표는 0에서 1까지 정규화되며, 왼쪽 위, 오른쪽 위, 오른쪽 아래, 왼쪽 아래 순으로 배열됩니다.

OCR 마스크

화면에 표시되는 자막 영역을 알고 있는 경우 하나 이상의 마스크를 사용하세요. 시간 범위가 지정된 마스크를 사용하면 일시적인 줄거리 힌트나 등록 텍스트가 대화로 추출되는 것을 방지할 수 있습니다.

일반적인 영역:

OCR 옵션

extraOptions.extra_inpaint_config로 OCR 정리를 조정할 수 있습니다:

계정 계약에 달리 명시되어 있지 않다면 공개 API 페이로드에서 extraOptions 값은 간결한 JSON 문자열로 유지하세요.

ASR 자막 추출 페이로드

비디오에 음성이 있고 시간 정보가 있는 전사본이 필요한 경우 ASR 방식을 사용하세요.

{
  "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"
}

참고 사항:

• wyTaskType 값은 ONLY_ASR이어야 합니다.
• wyNeedText: 0은 자막을 새 비디오에 렌더링하지 않음을 의미합니다.
• needWyEdit: 0은 이 추출 작업에서 수동 편집/프로 초안 동작을 비활성화합니다.
• sourceLang은 음성 언어입니다. lang은 자막 출력 언어이며, 번역이 필요하지 않으면 동일한 코드를 사용하세요.

ASR 옵션

매개변수

출력

성공한 추출 작업에서는 다음 항목이 반환될 수 있습니다:

• srcSrtUrl
• tgtSrtUrl
• processStatus
• processProgress
• paidPoint
• 반환된 작업 항목 내의 작업 메타데이터

OCR 및 ASR 추출에서는 새 비디오를 렌더링할 필요가 없습니다. srcSrtUrl 또는 tgtSrtUrl을 읽기 전에 processStatus === 1이 될 때까지 폴링하세요.

콜백은 폴링 응답에 사용되는 외부 code / msg / body 래퍼 없이 작업 항목 페이로드를 직접 전송합니다.

에이전트 참고 사항

• 영상에 번인된 자막 텍스트에는 OCR을 선택하고, 음성 대화에는 ASR을 선택하세요.
• 서명하기 전에 videoInpaintMasks 및 extraOptions을 간결한 형식으로 유지하고 문자열화하세요.
• 계정 계약에 그렇게 명시되어 있지 않은 한 OCR 마스크 배열을 네이티브 배열로 전송하지 마세요.
• enum 쿼리(POST /v-w-c/enum/query2)를 사용하여 현재 sourceLang 및 Lang 지원 정보를 가져오세요. 이 enum 엔드포인트에는 서명이 필요하지 않습니다.
• srcSrtUrl 또는 tgtSrtUrl을 읽기 전에 processStatus이 1이 될 때까지 폴링하세요.
• 보존 데이터 정리 전에 자막 파일을 저장하세요.