@aswless_854771076/ai_short_studio_cli 0.1.98 → 0.1.100

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (405) hide show
  1. package/README.md +15 -313
  2. package/dist/base-command.d.ts +0 -6
  3. package/dist/base-command.js +1 -39
  4. package/dist/client/api-client.js +2 -19
  5. package/dist/commands/auth/login.d.ts +1 -2
  6. package/dist/commands/auth/login.js +2 -5
  7. package/dist/commands/auth/logout.d.ts +0 -1
  8. package/dist/commands/auth/signup.d.ts +0 -1
  9. package/dist/commands/auth/status.d.ts +0 -1
  10. package/dist/commands/canvas/apply.d.ts +0 -1
  11. package/dist/commands/canvas/asset/get.d.ts +0 -1
  12. package/dist/commands/canvas/asset/list.d.ts +0 -1
  13. package/dist/commands/canvas/asset/select.d.ts +1 -3
  14. package/dist/commands/canvas/asset/select.js +3 -22
  15. package/dist/commands/canvas/asset/upload.d.ts +0 -14
  16. package/dist/commands/canvas/asset/upload.js +3 -43
  17. package/dist/commands/canvas/continuity/analyze.d.ts +0 -1
  18. package/dist/commands/canvas/edge/connect.d.ts +0 -1
  19. package/dist/commands/canvas/edge/disconnect.d.ts +0 -1
  20. package/dist/commands/canvas/edge/list.d.ts +0 -1
  21. package/dist/commands/canvas/edge/list.js +1 -4
  22. package/dist/commands/canvas/episode/create.d.ts +0 -1
  23. package/dist/commands/canvas/episode/list.d.ts +0 -1
  24. package/dist/commands/canvas/folder/copy-cross-project.d.ts +0 -1
  25. package/dist/commands/canvas/folder/create.d.ts +0 -1
  26. package/dist/commands/canvas/folder/delete.d.ts +0 -1
  27. package/dist/commands/canvas/folder/list.d.ts +0 -1
  28. package/dist/commands/canvas/folder/move.d.ts +0 -1
  29. package/dist/commands/canvas/folder/rename.d.ts +0 -1
  30. package/dist/commands/canvas/folder/restore.d.ts +0 -1
  31. package/dist/commands/canvas/get.d.ts +0 -1
  32. package/dist/commands/canvas/inspect.d.ts +0 -1
  33. package/dist/commands/canvas/node/add.d.ts +1 -1
  34. package/dist/commands/canvas/node/add.js +2 -2
  35. package/dist/commands/canvas/node/delete.d.ts +0 -1
  36. package/dist/commands/canvas/node/edit-resource.d.ts +0 -2
  37. package/dist/commands/canvas/node/edit-resource.js +1 -9
  38. package/dist/commands/canvas/node/edit-shot.d.ts +0 -1
  39. package/dist/commands/canvas/node/get.d.ts +0 -1
  40. package/dist/commands/canvas/node/list.d.ts +0 -5
  41. package/dist/commands/canvas/node/list.js +2 -43
  42. package/dist/commands/canvas/node/run.d.ts +0 -15
  43. package/dist/commands/canvas/node/run.js +6 -142
  44. package/dist/commands/canvas/node/types.d.ts +0 -1
  45. package/dist/commands/canvas/node/update-many.d.ts +0 -1
  46. package/dist/commands/canvas/node/update.d.ts +0 -1
  47. package/dist/commands/canvas/settings/get.d.ts +0 -1
  48. package/dist/commands/canvas/settings/set.d.ts +0 -24
  49. package/dist/commands/canvas/settings/set.js +1 -60
  50. package/dist/commands/config/get.d.ts +0 -1
  51. package/dist/commands/config/set.d.ts +0 -2
  52. package/dist/commands/config/set.js +2 -55
  53. package/dist/commands/preflight.d.ts +0 -1
  54. package/dist/commands/preflight.js +1 -9
  55. package/dist/commands/project/create.d.ts +0 -1
  56. package/dist/commands/project/delete.d.ts +0 -1
  57. package/dist/commands/project/get.d.ts +0 -1
  58. package/dist/commands/project/list.d.ts +0 -1
  59. package/dist/commands/project/update.d.ts +0 -1
  60. package/dist/commands/skill/install.d.ts +0 -1
  61. package/dist/commands/skill/install.js +0 -1
  62. package/dist/commands/skill/path.d.ts +0 -1
  63. package/dist/commands/skill/path.js +0 -1
  64. package/dist/commands/skill/status.d.ts +0 -1
  65. package/dist/commands/skill/status.js +0 -1
  66. package/dist/commands/task/cancel.d.ts +0 -1
  67. package/dist/commands/task/get.d.ts +0 -1
  68. package/dist/commands/task/wait.d.ts +0 -2
  69. package/dist/commands/task/wait.js +1 -6
  70. package/dist/domain/vvicat-api.d.ts +3 -63
  71. package/dist/domain/vvicat-api.js +9 -74
  72. package/dist/output/formatter.d.ts +0 -11
  73. package/dist/output/formatter.js +0 -20
  74. package/dist/preflight.d.ts +0 -1
  75. package/dist/preflight.js +1 -14
  76. package/dist/skill/command-flags.js +4 -7
  77. package/dist/skill/skill-manager.d.ts +2 -75
  78. package/dist/skill/skill-manager.js +15 -60
  79. package/package.json +3 -4
  80. package/scripts/postinstall.mjs +12 -7
  81. package/skills/using-vvicat-ai-short-studio-cli/SKILL.md +67 -27
  82. package/skills/using-vvicat-ai-short-studio-cli/references/commands/canvas.md +4 -3
  83. package/skills/using-vvicat-ai-short-studio-cli/references/commands/project.md +2 -26
  84. package/skills/using-vvicat-ai-short-studio-cli/references/commands.md +2 -2
  85. package/skills/using-vvicat-ai-short-studio-cli/references/editing-delivery.md +1 -1
  86. package/skills/using-vvicat-ai-short-studio-cli/references/h3-video-delivery.md +1 -1
  87. package/skills/using-vvicat-ai-short-studio-cli/references/humanizer/humanizer.md +9 -0
  88. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/SKILL.md +447 -0
  89. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/brief.md +93 -0
  90. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/project-files.md +246 -0
  91. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/reference-video.md +266 -0
  92. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/script-and-time.md +253 -0
  93. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/transformations.md +141 -0
  94. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/environment/distribution.md +176 -0
  95. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/environment/local-tools.md +411 -0
  96. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/environment/model-and-provider.md +275 -0
  97. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/environment/profile.md +286 -0
  98. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/asset-and-shot-preproduction.md +193 -0
  99. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/b-roll.md +94 -0
  100. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/caption-tracking.md +125 -0
  101. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/captions.md +252 -0
  102. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/examples/conversation-images.md +218 -0
  103. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/examples/h3-base-prompt-writing.md +222 -0
  104. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/examples/h3-reference-prompt-writing.md +341 -0
  105. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/examples/image-direction.md +123 -0
  106. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/generated-dependencies.md +38 -0
  107. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/graphic-compositions.md +85 -0
  108. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/h3-prompt-writing.md +54 -0
  109. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/image-direction.md +95 -0
  110. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/motion-graphics.md +68 -0
  111. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/recreation-policy.md +51 -0
  112. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/screen-demonstrations.md +51 -0
  113. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/shot-production-contracts.md +161 -0
  114. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/sound-mix.md +76 -0
  115. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/video-direction.md +433 -0
  116. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/voice-and-performance.md +224 -0
  117. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/voice-direction.md +99 -0
  118. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/narration-led-demo.md +87 -0
  119. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/presenter-led-explainer.md +160 -0
  120. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/ranking-listicle.md +71 -0
  121. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/reference-recreation-canvas.md +8 -0
  122. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/short-drama-workflow.md +165 -0
  123. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/short-drama.md +88 -0
  124. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/street-interview.md +92 -0
  125. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/talking-head.md +82 -0
  126. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/two-person-podcast.md +101 -0
  127. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/index.md +77 -0
  128. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/audio-presentation.md +49 -0
  129. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/authoring.md +228 -0
  130. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/browser-capture.md +112 -0
  131. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/builds.md +330 -0
  132. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/caption-authoring.md +156 -0
  133. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/caption-presentation.md +66 -0
  134. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/component-design.md +217 -0
  135. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/component-sharing.md +150 -0
  136. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/component-visuals.md +152 -0
  137. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/detail.svrun +8 -0
  138. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/direction.svs +14 -0
  139. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/look.svs +6 -0
  140. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/material.svrun +5 -0
  141. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/production.svml +73 -0
  142. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/production.svrun +5 -0
  143. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/visuals.ts +62 -0
  144. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/fonts-and-text.md +138 -0
  145. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/image-operations.md +102 -0
  146. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/index.md +73 -0
  147. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/media-presentation.md +111 -0
  148. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/media.md +246 -0
  149. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/performance.md +114 -0
  150. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/prompt-kits.md +165 -0
  151. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/rendering.md +141 -0
  152. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/review.md +211 -0
  153. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/runs.md +151 -0
  154. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/script-syntax.md +236 -0
  155. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/snapshots.md +90 -0
  156. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/sound.md +75 -0
  157. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/source-syntax.md +163 -0
  158. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/spatial.md +189 -0
  159. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/studio-companions.md +186 -0
  160. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/studio.md +249 -0
  161. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/system.md +169 -0
  162. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/timeline.md +74 -0
  163. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/timing.md +96 -0
  164. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/track-authoring.md +215 -0
  165. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/tracks.md +67 -0
  166. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/video-downloads.md +47 -0
  167. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/vocabulary.md +119 -0
  168. package/skills/using-vvicat-ai-short-studio-cli/references/project-and-canvas.md +1 -1
  169. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/README.md +11 -0
  170. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/SKILL.md +102 -0
  171. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/art-styles.json +585 -0
  172. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-character-images.md +11 -0
  173. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-character-profiles/character-profile-output.schema.json +99 -0
  174. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-character-profiles.md +7 -0
  175. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-drama-art-style.md +9 -0
  176. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-prop-assets.md +11 -0
  177. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-scene-assets.md +13 -0
  178. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/manage-drama-art-styles.md +9 -0
  179. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/manage-drama-assets.md +9 -0
  180. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/analyze-drama-source/prompts/source_analysis.en.txt +24 -0
  181. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/analyze-drama-source/prompts/source_analysis.zh.txt +24 -0
  182. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/build-drama-storyboard/prompts/agent_acting_direction.en.txt +61 -0
  183. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/build-drama-storyboard/prompts/agent_acting_direction.zh.txt +79 -0
  184. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/build-drama-storyboard/prompts/agent_cinematographer.en.txt +101 -0
  185. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/build-drama-storyboard/prompts/agent_cinematographer.zh.txt +150 -0
  186. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/build-drama-storyboard/prompts/agent_storyboard_detail.en.txt +114 -0
  187. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/build-drama-storyboard/prompts/agent_storyboard_detail.zh.txt +89 -0
  188. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/build-drama-storyboard/prompts/agent_storyboard_plan.en.txt +114 -0
  189. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/build-drama-storyboard/prompts/agent_storyboard_plan.zh.txt +389 -0
  190. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/build-drama-storyboard/prompts/professional_storyboard.en.txt +40 -0
  191. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/build-drama-storyboard/prompts/professional_storyboard.zh.txt +40 -0
  192. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/define-drama-brief/prompts/drama_brief.en.txt +24 -0
  193. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/define-drama-brief/prompts/drama_brief.zh.txt +24 -0
  194. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/design-drama-audio/prompts/character_voice_description.en.txt +19 -0
  195. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/design-drama-audio/prompts/character_voice_description.zh.txt +19 -0
  196. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/design-drama-audio/prompts/character_voice_recommend.en.txt +26 -0
  197. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/design-drama-audio/prompts/character_voice_recommend.zh.txt +26 -0
  198. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/design-drama-audio/prompts/music_track_design.en.txt +33 -0
  199. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/design-drama-audio/prompts/music_track_design.zh.txt +33 -0
  200. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/design-drama-audio/prompts/voice_analysis.en.txt +36 -0
  201. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/design-drama-audio/prompts/voice_analysis.zh.txt +36 -0
  202. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/design-drama-bible/prompts/ai_story_expand.en.txt +33 -0
  203. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/design-drama-bible/prompts/ai_story_expand.zh.txt +33 -0
  204. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-character-images/prompts/agent_character_visual.en.txt +26 -0
  205. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-character-images/prompts/agent_character_visual.zh.txt +26 -0
  206. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-character-images/prompts/character_asset_sheet.en.txt +21 -0
  207. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-character-images/prompts/character_asset_sheet.zh.txt +21 -0
  208. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-character-images/prompts/character_create.en.txt +12 -0
  209. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-character-images/prompts/character_create.zh.txt +12 -0
  210. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-character-images/prompts/character_description_update.en.txt +13 -0
  211. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-character-images/prompts/character_description_update.zh.txt +13 -0
  212. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-character-images/prompts/character_image_to_description.en.txt +11 -0
  213. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-character-images/prompts/character_image_to_description.zh.txt +11 -0
  214. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-character-images/prompts/character_modify.en.txt +15 -0
  215. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-character-images/prompts/character_modify.zh.txt +15 -0
  216. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-character-images/prompts/character_regenerate.en.txt +14 -0
  217. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-character-images/prompts/character_regenerate.zh.txt +14 -0
  218. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-character-profiles/prompts/agent_character_profile.en.txt +50 -0
  219. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-character-profiles/prompts/agent_character_profile.zh.txt +50 -0
  220. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-drama-art-style/prompts/art_style_decision.en.txt +18 -0
  221. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-drama-art-style/prompts/art_style_decision.zh.txt +18 -0
  222. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-drama-art-style/prompts/config_generation.en.txt +67 -0
  223. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-drama-art-style/prompts/config_generation.zh.txt +67 -0
  224. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-prop-assets/prompts/prop_description_update.en.txt +14 -0
  225. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-prop-assets/prompts/prop_description_update.zh.txt +14 -0
  226. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-prop-assets/prompts/prop_generate.en.txt +16 -0
  227. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-prop-assets/prompts/prop_generate.zh.txt +16 -0
  228. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-prop-assets/prompts/select_prop.en.txt +17 -0
  229. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-prop-assets/prompts/select_prop.zh.txt +17 -0
  230. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-scene-assets/prompts/location_create.en.txt +11 -0
  231. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-scene-assets/prompts/location_create.zh.txt +11 -0
  232. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-scene-assets/prompts/location_description_update.en.txt +14 -0
  233. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-scene-assets/prompts/location_description_update.zh.txt +14 -0
  234. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-scene-assets/prompts/location_modify.en.txt +13 -0
  235. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-scene-assets/prompts/location_modify.zh.txt +13 -0
  236. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-scene-assets/prompts/location_regenerate.en.txt +12 -0
  237. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-scene-assets/prompts/location_regenerate.zh.txt +12 -0
  238. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-scene-assets/prompts/scene_asset_sheet.en.txt +19 -0
  239. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-scene-assets/prompts/scene_asset_sheet.zh.txt +19 -0
  240. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-scene-assets/prompts/select_location.en.txt +18 -0
  241. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-scene-assets/prompts/select_location.zh.txt +17 -0
  242. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-storyboard-images/prompts/panel_grid_enhance.en.txt +29 -0
  243. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-storyboard-images/prompts/panel_grid_enhance.zh.txt +29 -0
  244. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-storyboard-images/prompts/panel_grid_image.en.txt +77 -0
  245. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-storyboard-images/prompts/panel_grid_image.zh.txt +77 -0
  246. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-storyboard-images/prompts/panel_storyboard_image.en.txt +109 -0
  247. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/generate-storyboard-images/prompts/panel_storyboard_image.zh.txt +109 -0
  248. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/ideate-drama-from-market/prompts/market_inspiration.en.txt +23 -0
  249. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/ideate-drama-from-market/prompts/market_inspiration.zh.txt +23 -0
  250. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/outline-drama-series/prompts/episode_split.en.txt +42 -0
  251. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/outline-drama-series/prompts/episode_split.zh.txt +42 -0
  252. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/plan-drama-assets/prompts/asset_analysis.en.txt +55 -0
  253. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/plan-drama-assets/prompts/asset_analysis.zh.txt +55 -0
  254. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/plan-drama-production/prompts/production_plan.en.txt +49 -0
  255. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/plan-drama-production/prompts/production_plan.zh.txt +52 -0
  256. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/plan-shot-continuity/prompts/continuity_plan.en.txt +37 -0
  257. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/plan-shot-continuity/prompts/continuity_plan.zh.txt +37 -0
  258. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/review-drama-script/prompts/review_drama_script.en.txt +28 -0
  259. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/review-drama-script/prompts/review_drama_script.zh.txt +28 -0
  260. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/revise-drama-storyboards/prompts/agent_shot_variant_analysis.en.txt +57 -0
  261. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/revise-drama-storyboards/prompts/agent_shot_variant_analysis.zh.txt +169 -0
  262. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/revise-drama-storyboards/prompts/agent_shot_variant_generate.en.txt +64 -0
  263. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/revise-drama-storyboards/prompts/agent_shot_variant_generate.zh.txt +117 -0
  264. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/revise-drama-storyboards/prompts/agent_storyboard_insert.en.txt +34 -0
  265. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/revise-drama-storyboards/prompts/agent_storyboard_insert.zh.txt +34 -0
  266. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/revise-drama-storyboards/prompts/storyboard_edit.en.txt +18 -0
  267. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/revise-drama-storyboards/prompts/storyboard_edit.zh.txt +13 -0
  268. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/transform-drama-media/prompts/2d_to_live_action.en.txt +7 -0
  269. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/transform-drama-media/prompts/2d_to_live_action.zh.txt +7 -0
  270. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/transform-drama-media/prompts/image_prompt_modify.en.txt +28 -0
  271. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/transform-drama-media/prompts/image_prompt_modify.zh.txt +42 -0
  272. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/write-drama-director-book/prompts/director_book.en.txt +35 -0
  273. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/write-drama-director-book/prompts/director_book.zh.txt +35 -0
  274. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/write-drama-episode/prompts/agent_clip.en.txt +21 -0
  275. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/write-drama-episode/prompts/agent_clip.zh.txt +21 -0
  276. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/write-drama-episode/prompts/screenplay_conversion.en.txt +39 -0
  277. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/write-drama-episode/prompts/screenplay_conversion.zh.txt +39 -0
  278. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/write-drama-video-prompts/prompts/h3_video.en.txt +49 -0
  279. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/write-drama-video-prompts/prompts/h3_video.zh.txt +48 -0
  280. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/write-drama-video-prompts/prompts/panel_grid_video.en.txt +51 -0
  281. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/write-drama-video-prompts/prompts/panel_grid_video.zh.txt +51 -0
  282. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/write-drama-video-prompts/prompts/panel_storyboard_video.en.txt +50 -0
  283. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/write-drama-video-prompts/prompts/panel_storyboard_video.zh.txt +50 -0
  284. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/write-drama-video-prompts/prompts/seedance2_video.en.txt +48 -0
  285. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/write-drama-video-prompts/prompts/seedance2_video.zh.txt +46 -0
  286. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/plan-drama-assets.md +7 -0
  287. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/codex-contracts.md +14 -0
  288. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/comfly-provider.md +12 -0
  289. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/controlled-vocabulary.json +115 -0
  290. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/analyze-drama-source.md +7 -0
  291. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/define-drama-brief.md +8 -0
  292. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/design-drama-bible.md +5 -0
  293. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/humanizer.md +9 -0
  294. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/outline-drama-series.md +5 -0
  295. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/short-drama.md +13 -0
  296. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/write-drama-director-book.md +6 -0
  297. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/write-drama-episode.md +6 -0
  298. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/director-composition.md +794 -0
  299. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/editing/edit-deliver-drama.md +5 -0
  300. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/editing/edit-drama-timeline.md +22 -0
  301. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/editing/remotion-best-practices.md +12 -0
  302. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/editing-workflow.md +56 -0
  303. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/feature-completeness.md +111 -0
  304. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/configure-generation-providers.md +17 -0
  305. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/design-drama-audio.md +11 -0
  306. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/drama-generation-service.md +13 -0
  307. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/generate-drama-videos.md +9 -0
  308. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/generate-storyboard-images.md +11 -0
  309. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/monitor-drama-tasks.md +15 -0
  310. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/transform-drama-media.md +9 -0
  311. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/write-drama-video-prompts.md +50 -0
  312. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/analyze-drama-market/market-report.schema.json +46 -0
  313. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/analyze-drama-market/methodology.md +24 -0
  314. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/analyze-drama-market.md +47 -0
  315. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/ideate-drama-from-market/market-inspiration.schema.json +109 -0
  316. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/ideate-drama-from-market.md +15 -0
  317. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/module-map.json +595 -0
  318. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/music-catalog-providers.md +16 -0
  319. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/manage-drama-projects.md +11 -0
  320. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/orchestrate-short-drama.md +20 -0
  321. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/recover-drama-pipeline.md +5 -0
  322. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/short-drama-skill-index.md +29 -0
  323. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/use-short-drama-studio.md +15 -0
  324. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/pipeline.md +85 -0
  325. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/project-spec-v1.md +217 -0
  326. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/prompt-skill-index.md +62 -0
  327. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/recreation/publish-drama-references/litterbox.md +5 -0
  328. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/review/review-drama-script.md +7 -0
  329. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/review/review-drama-shots.md +39 -0
  330. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/runninghub-provider.md +33 -0
  331. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/starrouter-provider.md +53 -0
  332. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/build-drama-storyboard.md +13 -0
  333. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/design-fight-video.md +19 -0
  334. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/direct-blender-previz/action-previz.md +39 -0
  335. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/direct-blender-previz/direction-contract.md +96 -0
  336. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/direct-blender-previz/weapons-vfx.md +23 -0
  337. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/direct-blender-previz.md +15 -0
  338. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/generate-blender-previz.md +20 -0
  339. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/plan-drama-production.md +21 -0
  340. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/plan-shot-continuity.md +15 -0
  341. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/revise-drama-storyboards.md +5 -0
  342. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/usage-guide.md +107 -0
  343. package/skills/using-vvicat-ai-short-studio-cli/references/special-workflows.md +2 -8
  344. package/skills/using-vvicat-ai-short-studio-cli/references/troubleshooting.md +0 -1
  345. package/dist/auth/login-provider.d.ts +0 -2
  346. package/dist/auth/login-provider.js +0 -3
  347. package/dist/commands/canvas/node/quote.d.ts +0 -17
  348. package/dist/commands/canvas/node/quote.js +0 -13
  349. package/dist/commands/config/ai-provider/capabilities.d.ts +0 -60
  350. package/dist/commands/config/ai-provider/capabilities.js +0 -124
  351. package/dist/commands/config/ai-provider/get.d.ts +0 -22
  352. package/dist/commands/config/ai-provider/get.js +0 -21
  353. package/dist/commands/config/ai-provider/list.d.ts +0 -21
  354. package/dist/commands/config/ai-provider/list.js +0 -19
  355. package/dist/commands/config/ai-provider/models.d.ts +0 -22
  356. package/dist/commands/config/ai-provider/models.js +0 -21
  357. package/dist/commands/config/ai-provider/set.d.ts +0 -41
  358. package/dist/commands/config/ai-provider/set.js +0 -65
  359. package/dist/commands/config/ai-provider/test.d.ts +0 -25
  360. package/dist/commands/config/ai-provider/test.js +0 -24
  361. package/dist/commands/project/provider/get.d.ts +0 -15
  362. package/dist/commands/project/provider/get.js +0 -12
  363. package/dist/commands/project/provider/set.d.ts +0 -16
  364. package/dist/commands/project/provider/set.js +0 -18
  365. package/dist/commands/project/provider/test.d.ts +0 -15
  366. package/dist/commands/project/provider/test.js +0 -12
  367. package/dist/domain/ai-provider-capabilities.d.ts +0 -109
  368. package/dist/domain/ai-provider-capabilities.js +0 -180
  369. package/dist/domain/ai-provider-command-helpers.d.ts +0 -27
  370. package/dist/domain/ai-provider-command-helpers.js +0 -55
  371. package/skills/using-vvicat-ai-short-studio-cli/references/b-roll-and-screen.md +0 -9
  372. package/skills/using-vvicat-ai-short-studio-cli/references/caption-and-graphics-direction.md +0 -11
  373. package/skills/using-vvicat-ai-short-studio-cli/references/composition-and-shot-review.md +0 -17
  374. package/skills/using-vvicat-ai-short-studio-cli/references/craft-index.md +0 -20
  375. package/skills/using-vvicat-ai-short-studio-cli/references/drama-canvas.md +0 -19
  376. package/skills/using-vvicat-ai-short-studio-cli/references/format-relationships.md +0 -15
  377. package/skills/using-vvicat-ai-short-studio-cli/references/h3-prompts.md +0 -7
  378. package/skills/using-vvicat-ai-short-studio-cli/references/image-and-reference-direction.md +0 -9
  379. package/skills/using-vvicat-ai-short-studio-cli/references/licensed-music.md +0 -9
  380. package/skills/using-vvicat-ai-short-studio-cli/references/licenses/oh-my-short-drama-MIT.txt +0 -21
  381. package/skills/using-vvicat-ai-short-studio-cli/references/licenses/short-drama-MIT.txt +0 -21
  382. package/skills/using-vvicat-ai-short-studio-cli/references/media-provenance-and-review.md +0 -22
  383. package/skills/using-vvicat-ai-short-studio-cli/references/paid-plan.md +0 -7
  384. package/skills/using-vvicat-ai-short-studio-cli/references/production-specialties.md +0 -25
  385. package/skills/using-vvicat-ai-short-studio-cli/references/recreation.md +0 -21
  386. package/skills/using-vvicat-ai-short-studio-cli/references/reference-analysis-and-timing.md +0 -19
  387. package/skills/using-vvicat-ai-short-studio-cli/references/remotion-editing.md +0 -18
  388. package/skills/using-vvicat-ai-short-studio-cli/references/shot-production.md +0 -9
  389. package/skills/using-vvicat-ai-short-studio-cli/references/sound-and-captions.md +0 -7
  390. package/skills/using-vvicat-ai-short-studio-cli/references/sources.md +0 -6
  391. package/skills/using-vvicat-ai-short-studio-cli/references/story-craft/canvas-production.md +0 -9
  392. package/skills/using-vvicat-ai-short-studio-cli/references/story-craft/guide.md +0 -7
  393. package/skills/using-vvicat-ai-short-studio-cli/references/story-craft/index.md +0 -13
  394. package/skills/using-vvicat-ai-short-studio-cli/references/video-and-performance-direction.md +0 -9
  395. package/skills/using-vvicat-ai-short-studio-cli/references/voice-and-sound-direction.md +0 -9
  396. package/skills/using-vvicat-ai-short-studio-cli/references/writing-polish.md +0 -15
  397. /package/skills/using-vvicat-ai-short-studio-cli/references/{licenses/humanizer-MIT.txt → short-drama/assets/modules/humanizer/LICENSE} +0 -0
  398. /package/skills/using-vvicat-ai-short-studio-cli/references/{story-craft → short-drama/writing}/compliance-checklist.md +0 -0
  399. /package/skills/using-vvicat-ai-short-studio-cli/references/{story-craft → short-drama/writing}/genre-guide.md +0 -0
  400. /package/skills/using-vvicat-ai-short-studio-cli/references/{story-craft → short-drama/writing}/hook-design.md +0 -0
  401. /package/skills/using-vvicat-ai-short-studio-cli/references/{story-craft → short-drama/writing}/opening-rules.md +0 -0
  402. /package/skills/using-vvicat-ai-short-studio-cli/references/{story-craft → short-drama/writing}/paywall-design.md +0 -0
  403. /package/skills/using-vvicat-ai-short-studio-cli/references/{story-craft → short-drama/writing}/rhythm-curve.md +0 -0
  404. /package/skills/using-vvicat-ai-short-studio-cli/references/{story-craft → short-drama/writing}/satisfaction-matrix.md +0 -0
  405. /package/skills/using-vvicat-ai-short-studio-cli/references/{story-craft → short-drama/writing}/villain-design.md +0 -0
@@ -0,0 +1,433 @@
1
+ # Directing generated video
2
+
3
+ Read this before writing or adapting a video prompt, performance Recipe or action. An image can
4
+ establish who and where; generated video brings the Script and visual idea to life through speech,
5
+ interaction, camera behavior or silent action.
6
+
7
+ For creator-led social video, favor an appealing, engaged performance: the speaker responds to what
8
+ they are saying and draws someone into the thought. Voice, expression and movement carry that
9
+ relationship together. Expressiveness concerns how clearly the attitude comes through; it can be
10
+ outgoing or restrained.
11
+
12
+ ## Let footage carry temporal behavior that matters
13
+
14
+ Choose generation inputs from what the new shot must actually realize. A still can establish a
15
+ person, object, place or composition; prose can direct an action and its expressive purpose. When a
16
+ particular unfolding in time is essential to the result—its performed rhythm, path, contact,
17
+ coordination or camera relationship—and prose and stills would lose that information, use the
18
+ relevant source footage as a video reference to a model that accepts it. This judgment follows the
19
+ action the work needs, whether or not the user names a generation method. A broadly described action
20
+ can leave more freedom to the model when its exact movement is not the point.
21
+
22
+ Replacing a person is a common case; the target may instead change an object, world, words or sound.
23
+ A comic speaking performance can depend on the relation between vocal phrasing, face, gesture and
24
+ camera angle; dance on coordination, a fight on contact, and a fixed-camera mishap on how its cause
25
+ and payoff develop within the view. Watch and listen to learn what the source contributes. Its vocal
26
+ manner can inform direction, while Script and [voice direction](voice-direction.md) establish the
27
+ target's words and voice. The video reference can carry temporal behavior while image references
28
+ establish the new visible facts and the prompt directs their relationship.
29
+ [Transformation](../../creation/transformations.md#reshape-an-event-from-footage) owns what the
30
+ new work keeps and reshapes. Watching a reference to understand a work is distinct from connecting
31
+ a selected excerpt as an actual generation input.
32
+
33
+ Choose an excerpt that contains the useful action and, when relevant, its preparation or settling.
34
+ Its range follows the relationship to preserve, the intended new duration and the selected model's
35
+ reference limits. Connect the actual footage in Source; describing it in prose does not supply
36
+ its temporal behavior to the model. The selected model and Provider determine supported combinations
37
+ and media requirements; read their installed vocabulary and package documentation for the exact
38
+ request. Seedance requires `person-reference="true|false"` on each image/video reference: true if
39
+ the supplied material contains a person, false otherwise.
40
+ Inspect the selected excerpt, not just its first frame. Audio must omit the field; the installed
41
+ Seedance README owns the corresponding required first/last-frame attributes.
42
+
43
+ For a reference-led recreation, a depth prepass is mandatory before final shot generation. Generate and
44
+ inspect the depth video first, then pass it as the motion/structure/camera reference; an optional selected
45
+ character board may additionally carry identity and appearance. Never omit this edge from the request
46
+ graph; choose another model or Endpoint when the current route cannot consume it.
47
+
48
+ Before compiling a recreation request, approve the selected character, scene and prop assets and the
49
+ shot's depth video, then bind their actual files with the video prompt in one ordered per-shot manifest.
50
+ Add audio and a reviewed storyboard when the shot plan requires them; ordinary recreation shots do not
51
+ need two boards.
52
+ [Asset and shot preproduction](asset-and-shot-preproduction.md)
53
+ owns this gate and the different responsibility of each reference. A complete asset library does not
54
+ mean every asset belongs in every request; use the views that know this shot without silently dropping a
55
+ required identity, world, prop-state, planned storyboard or depth role.
56
+
57
+ Lock a recreation's visual baseline before generating shots: source exposure and white balance, skin
58
+ texture and diffusion, contrast and saturation, lens/field of view, depth of field, camera height and
59
+ movement character. Carry the same concrete baseline into every related request. Do not pass original
60
+ keyframes or previous generated tails as routine recreation references. Preserve identity, costume,
61
+ body proportions, screen direction, held-prop state,
62
+ key-light direction and the source shot's end pose across that handoff.
63
+
64
+ Direct physical actions through contact states rather than action names alone: anticipation, limb and
65
+ joint path, contact point, transferred weight, prop response, recovery and a briefly stable tail. Split
66
+ an interaction when one request would need several independent contacts or exact hand choreography.
67
+
68
+ ## Build natural motion from causes, not adjectives
69
+
70
+ Do not use `natural movement`, `realistic motion` or `cinematic motion` as a substitute for direction.
71
+ Give every visible person one current primary action, an attention target, a trigger for reacting and a
72
+ clear state while uninvolved. In a group, name people by stable position or identity and stagger onset,
73
+ amplitude, gaze and reaction latency unless the Script truly calls for marching, ritual unison or a
74
+ shared startle. A group that turns, nods, blinks or starts walking on the same frame reads as generated.
75
+
76
+ Stillness is not a frozen frame. At a shot size where the behavior is visible, let breathing move the
77
+ chest and shoulders slightly, let gaze refocus through small eye movements, allow irregular independent
78
+ blinks and carry expression through a continuous transition. Use only a few of these cues and keep
79
+ background behavior below the narrative subject; a list of periodic micro-actions creates another kind
80
+ of mechanical performance. Voice-over keeps visible lips closed, but the face, eyes, breath and posture
81
+ remain alive.
82
+
83
+ Give larger movement a physical chain: planted support, center-of-mass transfer, hip or shoulder lead,
84
+ joint path, acceleration, deceleration, follow-through and recovery. After contact, keep the correct
85
+ grip, load and connected-object response. Hair, hems, loose sleeves, accessories and carried objects are
86
+ secondary motion: they lag the driving body or wind, travel at smaller amplitude and settle with damping.
87
+ Do not add windless flutter, whole-body phase locking or an instant stop. The setting may respond only to
88
+ an evidenced force—a cushion compresses after sitting, a door creates a brief draft, a footfall disturbs
89
+ nearby dust—not because the shot needs generic movement.
90
+
91
+ Keep the prompt's motion budget small: one narrative primary action and only the secondary motions that
92
+ make its cause, weight or reaction legible. Split a shot when several exact interactions compete. Give
93
+ the camera one motivated curve with a start, speed development and end; a locked-off camera never drifts.
94
+ This follows the practical separation of subject, camera and scene motion in Runway's official Gen-4
95
+ guidance, the structured subject/action/context approach in Google's Veo guidance, and the prompt-
96
+ extension practice published with Wan. These sources support richer, explicit motion description; they
97
+ do not make text alone a substitute for depth, motion tracks or other temporal references when exact
98
+ timing matters.
99
+
100
+ Primary references:
101
+
102
+ - Runway, `Gen-4 Video Prompting Guide`: https://help.runwayml.com/hc/en-us/articles/39789879462419-Gen-4-Video-Prompting-Guide
103
+ - Google DeepMind, `How to create effective prompts with Veo 3`: https://deepmind.google/models/veo/prompt-guide/
104
+ - Wan-Video, `Wan2.1`: https://github.com/Wan-Video/Wan2.1
105
+ - Lightricks, `ComfyUI-LTXVideo` motion-track workflows: https://github.com/Lightricks/ComfyUI-LTXVideo
106
+
107
+ ## Turn subtext into gaze and facial behavior
108
+
109
+ An internal state is not a visible instruction. Convert it into a causal performance chain: the person
110
+ receives a word, sound, sight or touch; attention moves; they try to preserve a social mask; one small
111
+ feature leaks the change; they decide or act; a residual expression survives into the cut. Stop when the
112
+ Script, storyboard or approved character profile supplies no evidence for the next link. Do not invent a
113
+ secret motive merely to make the shot feel dramatic.
114
+
115
+ Give gaze an object and screen geography. Name the person, prop or off-screen position being watched;
116
+ state whether the character holds, glances, averts or returns; and choose whether the eyes lead the head
117
+ or the head turns with them. Preserve the off-screen target across the axis. Looking into the lens is a
118
+ specific direct-address or POV choice, not a default sign of intensity. Direct the listener too: receiving,
119
+ judging, resisting or anticipating can be legible through attention and timing without copying the
120
+ speaker's movement.
121
+
122
+ Facial direction should describe visible change instead of a broad emotion label. In a close shot, use
123
+ one or two readable regions—brow tension, eyelid narrowing, a held lower lip, one lip corner losing its
124
+ smile, nostril tension or a jaw set—and give the change a low-amplitude onset, apex and release. Do not put
125
+ FACS Action Unit numbers into a model prompt; FACS is useful here because it separates observable muscle
126
+ components, not because its codes are model vocabulary. Do not stack the whole face or hold a
127
+ micro-expression as a pose. At medium distance, carry the same beat through gaze, head, breath and jaw;
128
+ at wide distance, use posture, pause, interpersonal distance and blocking.
129
+
130
+ Bind these choices to the character profile. `eyeline_behavior`, `blink_rhythm`, `stress_response`,
131
+ triggered `habitual_actions` and `forbidden_performance` travel with the selected character reference as
132
+ `performance_constraints`. A habitual action appears only when its recorded trigger occurs, while a
133
+ forbidden performance remains forbidden in every shot. Profile behavior supplies continuity; the current
134
+ dramatic stimulus determines whether and how it becomes visible.
135
+
136
+ OpenFace's public implementation treats gaze, head pose and facial Action Units as distinct measurable
137
+ channels, while FACS decomposes facial movement into anatomical components. GoHD likewise separates pose,
138
+ gaze and expression driving. These are useful design boundaries: coordinate the channels around one
139
+ dramatic beat, but do not collapse them into one synchronized facial gesture.
140
+
141
+ Primary references:
142
+
143
+ - Paul Ekman Group, `Facial Action Coding System`: https://www.paulekman.com/facial-action-coding-system/
144
+ - OpenFace, `Action Units` and gaze APIs: https://github.com/TadasBaltrusaitis/OpenFace/wiki/Action-Units
145
+ - GoHD official implementation: https://github.com/Jia1018/GoHD
146
+ - EMOCA official implementation: https://github.com/radekd91/emoca
147
+
148
+ For a longer action, distinguish the duration of source footage the model can accept from the
149
+ duration it can produce in one request. Use one request when the model's capability and the work's
150
+ continuity allow it. A forty-second fight might contain several exchanges and reversals, or its
151
+ uninterrupted choreography might be the point. If separate requests serve the work, select excerpts
152
+ around meaningful action or camera relationships and carry forward the target
153
+ people, objects and world through useful references. A literal boundary frame helps when that exact
154
+ continuity is intended; it is not needed for every new passage. The accepted outputs establish the
155
+ target's actual time. When uninterrupted continuity is essential, use a capability that can carry
156
+ it or explain what an edited interpretation changes. When an accepted wordless action carries the
157
+ passage, [empty Segments](../../production/media.md#empty-segments-use-their-media-boundaries)
158
+ let that material establish its time without word tokens.
159
+
160
+ [Reference relationships](generated-dependencies.md) owns how images carry identity and world
161
+ forward across requests. This page owns the decision to give a video request temporal evidence.
162
+
163
+ ## Direct the reason for an action
164
+
165
+ Give the passage a clear expressive intention, then specify the few details that decide how it
166
+ lands. Start with how the speaker regards the subject and relates to the listener: eagerly sharing
167
+ a discovery with a friend, weighing an ambitious claim with skeptical interest, or affectionately
168
+ roasting something they know well. Such directions suggest voice, expression, posture and rhythm
169
+ together. Their value is the performable relationship they contain.
170
+
171
+ As with [Image direction](image-direction.md#two-ideas-behind-every-sentence), high-level
172
+ language should carry sensory direction. The model can realize "admiring but incredulous" across a
173
+ whole passage. Words such as "lively" or "expressive" set an energy level; the speaker's particular
174
+ response to the meaning gives that energy direction. Locate the consequential thought in the Script
175
+ and make its expression concrete: what earns an accent, changes the face, or moves the body?
176
+ Voice, expression and gesture can reinforce one response, with whichever channels make it legible.
177
+ A single revealing reaction can carry the thought; specifying all channels at every phrase adds no
178
+ inherent value.
179
+
180
+ For example, alongside a Script that questions a price and ends with an ironic compliment:
181
+
182
+ ```text
183
+ She is venting to a friend with affectionate exasperation at how overpriced this is. At the price,
184
+ her eyebrows rise and her open palm turns upward with an incredulous vocal accent. Let the final
185
+ compliment land with a teasing smile in her voice.
186
+ ```
187
+
188
+ The first sentence directs the entire encounter. The details make the price and the ironic turn
189
+ read clearly; the remaining phrasing and movement can grow naturally from that attitude. A detail
190
+ earns its place when it clarifies a judgment, reveals a response or preserves an important physical
191
+ relationship. Attaching a hand movement to every phrase adds choreography without necessarily
192
+ strengthening the expression.
193
+
194
+ Let the thought determine whether the attitude develops or holds: an example may win a skeptical
195
+ speaker over, while a firm argument may sustain the same conviction throughout. When adapting a
196
+ reference, recover what prompts the reaction and how it lands, then find the corresponding thought
197
+ in the new Script. This preserves the expressive relationship while letting the new words call for
198
+ their own movements and phrasing. Phrase-level emphasis should fit the performed language's tones
199
+ and cadence; a source-language stress pattern is not a universal performance instruction.
200
+
201
+ Carry the character, voice and useful physical relationships across Takes while directing the
202
+ attitude each passage calls for. The same speaker can invite, question, tease and persuade as the
203
+ argument develops. Shared direction can preserve their manner; the passage supplies the particular
204
+ response. Carry forward production continuity, and reconsider the expressive intention whenever the
205
+ thought changes. Stable framing leaves room for changes in face, voice and posture.
206
+
207
+ ## Give restraint an expressive purpose
208
+
209
+ Seriousness can mean weighing a claim, insisting on a fact or challenging an assumption. A relaxed
210
+ person can tease, dismiss or show interest with very little effort. Choose the behavior that conveys
211
+ that attitude. A small, deliberate response can carry more conviction than constant movement.
212
+
213
+ For a serious judgment:
214
+
215
+ ```text
216
+ She weighs the claim with skeptical interest. Her brow tightens at the price; she gives the number
217
+ a pointed emphasis, then lands her judgment with a small, decisive nod.
218
+ ```
219
+
220
+ For a languid response:
221
+
222
+ ```text
223
+ He lounges back in the chair, amused that anyone finds this impressive. He draws out the setup
224
+ with a sideways glance, then tosses off the verdict in a light, dismissive tone.
225
+ ```
226
+
227
+ These are different intentions, not prescribed poses for every serious or relaxed person. Breathing,
228
+ blinking and small posture adjustments supply ordinary life; the speaker's response to the content
229
+ supplies the performance. Direct that response even when the body stays almost still.
230
+
231
+ Contrast describes a relationship between things; it leaves the performer's attitude unspecified.
232
+ Turn the chosen relationship into something the person can express: "She tries to sound composed,
233
+ but cannot quite hide her pride in the result" gives voice and expression a shared direction.
234
+ Humor reaches the viewer through the words, situation, response or delivery. A straight-faced
235
+ performance can sharpen a clear joke through pointed emphasis or a dry turn of phrase; an unusual
236
+ appearance alone does not make an even explanation funny. [Treatment](../../creation/brief.md#treatment-is-the-directors-answer)
237
+ owns how the premise becomes a viewer experience; action directs the person's part in creating it.
238
+
239
+ ## Ground actions in the generated scene
240
+
241
+ The prompt describes what this generation should make visible over time. Give a performer physical
242
+ relationships with the camera, people, props and parts of the setting that actually exist in the
243
+ generated scene. Translate a later graphic's framing needs into the camera view, gaze or gesture
244
+ the video should perform. Give the later Caption, icon or product card its own content and events
245
+ through composition. A prop or display intended to exist within the generated scene can be described
246
+ as that actual object and connected through the relevant references.
247
+
248
+ The spoken subject and the visible action have separate responsibilities. A speaker can discuss
249
+ objects, quantities, transformations or an imaginary demonstration while the camera records only
250
+ their performance in the referenced setting. Preserve the words in Dialogue; use action to describe
251
+ the person's response to those words. A quoted phrase can locate a vocal accent or a hand beat
252
+ without asking for its meaning to appear as an object, written label or event in the shot.
253
+
254
+ Make the performer the subject of the direction. "She gives the promise a satisfied accent and a
255
+ small nod" identifies what the camera and microphone should capture. "Make the idea tangible" or
256
+ "show that it works" leaves the means of demonstration open. Complete that translation into the
257
+ intended voice, expression or physical interaction before writing the request. Read the assembled
258
+ prompt as one account of the generated scene; a general no-text instruction does not resolve an
259
+ ambiguous invitation to demonstrate the spoken content visually.
260
+
261
+ Capable video models can turn figurative wording into literal objects, events or transformations. Use
262
+ concrete visible language for intended gaze, gesture, movement, camera behavior and cuts when a
263
+ metaphor would introduce the wrong scene content. Social attitude and aesthetic shorthand remain
264
+ useful when they direct performance; an imagined object or event belongs in the prompt when it should
265
+ truly appear in the generated world.
266
+
267
+ Give the performer an attitude they can express, such as questioning a claim with skeptical interest.
268
+ The broader purpose of persuading an audience belongs in Treatment; translate it into this person's
269
+ delivery and interaction. Decide whether a described action really happens or whether a gesture is
270
+ intended, then state that choice. [Direction and its inputs](../../production/system.md#give-each-part-the-direction-it-can-realize)
271
+ connects those performance choices to the whole composition.
272
+
273
+ Natural emphatic gestures are usually more reliable than asking fingers to display an exact number.
274
+ Let speech, Caption or MG convey the quantity while pointing and hand actions serve the performance.
275
+ An encounter also has edges: someone interrupted can first be occupied, and someone finishing can
276
+ begin to leave. Small causes make a clip feel like a piece of life rather than a pose bounded by the
277
+ encoder.
278
+
279
+ ## Prepare footage for subject isolation
280
+
281
+ When the work needs a moving silhouette, choose a background-removal method that can process the
282
+ actual footage. For new generation, a continuous, evenly lit chroma backdrop can support a chosen
283
+ keying workflow. Choose a color separated from the person's hair, clothing and carried objects;
284
+ direct the visible body extent, performance and stable backdrop as facts of this recording. This
285
+ is a material-preparation choice for that use. Existing footage can instead use a suitable matting
286
+ capability, and an opaque camera view can remain useful through cropping and reframing.
287
+
288
+ The moving result needs its own alpha-producing operation. A transparent reference still alone
289
+ does not establish transparency in generated video. Keep the original when the final work also uses
290
+ its setting. [Media preparation](../../production/media.md#keep-original-and-processed-material-explicit)
291
+ owns processing, alpha-preserving normalization and explicit use of those outputs. Judge the moving
292
+ edge against its intended background, including shoulders, hair, hands, spill and changes in opacity.
293
+
294
+ ## Give each input its own responsibility
295
+
296
+ | Input | Responsibility |
297
+ | --- | --- |
298
+ | Character-and-scene references | appearance, setting, framing and the physical state to preserve |
299
+ | Product, interface or other factual references | the visible facts that need continuity or exactness |
300
+ | Source-footage references | performed, physical or camera relationships whose timing should guide the new shot |
301
+ | Recurring voice references | a speaker's intended voice identity when the model accepts them |
302
+ | Script dialogue | the exact words, intended pronunciation and speaking turns for a visible performance |
303
+ | Prompt Kit or Recipe | a reusable prompt relationship that fits this kind of work |
304
+ | Passage direction | attitude, vocal delivery, attention, physical interaction, camera behavior and motivated cuts |
305
+
306
+ Keep those responsibilities explicit in Source. Prompt prose does not create a media edge, and a
307
+ reference does not explain which fact it should preserve. A selected model may accept only some of
308
+ these inputs; use its installed vocabulary and package-local documentation for the exact request.
309
+ Generated source footage must not contain incidental subtitles, captions, titles, labels, logos,
310
+ watermarks, UI text or other unrequested readable text. Approved story text that physically belongs in
311
+ the shot, including a countdown, may be generated when the Brief calls for it.
312
+
313
+ For each exact countdown, clock, message or difficult changing state, make a temporal storyboard before
314
+ video generation. Default to six cells, while selecting another count when needed for accurate state
315
+ coverage. Give each reading or required state its own cell, approve the original-resolution pixels,
316
+ then attach the board as a semantic reference and direct the exact sequence and timing. The output remains
317
+ one normal full-frame video and must not reveal the grid. Reject malformed output and regenerate after
318
+ improving the prompt or board; never repair generated video with painting, inpainting, compositing,
319
+ source-footage patches or local region replacement.
320
+
321
+ For a visible A-roll performance, the generated video normally carries the person's picture, exact
322
+ Script delivery and sound together. In recreation mode, give the request the Segment's dialogue and
323
+ an audio reference when the reviewed shot plan requires one; general non-recreation modes may use a
324
+ recurring Voice Reference when supported.
325
+ [Voice direction](voice-direction.md) owns the casting and sample that establish who the person sounds
326
+ like. The passage's direction gives that voice its current attitude and delivery.
327
+ [Script pronunciation](../../creation/script-and-time.md#write-the-intended-pronunciation) explains
328
+ how names and abbreviations receive the intended reading while keeping their display spelling.
329
+ Independent speech is a different A-roll construction, described in
330
+ [Voice and performance](voice-and-performance.md).
331
+
332
+ Final generated shots default to joint picture-and-audio generation. Wordless action still carries the
333
+ directed ambience and physical sound unless the Brief explicitly requires silence or the Endpoint lacks
334
+ native audio; record that waiver before generation. For visible speech, measure the dialogue first, size the
335
+ request around that performed duration, include the exact Script line and direct voice, mouth movement,
336
+ breath and scene sound in the same request. Seedance defaults `generate-audio` to `true`; for H3, populate
337
+ its audiovisual prompt sections and attach a reviewed audio reference when the recreation shot requires one. When speech must be produced
338
+ separately, plan explicit lip synchronization and review the actual phoneme-to-mouth result before the
339
+ Take is accepted.
340
+
341
+ When the source alternates languages, split analysis by utterance or speaking interval and confirm each
342
+ turn's language independently. Write the exact original line and language code into the joint audiovisual
343
+ request. Do not use the file's dominant language for every turn, infer speech from translated subtitles,
344
+ or let the model translate or switch the declared language.
345
+
346
+ For silent B-roll, direct the visual event and omit speaking identity that the shot does not use. A
347
+ listener or reaction shot can remain silent while still breathing, noticing, adjusting posture or
348
+ responding through expression. [B-roll](b-roll.md) owns its editorial relationship to the underlying
349
+ performance.
350
+
351
+ ## Choose the generation relationship
352
+
353
+ Seedance 2 Mini at 720p is the usual starting point for generated performances, balancing capability
354
+ and cost. Choose for the intended shot and the user's available services; the selected model's
355
+ installed vocabulary owns supported resolutions, references and request lengths.
356
+
357
+ Generated-video models commonly expose some combination of three relationships:
358
+
359
+ | Relationship | When it fits |
360
+ | --- | --- |
361
+ | Text-directed video | The intended world and action do not depend on an existing visual identity, composition or motion reference. |
362
+ | First-/last-frame video | The shot must begin or end at a particular authored image. |
363
+ | Reference-directed video | Images, video or audio should guide identity, world, voice, motion or camera language without declaring literal endpoints. |
364
+
365
+ Reference-directed generation is the strong starting point for controlled Hypit production because
366
+ useful images can already establish people, scenes, products, composition and visual continuity. The
367
+ requested performance then makes that world move. Text-directed or first-/last-frame generation remains
368
+ useful when its relationship is genuinely the one the shot needs; a last frame belongs when arriving
369
+ at that exact image is part of the intended action.
370
+
371
+ Model-specific Surfaces and Prompt Kits are implementations of these relationships, not the Craft
372
+ itself. Kits produce ordinary Text; Source connects that Text and the actual references to the selected
373
+ model request. The current Distribution may provide model-specific Kit packages such as
374
+ `@hypit/seedance-kits`; their package documentation owns exact imports, slots, Recipe choices and
375
+ reference order. [Prompt Kits](../../production/prompt-kits.md) explains using or authoring a Kit
376
+ without making it a model wrapper.
377
+
378
+ Read the selected template's wording when choosing its Recipe. Composition, camera, edit rhythm,
379
+ performance and gesture choices shape different aspects of the footage. Choose them to support the
380
+ intended delivery, and use action Text for the passage's particular meaning and reactions.
381
+
382
+ ## Direct camera and cuts as part of the passage
383
+
384
+ For ordinary direct-to-camera social video, prefer pause-trim jump cuts at phrase boundaries. This
385
+ edited rhythm keeps the explanation moving and gives the footage the immediacy of a creator's own
386
+ cut-down recording. Stable framing, expressive acting and frequent edits are compatible choices.
387
+ Use the selected Kit's documented Recipe choice to express that rhythm.
388
+
389
+ A podcast can cut with a speaker or toward a meaningful reaction. A street interview can favor the
390
+ guest and use the interviewer view for a reaction. An unfolding action or a held reaction may gain
391
+ its effect from a continuous shot; choose that temporal shape when it serves the passage.
392
+
393
+ One generated video can contain multiple shots, several speaking turns or a split-screen composition.
394
+ One Segment is not one speaker turn or one camera shot. Conversely, several Takes can reuse the same
395
+ character-and-scene image and meet at natural editorial cuts. A genuinely continuous shot calls for
396
+ the model relationship and direction that preserve that action. See
397
+ [Reference relationships](generated-dependencies.md) when deciding which visual or motion evidence
398
+ should condition each request.
399
+
400
+ When supported by the selected model, several camera images can guide one request through different
401
+ views or locations. Direct which people, settings and states each image contributes and how the
402
+ passage develops among them. Reference images in this relationship guide the generated footage;
403
+ they become literal first or last frames only when that is the chosen generation relationship.
404
+ Choose the request's span from the intended performance and the model's supported duration and
405
+ reference inputs, not from a one-image-per-shot correspondence.
406
+
407
+ A prompt-directed jump cut asks the generator for an edited rhythm; it does not inspect or trim the
408
+ returned media. When produced footage needs a deterministic cut, speed change or trim, use the
409
+ corresponding media operation and align the edited result before it becomes a SemanticTake.
410
+
411
+ ## Size the request around the delivery
412
+
413
+ Use `hypit measure` on a spoken Segment at its intended pace, including time for meaningful
414
+ interaction, pauses and actions. [Script and time](../../creation/script-and-time.md#measure-before-choosing-durations)
415
+ owns the command, rounding and the relationship between estimated duration and real aligned time.
416
+ Choose that pace from the intended performance and carry it into the voice and passage direction.
417
+ For brisk social delivery with trim cuts, `fast` is a useful starting choice; the name `normal`
418
+ does not make it the right rhythm for every piece. A shorter duration gives the words less room,
419
+ while the direction still supplies the stresses, attitude and reactions that make them engaging.
420
+ Measurement sizes the words; emphasis, attitude and motivated reactions give their delivery character.
421
+ The target's delivery determines how much generated media the passage needs; the reference video's
422
+ seconds help explain its rhythm without becoming the target duration automatically.
423
+
424
+ Read the selected video model's supported request lengths from its installed vocabulary. Those values
425
+ constrain one generation request without defining the finished work's Segment structure or edited
426
+ beats. When the estimate does not fit one request cleanly, reconsider the performable passage: a brief
427
+ question and answer may belong together, a short line may gain a meaningful reaction, and a long
428
+ exchange may divide where its thought turns. Preserve the intended meaning and energy, then choose a
429
+ supported duration.
430
+
431
+ After production, normalized media supplies the real envelope and alignment supplies word positions.
432
+ Use that material and timing to compose the piece. [Composition review](../../production/review.md)
433
+ owns judging how Caption, MG, B-roll and other layers work with the produced performance.