JavaScript 맵 검사를 이용한 재정렬된 사진 참조 처리

사진 참조 프롬프트에는 종종 @Image1 및 @Image2와 같은 위치 태그가 포함됩니다. 이는 이미지 배열의 순서가 요청의 의미 일부를 구성한다는 것을 의미합니다. 유효한 파일 개수만으로는 충분하지 않습니다. 재정렬된 배열은 각 태그가 어떤 이미지를 참조하는지 조용히 변경시킬 수 있습니다.

저는 MixVio 팀에서 근무하고 있습니다. 이 튜토리얼에서는 그러한 계획 문제를 해결하기 위한 간단한 로컬 JavaScript 검사기를 소개합니다. 이는 MixVio나 모델 제공업체를 호출하거나, 에셋을 업로드하거나, 내부 API 스키마를 노출하지 않습니다. 이 방법은 간략한 설명(brief)이 1 기반 참조 태그를 사용하는 모든 곳에서 재사용 가능합니다.

의도된 참조 맵이 다음과 같다고 가정해 봅시다:

{
"@Image1": "product-front",
"@Image2": "desk-scene"
...
}

여기서 레이블은 사설 에셋 ID나 서명된 URL이 아닌 로컬 별칭입니다. 프롬프트는 @Image1의 제품을 @Image2의 책상 위에 배치하도록 지시합니다. 만약 사람이 이미지 팩의 순서를 재배열한다면, 해당 태그들은 여전히 그럴듯해 보이지만 의미가 변경됩니다.

두 가지를 유지해야 합니다: 업로드하려는 의도된 순서의 레이블과 역할을 설명하는 별도의 예상 맵입니다. 아래 검사기는 현재 순서에 따라 태그들을 해석한 다음, 그 결과를 예상 맵과 비교합니다.

이 도우미 함수(helper)를 reference-map-check.mjs로 저장하세요. 이 코드는 누락된 참조와 일치하지 않는 별칭을 보고합니다. 또한 중복 이름은 검토를 모호하게 만들기 때문에, 잘못 구성된 계획 객체와 반복되는 별칭도 거부합니다.

// 교육용 로컬 레이블만 사용합니다. 업로드, API 요청 또는 모델 실행 없음.
export function inspectReferenceMap(plan) {
if (!plan || typeof plan !== 'object' || Array.isArray(plan)) {
...

이 예시를 도우미 함수 옆에 두고, 현재 Node.js 설치로 실행해 보세요:

import assert from 'node:assert/strict';
import { inspectReferenceMap } from './reference-map-check.mjs';
const plan = {
...

재배열된 팩은 다음을 보고합니다:

@Image1이 desk-scene에 매핑되었으며, 예상값은 product-front입니다.
@Image2가 product-front에 매핑되었으며, 예상값은 desk-scene입니다.

올바른 수정은 의도된 순서를 복원하거나, 프롬프트와 예상 맵을 함께 의도적으로 변경하는 것입니다. 단순히 검사를 무시하지 마십시오. 빈 에러 목록은 로컬 레이블이 예상 계획과 일치한다는 것만을 의미합니다.

로컬 예제는 원래 매핑, 역순으로 포장된 항목, 누락 및 범위를 벗어난 태그, 중복 레이블, 반복되는 유효 참조, 그리고 잘못 구성된 계획에 대해 검사를 통과했습니다. 이것들은 JavaScript 검사이며 모델 생성 테스트가 아닙니다.

이 파서는 @Image 다음에 숫자가 오고 단어 경계로 끝나는 것을 인식합니다. 이것은 완전한 프롬프트 문법은 아니며, 모든 잘못 구성된 태그를 유효성 검사하거나, 이미지 내용을 검사하거나, 소유권을 증명하거나, 업로드 성공 여부를 확인하거나, 출력이 주제를 보존할지 예측하지는 않습니다. 오직 로컬 참조 레이블만을 비교합니다. 실제 통합에서는 별도로 검증된 프롬프트 구문, 파일 검사 및 문서화된 서버 검증 프로세스를 사용하십시오.

이 구체적인 예시의 경우, 현재 MixVio의 Vidu Q4 참조 경로는 1~12장의 사진과 최대 세 개의 MP3 참조를 허용합니다. 단일 사진 경로의 경우 정확히 한 장의 사진을 사용하며, 사진 비율을 따르고 네이티브 오디오를 포함합니다. 이러한 제어는 2026년 10월 10일에 확인되었으며, 모든 Vidu 인터페이스의 제한 사항과 동일하지 않습니다. 위의 도우미 코드는 참조 매핑과 경로 검증이 서로 다른 문제를 해결하기 때문에 의도적으로 이를 하드코딩하지 않았습니다.

생성 후에는 정체성(identity), 텍스트, 움직임(motion), 사운드에 대해 통과(pass), 실패(fail) 또는 미검토(not reviewed)로 구분하여 별도의 출력 검토를 유지하십시오. 실제 클립이 존재하기 전까지 모든 결과는 '미검토' 상태입니다. 올바르게 매핑된 요청이라도 부적절한 출력을 생성할 수 있습니다.

공개 정보: AI의 도움을 받아 작성되었습니다. JavaScript 예제는 로컬에서 실행되었으며, 이 튜토리얼을 위해 비디오가 생성되지는 않았습니다. 사진 레이블과 제품 장면은 예시용입니다. 이것은 MixVio 팀이 이전에 발표한 샷-매니페스트 가이드의 독립적인 기술적 각색본으로, 참조 순서에 중점을 두었습니다.