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 |
最多使用一張人物圖片、六張目標造型的服裝圖片與兩張風格圖片。總上限為九張。參考驅動的 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 "一位成人模特兒展示一套結構化的黑色晚禮服造型" `
--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 "乾淨切換至所提供的晚禮服" `
--garment-details "保留方領、合身腰線、腳踝裙長與銀色鈕扣" `
--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。一次調用最多建立一個付費任務。從 HIAPI_API_KEY 或 --env-file 讀取 API 金鑰；切勿列印或持久化儲存。
安全地復原
CLI 將其冪等金鑰綁定至已核准的請求雜湊，並在建立任務後立即列印任務 ID。僅當在任務 ID 返回前提交被中斷時，才重複使用確切列印的 --idempotency-key。任務 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 視為最終自動化狀態。在發布、電子商務使用、付費廣告或做出關於服裝、身份、合身度、尺寸、材質、產地、認證或性能的聲明前，需要人工審查。
關於成品語意及時尚品管檢查清單，請參閱 references/output.md。在變更模型、路徑、定價、重試或任務處理方式前，請參閱 references/api.md。