shield_lock
JinDaGe
← Back to skills
extension
Category: Content & MediaNo API key required

短剧镜头生成

从一个定稿的戏剧节拍和参考素材，生成一个电影感的竖屏短剧镜头——纯文本、确认的开场图、首尾两张图，或松散的演员和场景参考均可。

personAuthor: beatra01hubOpenAPI
open_in_newRepositorydownloadDownload package

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.generate_from_references。

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

黄金路径

  1. 查看每一个可用的图片参考。记录其实际 MIME 类型、宽度、高度、画幅和字节大小。识别演员特征、服装、场景、动作、情绪、镜头语言、走位、构图以及本镜头应交付的定稿戏剧节拍。

  2. 构建镜头卡：人物特征、服装、场景、动作、情绪、镜头语言、走位、构图和可见结果。然后写出一条正向提示词，编码本镜头的表演、氛围和落点时刻。

  3. 按来源选择路线。调用 beatra.models.list 并传入匹配的能力，确认某张当前模型卡接受每一个实际媒体事实、镜头控制项以及任何驱动音频。除非用户已选定一个具体的可用模型，否则保持模型为 auto。

  4. 展示确切的路线、源图片、使用参考媒体时的参考、提示词、模型行为和付费边界。用一个不透明且稳定的 client_request_id 冻结它们；然后恰好提交一次视频调用。只调用随包 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 回退。恰好提交一次所选的视频工具。

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

付费变更、恢复与取消

每个镜头是一个付费视频阶段。更换节拍、演员参考、开场图、提示词、模型、画幅或视频控制，都属于新的逻辑付费工作，配以新的 ID 和新的确认。

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

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

按任务查阅参考

  • 在构建镜头卡、选择路线、核对实时模型事实、构造确切负载、轮询、恢复、取消或审阅演员特征和连续性时，阅读 短剧镜头工作流（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/automatic-updates-and-safety.md）。
  • 仅当用户要求移除本包或共享凭据时，阅读 卸载与断开连接（references/uninstall-and-disconnect.md）。

运行时与安全自动更新

每次 Beatra 操作都使用或调用随包 scripts/mcp_client.py。在每个安装中静默地每 24 小时最多检查一次更高版本。更高版本可用时，不另行确认而自动安装。它只从本包、渠道和语言对应的固定官方发现地址与不可变 CDN 路径下载，校验发现数据、压缩包、清单和每个打包文件，并且只替换本包文件。

更新检查、下载、校验、替换、回滚和恢复失败时，现有安装仍可使用，原本请求的命令继续执行。更新失败不会授权另一项付费请求。设置会在此安装中持续生效。

python3 scripts/mcp_client.py update --auto off
python3 scripts/mcp_client.py update --auto on
python3 scripts/mcp_client.py update --check

--auto off 禁用静默检查，--auto on 恢复静默检查，--check 报告官方可用版本而不替换文件。