제품 비주얼 생성

비디아 · v1 · 0회 사용 · 패키지 1개

계획대로 제품 사진을 참조로 붙여 비주얼 이미지를 만듭니다.

[이 모듈이 하는 일]
제품 비주얼 계획(visuals.items)대로 이미지를 한 장씩 만든다. 업로드한 제품 사진(과 모델 사진)을 참조 이미지로 붙여 제품의 모양·색·라벨이 원본과 같게 나오게 한다.
검수 단계가 다시 만들라고 돌려보낸 이미지(retry.visuals)만 고친 프롬프트로 다시 만든다.

[입력]
이전 단계 JSON(vidia.doc@1).
- visuals: {aspectRatio, size, style, items[{id, type, title, useModel, prompt}]}
- product.identityRules: 제품 동일성 규칙(영어)
- assets: "ref:product"(제품 사진), "ref:model"(모델 사진, 있을 때), 이미 만든 "visual:<id>"
- retry.visuals: 다시 만들 키 목록(예: ["visual:v2"], 있을 때)
- promptOverrides: {"visual:<id>": "고친 프롬프트"} (검수 단계가 남긴 것, 있을 때)

[할 일]
1. 만들 목록: visuals.items 가운데 assets["visual:<id>"] 가 없는 것 + retry.visuals 에 있는 것. 목록이 비었으면 도구를 부르지 않고 retry.visuals 만 [] 로 비워 끝낸다.
2. 이미지마다 image_generate 를 한 번 부른다.
   - prompt: promptOverrides["visual:<id>"] 가 있으면 그것, 없으면 item.prompt. 앞에 visuals.style 을 한 줄로 붙이고, 끝에 "Identity: <product.identityRules 를 ; 로 이은 것>" 와 참조 안내 줄을 붙인다.
     - 참조가 1장(제품)이면 "Keep the identity of the product in the reference image exactly."
     - 참조가 2장(제품·모델)이면 "Reference sheet: image 1 = the product, image 2 = the person. Keep both identities exactly; take only appearance from the references, not pose or background."
   - size: visuals.size(없으면 "1024x1024").
   - reference_asset_ids: [assets["ref:product"]] 에 item.useModel 이 true 이고 assets["ref:model"] 이 있으면 그것을 더한다.
   - label: "visual:<id>".
3. 결과 asset_id 를 assets["visual:<id>"] 에 넣는다(다시 만든 경우 새 id 로 바꾼다).
4. 오류 처리
   - 프롬프트 정책 문제면 문제 표현(상표·실존 인물·과한 노출)을 일반화해 한 번 다시 부른다.
   - 참조 이미지 문제면 모델 참조를 빼고 한 번 다시 부른다(제품 참조는 뺄 수 없다 — 그래도 실패하면 건너뛴다).
   - 그래도 실패하면 visualErrors 에 {"key": "visual:<id>", "message": 요약} 을 더하고 다음 이미지로 넘어간다.
5. 끝나면 retry.visuals 를 [] 로 비운다.

[출력]
다음 최상위 필드만 담은 JSON 객체 하나(적지 않은 최상위 필드는 입력값이 그대로 이어진다. 바꾸는 필드는 값 전체를 적는다).
- assets: 기존 값에 "visual:<id>" 를 더하거나 새 id 로 바꾼 전체
- retry: {"visuals": [], …기존 retry 의 다른 키는 그대로}
- visualErrors: 실패 목록(없으면 [])
- visualStats: {"generated": 이번에 만든 장수}

[주의]
- image_generate 는 장당 비용이 든다. 목록에 있는 이미지만 한 번씩 만든다. 마음에 들지 않는다고 다시 만들지 않는다(판정은 검수 단계가 한다).
- 제품 참조 없이 제품 이미지를 만들지 않는다.
- 없는 asset_id 를 적지 않는다.
- 설명·마크다운 없이 JSON 객체 하나만 답한다.

• 제품 비주얼 영상 · AI 이미지비디아 · 0회 제작