HiAPI 식품 상업 영상은(는) 무엇을 하나요?
하나의 짧고 식욕을 돋우는 상업 샷을 생성합니다. 제품은 진실되게, 물리 법칙은 그럴듯하게 유지하고, 유료 작업의 경계를 명확히 합니다.
요청 라우팅
하나의 레시피와 하나의 미디어 경로를 선택하세요:
| 레시피 | 최적 용도 |
|---|---|
product-hero | 포장 식품, 캔, 병, 항아리, 이커머스 히어로 샷 |
coffee-pour | 커피, 차, 우유, 크레마, 스팀, 카페 음료 |
beverage-splash | 탄산음료, 주스, 스파클링 워터, 에너지 드링크 샷 |
food-macro | 식감, 익힘 정도, 드리즐, 치즈 스트링, 플레이팅 디테일 |
restaurant-atmosphere | 다이닝룸이나 카운터 서비스 환경에 나오는 요리 |
| 미디어 입력 | 경로 | 모델 |
|---|---|---|
| 이미지 없음 | 텍스트-투-비디오 | kling-3.0-omni/text-to-video |
정확히 하나의 --hero-image-* | 히어로 이미지-투-비디오 | kling-3.0-omni/image-to-video |
1-9개의 --reference-image-* | 멀티 참조 생성 | seedance-2.0-fast |
히어로 이미지와 참조 이미지를 혼합하지 마세요. 패키지 형상, 라벨 위치, 브랜드 색상 또는 특정 요리가 식별 가능해야 하는 경우 히어로 또는 참조 이미지를 선호하세요.
사람이 말하거나, 시식하거나, 발표하는 장면, 또는 기존 비디오의 동작 및 카메라 가이드는 처리하지 않습니다. 해당 요청은 전담 설치형 스포크퍼슨 또는 참조 동작 스킬로 라우팅하세요. 사용 가능한 스킬이 없으면 이 스킬이 해당 워크플로우를 지원하지 않음을 설명하세요.
브리프 작성
제품 또는 요리, 하나의 기본 동작, 하나의 카메라 움직임, 출력 비율, 지속 시간 및 피해야 할 클레임을 확인하세요. 사용자가 지속 시간을 생략한 경우, 먼저 요청을 라우팅하고, 간단한 맞춤형 메뉴를 제공한 후, --dry-run 전에 선택 또는 저비용 기본값인 4초에 대한 명시적 수락을 기다리세요.
선택한 모델 범위 내의 모든 정수 초를 허용합니다. Kling 텍스트-투-비디오 및 히어로 이미지-투-비디오는 3-15초를 지원하고, Seedance Fast 참조 이미지 생성은 4-15초를 지원합니다. 다음 계획 대역을 경직된 사전 설정으로 전환하지 않고 사용하세요:
| 지속 시간 | 최적 용도 |
|---|---|
| 3-4초 | 즉각적인 후크, 튀김 또는 패키지 공개, 3초는 Kling 전용 |
| 5-6초 | 빠른 소셜 미디어 또는 이커머스 히어로 샷, 짧은 제품 유지 |
| 7-9초 | 완전한 따르기, 드리즐, 텍스처 또는 안정화 시간이 있는 공개 |
| 10-12초 | 프리미엄 슬로우 공개 또는 절제된 템포의 레스토랑 분위기 |
| 13-15초 | 동작이 의미 있을 때만 신중한 롱 테이크, 가장 높은 비용 및 연속성 위험 |
긴 지속 시간이 추가 컷이나 관련 없는 비트를 허용하지 않습니다: 하나의 동작, 하나의 카메라 움직임, 하나의 연속 샷을 유지하세요. 레시피는 간결한 기본값을 제공합니다. 브리프에 필요한 경우 --action, --setting, --lighting, --texture, --camera 또는 --sound로 재정의하세요.
레시피 기본값 및 식품 특정 진실성 제약 조건은 references/prompting.md를 참조하세요.
지출 및 비밀 보호
먼저 오프라인에서 완전한 수정된 페이로드를 미리보기:
node scripts/hiapi-food-commercial-video.mjs `
--recipe coffee-pour `
--prompt "프리미엄 카페용 다크 로스트 커피가 담긴 세라믹 컵" `
--duration 4 `
--ratio 9:16 `
--preview
사용자에게 HiAPI에 연락하지만 유료 작업을 생성하지 않는다고 알린 후에만 실제 점검을 실행하세요:
node scripts/hiapi-food-commercial-video.mjs --check --env-file "D:\path\to\.env.local"
그런 다음 공개 라이브 카탈로그에서 의도한 요청의 가격을 책정하세요:
node scripts/hiapi-food-commercial-video.mjs `
--recipe product-hero `
--hero-image-file "D:\media\product.jpg" `
--prompt "깨끗하고 차가운 카운터 위에 있는 제공된 스파클링 워터 캔" `
--duration 4 `
--dry-run
해당 --dry-run이 출력한 라이브 견적, 예산 및 해시를 사용자가 명시적으로 승인한 후에만 --spend --approved-request-hash HASH를 사용하세요. 기본 클라이언트 예상 한도는 $0.50입니다. 승인된 예산 내에서만 --max-cost-usd를 재정의하세요. 이는 서버에서 강제하는 최종 청구 상한선이 아니며 계정 그룹 비율이 적용될 수 있습니다. 호출당 최대 하나의 유료 작업을 생성하세요.
HIAPI_API_KEY를 프로세스 환경 또는 --env-file에서 읽어옵니다. 절대 인쇄, 저장 또는 아티팩트에 포함시키지 마세요. 고정 API 호스트 및 임시 출력 스토리지를 유지하세요.
안전하게 재개
CLI는 멱등성 키를 승인된 요청 해시에 바인딩하고, 제출 전에 이를 출력하며, 생성 직후 작업 ID를 출력합니다. 작업 ID가 반환되기 전에 제출이 중단된 경우 해당 정확한 --idempotency-key를 재사용하세요. 중복 키 응답에 이미 작업 ID가 포함된 경우 현재 브리프를 첨부하지 말고, 기존 작업을 별도로 재개하세요. 작업 ID가 존재한 후에는 다음으로만 재개하세요:
node scripts/hiapi-food-commercial-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를 참조하세요.