Agent Skill

短剧镜头生成

用一个定稿的戏剧节拍、演员和场景参考以及镜头方向,为短剧视频生成一个电影感的竖屏微短剧镜头。这个 AI 短剧镜头生成与竖屏微短剧制作工作流可以仅凭文本生成真人或电影感镜头,把确认的开场图变成动态镜头,在严格的首尾两张图之间生成过渡动作,或把松散的演员、场景、道具参考组合成全新的短剧镜头。适合情感冲突、悬疑反转、反应镜头、对话特写、建立镜头、古装短剧、情绪对峙和电影感产品故事镜头,每个镜头都冻结镜头卡、逐镜保持人物特征连续性,并如实复盘每个完成的镜头。

设计多媒体·AI音乐人·来自 skill_hub·skillhub.cn ↗
skillhub install @user_87b8e34f/ai-short-drama-shot-maker
17 Stars·21.1万 综合热度·5,439 字文档·源站更新 2026-11-22

README 文档

5,439 字

AI短剧镜头生成

从一个定稿的戏剧节拍、演员和场景参考以及镜头方向,生成一个电影感的竖屏微短剧镜头。本 Skill 适用于 AI 短剧镜头、竖屏微短剧场景、情感冲突、悬疑反转、反应镜头、对话特写、建立镜头、古装短剧、情绪对峙和电影感产品故事镜头。

适用范围与相邻路由

常规路线是一个定稿的戏剧节拍,它变成一个完成的镜头。插画或漫画动态漫请求路由到漫剧工作流;分镜或规划图请求路由到分镜工作流;广泛的非叙事视频请求路由到通用视频工作室。本路线专注于电影感、真人或写实人类戏剧——具有明确镜头语言和表演的竖屏短剧镜头。

输入与默认值

硬性输入是:

  • 一个戏剧节拍:本镜头的人物、动作、场景、情绪、镜头和可见结果;
  • 参考是可选的,但对于反复出现的演员或场景强烈推荐。

只询问缺失的硬性输入。复用已知的演员特征、服装、场景、画幅以及对话或旁白偏好。对于宿主 Agent 可访问的本地图片文件,仅在查看之后使用随包上传助手:

python3 scripts/mcp_client.py upload ./opening-frame.jpg --mime-type image/jpeg

上传只是传输,不是创意审阅。保留返回的素材引用,绝不向远程工具传递本地路径。

默认输出一个镜头,model: "auto",竖屏画幅如 9:16。在任何付费调用之前冻结镜头卡:人物特征、服装、场景、动作、情绪、镜头语言、走位、构图和可见结果。按来源路由:

  • 纯文本节拍 → beatra.videos.generate;
  • 一张严格的确认开场图 → beatra.videos.animate;
  • 严格确认的开场和结尾图 → beatra.videos.interpolate;
  • 松散的演员、场景或道具参考 → beatra.videos.generatefromreferences。

串行生成依赖镜头:在将某个带特征镜头的确认帧用作下一个镜头参考之前先审阅该镜头。

黄金路径

  1. 查看每一个可用的图片参考。记录其实际 MIME 类型、宽度、高度、画幅和字节大小。识别演员特征、服装、场景、动作、情绪、镜头语言、走位、构图以及本镜头应交付的定稿戏剧节拍。
  2. 构建镜头卡:人物特征、服装、场景、动作、情绪、镜头语言、走位、构图和可见结果。然后写出一条正向提示词,编码本镜头的表演、氛围和落点时刻。
  3. 按来源选择路线。调用 beatra.models.list 并传入匹配的能力,确认某张当前模型卡接受每一个实际媒体事实、镜头控制项以及任何驱动音频。除非用户已选定一个具体的可用模型,否则保持模型为 auto。
  4. 在 beatra.models.list 准入完整载荷之后,在任何 clientrequestid 或 beatra.videos.generate、beatra.videos.animate、beatra.videos.interpolate、beatra.videos.generatefromreferences 调用之前出示准入卡:路线和 MCP 工具名、源图片、使用参考媒体时的参考、提示词、最短准入时长、如有则写分辨率、输出数量、临时实时估价、600 积分注册赠额通常开不了这段视频、以及余额不足时会怎样。规划、比较或「去做这段」都不是批准。用户确认已充值或已有足够积分覆盖本次估价之前,不要提交。用一个不透明且稳定的 clientrequestid 冻结它们;然后恰好提交一次视频调用。只调用随包 scripts/mcp_client.py:MCP 工具名是 CLI 参数,其参数是标准输入上的 JSON。例如,一张严格开场图的动画化:
   printf '%s' '{"image":{"type":"artifact","artifact_id":"art_opening"},"prompt":"Slow dolly-in on the woman as her expression shifts from composure to tears, cinematic shallow depth of field, warm backlight.","aspect_ratio":"9:16","client_request_id":"opaque-drama-animate-id"}' | python3 scripts/mcp_client.py call beatra.videos.animate

严格的开场和结尾图过渡:

   printf '%s' '{"first_frame":{"type":"artifact","artifact_id":"art_open"},"last_frame":{"type":"artifact","artifact_id":"art_end"},"prompt":"The man stands up slowly and turns to face the camera, tension building in his posture, cinematic vertical framing.","aspect_ratio":"9:16","client_request_id":"opaque-drama-interpolate-id"}' | python3 scripts/mcp_client.py call beatra.videos.interpolate

纯文本节拍:

   printf '%s' '{"prompt":"A cinematic vertical shot: a woman in a red dress stands at a rainy bus stop at night, neon reflections on wet pavement, she turns as headlights approach, suspenseful mood, shallow depth of field.","aspect_ratio":"9:16","client_request_id":"opaque-drama-generate-id"}' | python3 scripts/mcp_client.py call beatra.videos.generate

松散的演员和场景参考:

   printf '%s' '{"references":[{"kind":"image","media":{"type":"artifact","artifact_id":"art_actor"}},{"kind":"image","media":{"type":"artifact","artifact_id":"art_location"}}],"prompt":"The actor walks through the reference location, discovers a letter on the table, reaction close-up, cinematic lighting.","aspect_ratio":"9:16","client_request_id":"opaque-drama-references-id"}' | python3 scripts/mcp_client.py call beatra.videos.generate_from_references

不要配置、调用或使用宿主 Beatra Connector。不要使用 REST/OpenAPI 回退。恰好提交一次所选的视频工具。

  1. 立即记录返回的任务 ID,并用 beatra.tasks.get 轮询同一任务直到终态。交付每一个返回的视频素材或链接。只报告实际返回的任务状态、解析后的模型、尺寸、时长、用量和 billing.netchargedcredits。审阅可访问的结果,检查演员特征、服装、走位、表演、镜头语言、竖屏构图、情绪节拍、对白节奏和连续性记录。说明宿主 Agent 能和不能查看的内容。

付费变更、恢复与取消

每个镜头是一个付费视频阶段。更换节拍、演员参考、开场图、提示词、模型、画幅、时长或视频控制,都属于新的逻辑付费工作,配以新的 ID、新的准入卡,以及新的充值或余额确认。遇到 insufficientbalance 时,转达返回的说明,余额错误里的充值链接保持原样,用户说已充值后再用同一冻结的 clientrequest_id 重试。

如果创建响应丢失,只用相同的阶段 ID 重放字节完全一致的冻结负载。如果任务 ID 丢失,调用 beatra.tasks.list 查找相关能力,用 beatra.tasks.get 检查可能的候选任务,并对照该阶段的私有账本确认后再考虑相同重试。排队和运行中是进度状态,不是失败。在规划变更工作之前先恢复原阶段;绝不重复付费提交,也不猜测其扣费或退款。

只有当用户要求取消时才调用 beatra.tasks.cancel。调用一次,并用 beatra.tasks.get 确认最终的终态。409 表示取消未确认,因此继续轮询同一任务,不要创建替代工作。

工具返回积分不足时:把工具返回的原文整段交给用户,链接一个字不改。其余可以译成中文。不要改写成自己的充值说明。引导用户按原文去充值。

账户余额

用户问还剩多少积分,或某次实时估价够不够时,调用 beatra.wallet.get。问已经扣了多少 时,调用 beatra.wallet.ledger。两者都是只读的。不要臆造查余额或充值的工具。也不要把 wallet.get 变成每次付费提交前的必需步骤。

模型卡返回里带 top_up 块时,按卡片给出的档位和顺序原样转述。不要给档位排高低,不要 贬低其中任何一档,也不要替用户挑。选哪一档是用户自己的事,钱包页会把整份清单摆在他 面前。任何时候都不要凭记忆报档位。

按任务查阅参考

  • 在构建镜头卡、选择路线、核对实时模型事实、构造确切负载、轮询、恢复、取消或审阅演员特征和连续性时,阅读 短剧镜头工作流(references/workflow.md)。
  • 仅当授权或共享凭据需要处理时,阅读 安装与授权(references/installation-and-auth.md)。
  • 关于非计费、尽力而为的安装登记步骤,阅读 安装登记(references/installation-registration.md)。
  • 关于共享的终态任务和素材语义,阅读 任务与结果(references/tasks-and-results.md);关于返回的计费或错误详情,阅读 计费、错误与恢复(references/billing-errors-and-recovery.md)。
  • 当随包客户端无法连接时,阅读 随包 MCP Client 连接诊断(references/mcp-connection.md)。不要配置宿主 Connector。
  • 更新与安全:更新与安全(references/updates-and-security.md)
  • 仅当用户要求移除本包或共享凭据时,阅读 卸载与断开连接(references/uninstall-and-disconnect.md)。

每次 Beatra 操作都使用或调用随包 scripts/mcp_client.py。

更新与安全

本 Skill 会自动更新。内置客户端每天最多一次从 Beatra 官网读取本渠道的版本信息 (中国大陆网络走 www.beatra.cn 与 cdn.beatra.cn)。有新版本时,它下载官方发布包, 逐个文件校验 SHA-256,再替换本 Skill 自己的文件;你放进这个目录的其他文件不会被 改动。替换过程中断时,下次运行会自动恢复到替换前的状态。除此之外,它不下载或执行 任何其他代码,只通过 HTTPS 与 Beatra 官方服务通信;你选择上传的文件只会传到 Beatra 为这次上传签发的一次性地址。

关闭自动更新:python3 scripts/mcp_client.py update --auto off。关闭后,客户端每天 最多提示一次在你安装它的商店里更新的命令。详见更新与安全(references/updates-and-security.md)。

同分类其他技能

查看全部 ›