Skip to main content
번역 상태 가져오기

번역 상태 가져오기

번역 프로젝트의 현재 상태를 검색합니다. 이 엔드포인트를 사용하여 진행 상황을 폴링하고 처리가 완료되면 번역된 비디오 URL을 가져옵니다.

요청

헤더

string
필수
VoiceCheap API 키입니다. app.voicecheap.ai/page-api에서 키를 발급받으세요.

경로 매개변수

string
필수
Start Translation 엔드포인트에서 반환된 번역 프로젝트의 고유 식별자입니다.

응답

응답 구조는 번역 상태에 따라 다릅니다.

공통 필드

string
필수
프로젝트의 고유 식별자
string
필수
프로젝트 이름
string
필수
원본 업로드 비디오/오디오 파일의 URL
string
필수
감지되거나 지정된 원본 언어
string
필수
번역 대상 언어
number
필수
콘텐츠 지속 시간(초)
number
필수
프로젝트가 생성된 Unix 타임스탬프
string
필수
프로젝트를 생성한 API 워크플로우: translation 또는 transcription.
string
필수
소스 전사 상태: processing, success 또는 failed. 이 신호는 더빙 완료 여부와 독립적입니다.
object
필수
사용 가능한 정규화된 전사본입니다.
string
현재 보고된 번역 버전에 대한 번역 작업 식별자입니다.
string
현재 보고된 번역 버전에 대한 번역 버전 식별자입니다.
string
현재 프로젝트 단계입니다. 생성 또는 전사 중에는 활성 생성 단계를 반영합니다. 예시로는 downloading_content, content_validationtranscription_processing가 있습니다. 더빙이 시작되면 smart_sync 또는 audio_assembling과 같은 활성 더빙 단계로 전환될 수 있습니다. status: processing은(는) actualProgressStep: done과(와) 페어링되지 않습니다.
number
프로젝트 생성/전사에 대한 대략적인 진행률(0-100)
string
대상 언어에 대한 현재 더빙 단계(예: smart_sync, audio_enhancement, video_upload)
number
더빙에 대한 대략적인 진행률(0-100)
string
필수
현재 번역 상태: processing, success 또는 failed

Lip Sync 필드

립싱크가 요청된 경우, 응답에는 추가적인 lipSync 객체가 포함됩니다:
object
립싱크 상태 및 출력 세부 정보(립싱크가 요청된 경우에만 표시됨)
립싱크가 요청되면, lipSync.statusCOMPLETED될 때까지 번역은 processing 상태로 유지됩니다. 립싱크가 실패하면 상태는 failed이 되고 error.codeLIPSYNC_FAILED입니다. 립싱크가 성공하면 lipSync.videoUrl에서 립싱크된 에셋을 읽어오십시오. translatedVideoUrl 는 립싱크 오버레이 이전의 번역된 비디오 출력입니다.
전체 번역 버전 기록이나 전체 립싱크 기록이 필요할 때 GET /v1/projects/{projectId}을 사용하십시오.

성공 응답 필드

번역 워크플로우의 경우, statussuccess일 때 다음 필드가 포함됩니다. 전사 전용 워크플로우는 번역된 미디어 필드 없이 success에 도달합니다.
string
번역된 비디오 파일을 다운로드하기 위한 URL
string
번역된 오디오 파일을 별도로 다운로드하기 위한 URL

실패 응답 필드

statusfailed일 때, 다음 추가 필드가 포함됩니다:
object
오류 세부 정보

예시

응답 예시

처리 상태

처리 상태 (Lip Sync 요청됨)

성공 상태

성공 상태 (Lip Sync 완료됨)

실패 상태

폴링 모범 사례

권장 폴링 간격: 10-30초번역 시간은 비디오 길이와 복잡도에 따라 다릅니다. 일반적인 2분짜리 비디오의 경우 2-5분의 처리 시간이 소요됩니다.
요청 제한: 분당 30회 요청요청 제한을 준수하기 위해 2초에 한 번보다 더 자주 폴링하지 마십시오.

오류