HiAPI 패션 룩북 비디오
단일 숏 패션 샷을 생성합니다. 인물 사용 권한이 확인되고, 의상이 식별 가능하며, 참조 역할이 명시적이어야 하며, 유료 생성은 별도로 승인되어야 합니다.
요청 라우팅
레시피를 선택하세요:
| 레시피 | 최적 사용 사례 |
|---|---|
runway-walk | 하나의 제어된 포즈로 끝나는 전신 워크 |
outfit-transition | 정확히 하나의 초기-대상 아웃핏 변환 |
lookbook-pose | 하나의 완전한 룩을 보여주는 느린 회전 또는 포즈 |
person-showcase | 절제된 움직임이 있는 비언어적 패션 인물 사진 |
제공된 자산에서 미디어 경로를 선택하세요:
| 미디어 입력 | 경로 | 모델 |
|---|---|---|
| 이미지 없음 | 텍스트-투-비디오 | kling-3.0-omni/text-to-video |
| 정확히 하나의 인물 또는 전체 룩 이미지, 다른 이미지 없음 | 이미지-투-비디오 | kling-3.0-omni/image-to-video |
| 의상 또는 스타일 참조(최대 총 9개 이미지) | 다중 참조 생성 | seedance-2.0-fast |
최대 하나의 인물 이미지, 하나의 대상 룩에 대해 최대 6개의 의상 이미지, 최대 2개의 스타일 이미지를 사용하세요. 총 제한은 9개입니다. 참조 기반 outfit-transition에는 하나의 인물 이미지와 하나 이상의 의상 이미지가 필요합니다. 텍스트 전용 outfit-transition은 가상적이며 특정 의상이나 아이덴티티를 보장할 수 없습니다.
말하는 프레젠터는 $hiapi-product-spokesperson-video에 위임하세요. 비디오의 액션 또는 카메라 가이드는 $hiapi-reference-motion-transfer에 위임하세요. 멀티샷 편집, 자막, 음악, 로고 또는 CTA 합성은 비디오 편집 워크플로에 위임하세요.
권리 및 범위 확인
이미지를 사용하기 전에 사용자가 해당 이미지를 소유하거나 사용할 권한이 있는지 확인하세요. 모든 미디어 요청에 --asset-rights-confirmed를 요구하고, 인물 이미지가 제공되는 경우 추가로 --person-consent-confirmed를 요구하세요. 이미지 자체로부터 동의, 소유권 또는 완전한 상업적 라이선스를 추론하지 마세요.
생성된 출력물을 창의적인 패션 시각화로 설명하세요. 이를 정확한 핏, 사이즈, 테일러링, 원단 특성 또는 구매자에게 의상이 어떻게 보일지에 대한 증거로 설명하지 마세요. 신체 유형, 나이, 민족, 의학적 또는 매력에 대한 주장을 하지 마세요.
레시피, 하나의 기본 동작, 하나의 카메라 움직임, 지속 시간, 출력 비율, 대상 의상 세부 정보, 오디오 필요 여부를 확인하세요. 생성된 오디오는 기본적으로 꺼져 있습니다. 레시피 기본값, 참조 역할, 타이밍 및 패션 진실 제약 조건은 references/prompting.md를 참조하세요.
지출 전 미리보기
완전한 수정된 페이로드를 오프라인에서 미리보기:
node scripts/hiapi-fashion-lookbook-video.mjs `
--recipe lookbook-pose `
--prompt "An adult model presents one structured black evening look" `
--duration 5 `
--ratio 9:16 `
--preview
승인된 인물 및 대상 의상의 경우:
node scripts/hiapi-fashion-lookbook-video.mjs `
--recipe outfit-transition `
--person-image-file "D:\media\person.jpg" `
--garment-image-file "D:\media\dress-front.jpg" `
--garment-image-file "D:\media\dress-back.jpg" `
--person-consent-confirmed `
--asset-rights-confirmed `
--prompt "One clean change into the supplied evening dress" `
--garment-details "Preserve the square neckline, fitted waist, ankle hem, and silver buttons" `
--duration 5 `
--ratio 9:16 `
--preview
라이브 체크는 사용자에게 HiAPI에 연락하지만 유료 작업은 생성하지 않는다고 알린 후에만 실행하세요:
node scripts/hiapi-fashion-lookbook-video.mjs --check --env-file "D:\path\to\.env.local"
그런 다음 --dry-run으로 정확한 요청의 가격을 확인하세요. 공개 라이브 카탈로그를 읽고 작업을 생성하지 않습니다. 기본 로컬 예상 한도는 $1.00입니다. --max-cost-usd는 승인된 예산 내에서만 재정의하세요. 공개 가격은 서버 측 최종 청구 상한이 아닙니다. 계정 그룹 비율이 적용될 수 있기 때문입니다.
--spend --approved-request-hash HASH는 사용자가 일치하는 라이브 견적, 예산 및 요청 해시를 명시적으로 승인한 후에만 사용하세요. 한 번 호출하면 최대 하나의 유료 작업이 생성됩니다. API 키는 HIAPI_API_KEY 또는 --env-file에서 읽으며, 절대 출력하거나 저장하지 마세요.
안전하게 재개
CLI는 멱등성 키를 승인된 요청 해시에 바인딩하고 생성 직후 작업 ID를 출력합니다. 정확히 출력된 --idempotency-key는 작업 ID가 반환되기 전에 제출이 중단된 경우에만 재사용하세요. 작업 ID가 존재하면 재제출 없이 재개합니다:
node scripts/hiapi-fashion-lookbook-video.mjs --task-id TASK_ID --env-file "D:\path\to\.env.local"
폴링, 다운로드 또는 품질 검토 실패 후 자동으로 대체 작업을 생성하지 마세요.
패키지 검토
final.mp4, brief.md, 수정된 prompt.json, manifest.json 및 qc.json을 보존하세요. generated_unreviewed를 최종 자동화된 상태로 처리하세요. 게시, 이커머스 사용, 유료 광고 또는 의상, 아이덴티티, 핏, 사이즈, 소재, 원산지, 인증 또는 성능에 대한 주장을 하기 전에 사람의 검토가 필요합니다.
아티팩트 의미 및 패션 QC 체크리스트는 references/output.md를 참조하세요. 모델, 경로, 가격 책정, 재시도 또는 작업 처리를 변경하기 전에 references/api.md를 참조하세요.