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 "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。