muapi-storyboard-to-cooking-video

从分镜到烹饪视频

将一张人物照片制作成精致的 15 秒电影感烹饪教程。该技能会先生成一张高品质制作参考表——包括人物形象、厨房环境和 9 格动作分镜——然后根据参考图生成连续视频，确保每一帧中的人物面容、服装和厨房环境保持一致。

输入

名称	类型	必填	默认值	描述
person_image	image_url	是	—	人物照片的 URL。在参考表和最终视频中，都会用作身份参考。
dish	text	否	fresh pasta	烹饪主题（例如 “fresh pasta”、“sushi rolls”、“wood-fired pizza”、“matcha latte”）。用于构建 9 步动作分镜。
kitchen_style	text	否	warm rustic-modern Italian	厨房风格（例如 “warm rustic-modern Italian”、“minimalist Tokyo”、“bright Scandinavian”、“moody industrial”）。
outfit	text	否	white t-shirt, olive green apron, dark trousers	人物在整个视频中穿着的服装。
duration_seconds	int	否	15	最终视频时长。完整呈现 9 步流程时使用 15；使用 10 时会压缩为约 6 个节拍。
aspect_ratio	text	否	16:9	输出画面比例。竖屏/Reels 请使用 9:16。
resolution	text	否	720p	视频分辨率。可选：480p、720p。

步骤

按顺序提交包含两个步骤的计划。步骤 2 依赖步骤 1 的输出。

步骤 1 — 参考表（组合分镜）

生成组合式“制作参考图”。这是一张图片，不是视频帧——其中包含人物设定表、场景参考和 9 格动作分镜。

端点： gpt-image-v2-edit CLI：

muapi image edit \
  --model gpt-image-v2-edit \
  --image "{{person_image}}" \
  --image-size "3840x2160" \
  --quality auto \
  --background auto \
  --moderation low \
  --output-format png \
  --prompt "Create one single composite reference sheet for a {{duration_seconds}}-second realistic {{dish}}-making tutorial video. The image should be a clean, high-end production reference board, not a poster with heavy text. Format: {{aspect_ratio}} wide reference sheet, elegant white margins, clean grid layout, realistic cinematic photography style. Concept: {{dish}} tutorial in a {{kitchen_style}} kitchen.

Top row: motion / choreography guide with 9 numbered cinematic action panels showing the {{dish}} process step-by-step from raw ingredients to final plated dish.

Middle-left: realistic character reference sheet of the uploaded person — preserve their exact face, hair color, hair texture, eye color, skin tone, and all facial features with 100% accuracy. Show the same person in: face close-up, full-body front view, side/action working pose, and back view. Dress them in {{outfit}}. Keep them grounded, approachable, skilled, and cinematic.

Middle-right / background: location reference sheet of an elegant {{kitchen_style}} kitchen with tactile surfaces, natural daylight from a large window, hanging cookware, herbs, and premium cooking atmosphere appropriate to the cuisine.

Style: realistic, cinematic, warm natural light, shallow depth of field, tactile food photography, premium cooking show aesthetic, rich surface textures.

Bottom strip: simple visual icons only for {{duration_seconds}} seconds, {{aspect_ratio}}, realistic, cinematic, tasty, natural camera. Minimal text, no dense paragraphs. Let the visuals do the heavy lifting."

等待生成完成，并将输出 URL 记录为 {{reference_sheet_url}}。向用户展示该图，并在进入步骤 2 前确认人物相似度和厨房氛围——步骤 2 是成本较高的调用。

步骤 2 — 烹饪视频（参考图转视频）

使用原始人物照片（身份锚点）和参考表（叙事及环境指南）作为双重参考，为整个序列生成动画。

端点： bytedance-seedance-2-0-reference-to-video-fast CLI：

muapi video generate \
  --model bytedance-seedance-2-0-reference-to-video-fast \
  --image "{{person_image}}" \
  --image "{{reference_sheet_url}}" \
  --aspect-ratio "{{aspect_ratio}}" \
  --duration "{{duration_seconds}}" \
  --resolution "{{resolution}}" \
  --generate-audio true \
  --prompt "The person in @Image1 is the subject — preserve their exact face, hair, eye color, skin tone, and all facial features with 100% accuracy throughout the entire video.
Use @Image2 as the visual and narrative guide — follow the cooking steps, kitchen setting, outfit, and atmosphere shown in the reference sheet exactly.
A single continuous cinematic video of the person from @Image1 making {{dish}} in the {{kitchen_style}} kitchen shown in @Image2. They wear {{outfit}} throughout.

VIDEO STRUCTURE
Follow the exact 9-step sequence as shown in @Image2, beat by beat, from raw ingredients through preparation to a final plated close-up.

MOTION STYLE
- Slow, deliberate, satisfying transitions between each step
- Natural hand and body movement with clear culinary intent
- Continuous flow with no jump cuts
- Warm and immersive pacing

CAMERA & CINEMATOGRAPHY
- Close-up shots for hands during mixing, kneading, cutting, plating
- Medium shots showing the person working at the counter
- Pull back slightly for the final plating to reveal the full kitchen
- Shallow depth of field — focus on hands and food, soft background blur
- No abrupt cuts — smooth match cuts and fluid transitions

VISUAL STYLE
- Warm natural daylight from a large kitchen window
- Rich tactile textures matching @Image2's environment
- Full color, warm cinematic color grading

CONSISTENCY RULES
- Same character throughout — face of @Image1 in every frame
- Same outfit across entire video
- Same kitchen environment as shown in @Image2

AUDIO
- Soft kitchen ambience, gentle culinary SFX (chopping, sizzling, pouring), light cinematic underscore
- No dialogue, no narration

OUTPUT STYLE
- Duration: exactly {{duration_seconds}} seconds
- Polished, cinematic, premium cooking show quality
- Ends with a beautiful close-up of the finished plated {{dish}}"

生成完成后：

• 向用户提供最终视频 URL。
• 提供后续选项：重新生成竖屏 9:16 版本用于 Reels、制作更长的 30 秒扩展版，或使用同一张人物照片将 {{dish}} 换成其他菜系。

注意事项

• 双图参考是关键。 @Image1 锁定人物身份，@Image2 锁定动作编排和环境。不要省略任何一张——仅使用单张参考图会导致人物面容或厨房环境无法保持一致。
• 步骤 1 的参考表必须为横向（3840x2160）。较低分辨率会使 9 格动作分镜变模糊，视频模型将无法识别。
• bytedance-seedance-2-0-reference-to-video-fast 在 generate_audio=true 时会原生生成音频。提示词中务必包含音频方向，否则配乐将是随机的。
• 此处支持真实人脸，因为人物照片是用户本人的主体，而且我们通过参考图转视频端点（而非受限的 i2v 变体）进行处理。
• 如果用户想制作非烹饪序列（例如拉花、摆盘教程或调酒），请保持相同的两步结构——只需更改 {{dish}} 和 9 步描述。
• 对于较短的视频（<= 8s），请在步骤 1 中将动作分镜减少到 5–6 格；在 8 秒内塞入 9 个节拍会降低动作质量（单节拍规则）。

触发关键词

cooking video、cooking tutorial、pasta video、recipe video、food video、chef video、cooking storyboard、kitchen tutorial、cooking reel、tutorial video from photo、storyboard to video

---

执行 Agent 须知

• 此流程由大模型编排：阅读各阶段，向用户收集任何缺失的输入，然后调用 muapi CLI 命令。如果未设置 MUAPI_API_KEY，请先运行 muapi auth configure。
• 对于尚无 CLI 别名的模型 ID，请改用原始端点，通过 curl -X POST https://api.muapi.ai/api/v1/<endpoint> -H "x-api-key: $MUAPI_API_KEY" -H 'content-type: application/json' -d '{...}' 发起请求，并使用 muapi predict wait <request_id> 轮询。
• 每次调用前，将 {{input_name}} 占位符替换为用户的实际输入。
• 步骤 1 必须先完成并返回输出图像 URL，然后才能启动步骤 2——将该 URL 作为视频步骤的第二个 --image 传入。