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 |
禁止混合主視覺圖片與參考圖片。當包裝形狀、標籤位置、品牌顏色或特定菜餚必須保持可辨識時，應優先使用主視覺或參考圖片。
不處理任何人類說話、品嚐、展示，或來自現有影片的動作與攝影機指引。請將此類請求路由到專用的代言人或參考動作技能；如果沒有安裝此類技能，請解釋本技能不支援此工作流程。
建立簡報
確認產品或菜餚、一項主要動作、一種攝影機運動、輸出比例、持續時間，以及任何必須避免的主張。如果使用者未提供持續時間，請先路由請求，提供簡短的自訂選單，並等待使用者選擇或明確接受 4 秒低成本的預設值，然後再執行 --dry-run。
接受所選模型範圍內的每個整數秒數：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 "A ceramic cup of dark-roast coffee for a premium cafe" `
--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 "The supplied sparkling-water can on a clean chilled counter" `
--duration 4 `
--dry-run
僅在使用者明確核准由對應 --dry-run 列印的即時估價、預算及雜湊值後，才使用 --spend --approved-request-hash HASH。預設客戶端估價上限為 $0.50；僅在已核准的預算內覆蓋 --max-cost-usd。這並非伺服器強制的最終收費上限，因為帳戶群組比例可能適用。每次調用最多建立一個付費任務。
從處理程序環境或 --env-file 讀取 HIAPI_API_KEY。切勿列印、持久儲存或將其包含在成品中。保持固定的 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 視為最終自動化狀態。在發布或做出產品、成分、過敏原、酒精、營養、認證或健康聲明之前，要求人工審查。
請參閱 references/output.md 以了解成品語意及 QC 檢查清單。在更改路由、定價邏輯、重試或任務處理時，請參閱 references/api.md。