프로젝트 전용 목소리 등록 조건 오류 해결
MCP 1.9.9 기준 · 2026-10-07 검토. 오류의 원인과 해결 담당, 복구 후 확인할 조건을 안내합니다. 기존 원본·승인 대본·목소리·타이밍·진행 중 작업을 보존합니다.
해결 담당: 프로젝트를 진행하는 AI가 기존 자료와 상태를 조회해 처리합니다.
어떻게 복구하나요?
- 같은 프로젝트의 기존 등록·진행 job을 조회하고 원본 화자·권리·단일 화자·샘플 청취 근거를 확인한다.
- 등록 지원·실제 비용·유효기간·원본과 샘플에 묶인 승인 범위를 확인한다. active 플래그만으로 가능하다고 하지 않는다.
- 기존 승인 clone을 재사용하거나 조건을 충족한 등록을 진행한다. 불가능하면 원본 발화 유지 또는 고객이 선택한 지원 음성 경로의 조건을 제시한다.
해결됐는지 확인하기
- 현재 프로젝트의 등록·화자·권리·샘플 승인·실제 비용 조건이 모두 확인된다.
성공 조건을 확인한 뒤 같은 프로젝트·run의 실패한 단계부터 이어갑니다. 유료 작업은 기존 접수·승인 범위를 다시 대조합니다.
해당 오류 코드
아래 코드는 이 절차를 공유합니다. 구체적인 원인 필드와 발생 조건은 코드별로 다르므로 AI가 설치본에서 해당 코드의 상세 항목을 읽어야 합니다.
CLONE_AUDIO_DURATION_INVALID
확인할 입력·상태: body.name.trim, metadata.duration.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “CLONE_AUDIO_DURATION_INVALID의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
CLONE_AUDIO_SOURCE_RANGE_INVALID
확인할 입력·상태: plan.beats?.some, input.audioFile, input.audioSha256, metadata.duration, source.shot.duration, source.model, source.revision_id.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “CLONE_AUDIO_SOURCE_RANGE_INVALID의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
CLONE_DIRECTION_INVALID
확인할 입력·상태: source.status, source.sha256, input.sourceSha256, source.model, source.shot?.id, input.assetId, direction.json, input.directionSha256, direction.assets?.find.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “CLONE_DIRECTION_INVALID의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
CLONE_FILE_REQUIRED
확인할 입력·상태: revision.manifest?.files?.find.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “CLONE_FILE_REQUIRED의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
CLONE_INPUT_INVALID
확인할 입력·상태: body.assetId, body.name, body.name.trim, body.audioFile, body.sourceRightsConfirmed, body.singleSpeakerReviewed.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “CLONE_INPUT_INVALID의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
CLONE_NATIVE_SOURCE_REQUIRED
확인할 입력·상태: compiled.planSha256, compiled.directionSha256, input.directionSha256, current.seedanceInput, source.shot.seedanceInput, source.shot, direction.cuts?.filter, input.assetId, plan.beats?.some, input.audioFile, input.audioSha256.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “CLONE_NATIVE_SOURCE_REQUIRED의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
CLONE_NOT_FOUND
확인할 입력·상태: body.jobId.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “CLONE_NOT_FOUND의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
CLONE_PLAN_INVALID
확인할 입력·상태: revision.manifest.files.find, plan.json, plan.creativeDirection?.sha256, plan.creativeDirection.sha256, input.directionSha256.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “CLONE_PLAN_INVALID의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
CLONE_PLAN_REQUIRED
확인할 입력·상태: direction.speechMode, source.model, direction.generationModel, asset.castIds?.length, asset.duration, source.shot?.duration, revision.manifest.files.find, plan.json.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “CLONE_PLAN_REQUIRED의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
CLONE_REVISION_REQUIRED
확인할 입력·상태: input.revisionId, revision.status, input.sourceJobId.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “CLONE_REVISION_REQUIRED의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
CLONE_SOURCE_INVALID
확인할 입력·상태: revision.status, input.sourceJobId, source.status, source.sha256, input.sourceSha256, source.model, source.shot?.id, input.assetId, direction.json, input.directionSha256.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “CLONE_SOURCE_INVALID의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
CLONE_STORYBOARD_INVALID
확인할 입력·상태: revision.manifest.files.find, compiled.json, compiled.shots?.find, input.assetId.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “CLONE_STORYBOARD_INVALID의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
CLONE_STORYBOARD_REQUIRED
확인할 입력·상태: revision.manifest.files.find, compiled.json.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “CLONE_STORYBOARD_REQUIRED의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
CLONE_SUBMIT_INVALID
확인할 입력·상태: body?.jobId, body?.approvalId.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “CLONE_SUBMIT_INVALID의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
DESKTOP_VOICE_CLONE_APPROVAL_REQUIRED
이 오류의 검증 조건은 코드별 상세 문서의 발생 위치에서 확인합니다.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “DESKTOP_VOICE_CLONE_APPROVAL_REQUIRED의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
DESKTOP_VOICE_CLONE_AUDIO_DURATION_INVALID
확인할 입력·상태: body.name.trim, metadata.duration.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “DESKTOP_VOICE_CLONE_AUDIO_DURATION_INVALID의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
DESKTOP_VOICE_CLONE_AUDIO_SOURCE_RANGE_INVALID
확인할 입력·상태: plan.beats?.some, input.audioFile, input.audioSha256, metadata.duration, source.shot.duration, source.model, source.revision_id.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “DESKTOP_VOICE_CLONE_AUDIO_SOURCE_RANGE_INVALID의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
DESKTOP_VOICE_CLONE_DIRECTION_INVALID
확인할 입력·상태: source.status, source.sha256, input.sourceSha256, source.model, source.shot?.id, input.assetId, direction.json, input.directionSha256, direction.assets?.find.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “DESKTOP_VOICE_CLONE_DIRECTION_INVALID의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
DESKTOP_VOICE_CLONE_FILE_REQUIRED
확인할 입력·상태: revision.manifest?.files?.find.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “DESKTOP_VOICE_CLONE_FILE_REQUIRED의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
DESKTOP_VOICE_CLONE_INPUT_INVALID
확인할 입력·상태: body.assetId, body.name, body.name.trim, body.audioFile, body.sourceRightsConfirmed, body.singleSpeakerReviewed.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “DESKTOP_VOICE_CLONE_INPUT_INVALID의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
DESKTOP_VOICE_CLONE_NATIVE_SOURCE_REQUIRED
확인할 입력·상태: compiled.planSha256, compiled.directionSha256, input.directionSha256, current.seedanceInput, source.shot.seedanceInput, source.shot, direction.cuts?.filter, input.assetId, plan.beats?.some, input.audioFile, input.audioSha256.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “DESKTOP_VOICE_CLONE_NATIVE_SOURCE_REQUIRED의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
DESKTOP_VOICE_CLONE_NOT_FOUND
확인할 입력·상태: body.jobId.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “DESKTOP_VOICE_CLONE_NOT_FOUND의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
DESKTOP_VOICE_CLONE_PLAN_INVALID
확인할 입력·상태: revision.manifest.files.find, plan.json, plan.creativeDirection?.sha256, plan.creativeDirection.sha256, input.directionSha256.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “DESKTOP_VOICE_CLONE_PLAN_INVALID의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
DESKTOP_VOICE_CLONE_PLAN_REQUIRED
확인할 입력·상태: direction.speechMode, source.model, direction.generationModel, asset.castIds?.length, asset.duration, source.shot?.duration, revision.manifest.files.find, plan.json.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “DESKTOP_VOICE_CLONE_PLAN_REQUIRED의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
DESKTOP_VOICE_CLONE_REQUEST_MISMATCH
이 오류의 검증 조건은 코드별 상세 문서의 발생 위치에서 확인합니다.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “DESKTOP_VOICE_CLONE_REQUEST_MISMATCH의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
DESKTOP_VOICE_CLONE_RESULT_INVALID
이 오류의 검증 조건은 코드별 상세 문서의 발생 위치에서 확인합니다.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “DESKTOP_VOICE_CLONE_RESULT_INVALID의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
DESKTOP_VOICE_CLONE_REVISION_REQUIRED
확인할 입력·상태: input.revisionId, revision.status, input.sourceJobId.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “DESKTOP_VOICE_CLONE_REVISION_REQUIRED의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
DESKTOP_VOICE_CLONE_SOURCE_INVALID
확인할 입력·상태: revision.status, input.sourceJobId, source.status, source.sha256, input.sourceSha256, source.model, source.shot?.id, input.assetId, direction.json, input.directionSha256.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “DESKTOP_VOICE_CLONE_SOURCE_INVALID의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
DESKTOP_VOICE_CLONE_STORYBOARD_INVALID
확인할 입력·상태: revision.manifest.files.find, compiled.json, compiled.shots?.find, input.assetId.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “DESKTOP_VOICE_CLONE_STORYBOARD_INVALID의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
DESKTOP_VOICE_CLONE_STORYBOARD_REQUIRED
확인할 입력·상태: revision.manifest.files.find, compiled.json.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “DESKTOP_VOICE_CLONE_STORYBOARD_REQUIRED의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
DESKTOP_VOICE_CLONE_SUBMIT_INVALID
확인할 입력·상태: body?.jobId, body?.approvalId.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “DESKTOP_VOICE_CLONE_SUBMIT_INVALID의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
NATIVE_NARRATION_CLONE_DEPENDENCY
확인할 입력·상태: result?.jobs, project.cloud?.runId, result?.paidExecutionAvailable.
복구 검증: 실제 복구 미검증
위 복구 순서에 따라 현재 입력과 저장 상태를 확인하고, 성공 조건을 충족한 뒤 기존 작업을 이어갑니다.
AI에게 “NATIVE_NARRATION_CLONE_DEPENDENCY의 코드별 복구 문서를 읽고, 기존 프로젝트에서 해당 조건을 확인해줘”라고 요청하세요.
작업 ID와 복구 이력
AI가 실패하면 오류 코드와 기존 작업 ID를 기록하고 같은 작업의 상태부터 확인합니다. MCP 오류 기록은 같은 컴퓨터에서 다시 읽을 수 있습니다. 고객에게 내부 ID나 크레딧 사용량을 다시 입력하게 하지 않습니다. 작업 ID·고객 자료는 이 공개 사전에 게시하지 않습니다.