HiAPI 时尚造型视频生成 是做什么的？
创建一段短款时尚镜头。确保人物已获得授权，服装可识别，角色引用明确，且付费生成已单独审批。
路由请求
选择一种配方：
| 配方 | 最佳用途 |
|---|---|
runway-walk | 走秀步态，以定格在一个受控姿势结束 |
outfit-transition | 恰好一个初始到目标服装的变换 |
lookbook-pose | 慢速转身或展示一整套造型的姿势 |
person-showcase | 非说话人物时尚肖像，动作克制 |
根据提供的素材选择媒体路由：
| 媒体输入 | 路由 | 模型 |
|---|---|---|
| 无图像 | 文本转视频 | kling-3.0-omni/text-to-video |
| 恰好一个人物图像或一套完整look的图像，无其他图像 | 图像转视频 | 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。