返回 Skill 列表
extension
分类: 内容与媒体无需 API Key

漫剧镜头生成

上传一张漫画分镜、人物设定或故事画面,把它变成一个动态的漫剧镜头——单张漫画动起来、首尾分镜过渡,或多张参考组合成全新的漫剧镜头。

person作者: beatra01hubOpenAPI

AI漫剧镜头生成

把一张漫画分镜、人物设定、漫画页或定稿的故事画面变成一个动态的漫剧镜头。本 Skill 适用于 AI 漫剧、动态漫画、小说转漫剧镜头、漫画分镜动画、漫画人物出场、情绪特写、打斗镜头、对话反应镜头和连载创作者工作流。

适用范围与相邻路由

常规路线是一个确认的视觉来源和一个定稿的故事画面,它变成一个动态镜头。真人或电影感人类戏剧请求路由到短剧工作流;分镜或规划图请求路由到分镜工作流;广泛的非叙事视频请求路由到通用视频工作室。本路线专注于插画和漫画视觉语言——漫画、条漫、国漫、动漫和插画式动态漫镜头。

输入与默认值

硬性输入是:

  • 一个镜头事件:本镜头的人物、动作、场景、情绪、镜头和可见结束状态;
  • 至少一个确认的视觉来源:一张漫画分镜、漫画页、人物设定或条漫页——或一份足以创建并确认原创漫画起始帧的创作简报。

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

python3 scripts/mcp_client.py upload ./comic-panel.png --mime-type image/png

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

默认输出一个镜头,model: "auto",画幅取自源文件。在任何付费调用之前冻结镜头卡:人物特征、服装、画风、场景、动作、情绪、镜头、构图和可见结束状态。按输入语义路由:

  • 一张严格的确认分镜或人物图片 → beatra.videos.animate
  • 严格确认的首尾漫画分镜 → beatra.videos.interpolate
  • 多张松散的人物、画风或场景参考 → beatra.videos.generate_from_references
  • 无视觉来源 → 通过 beatra.images.generate 创建并确认一张原创漫画起始帧,然后让它动起来。

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

黄金路径

  1. 查看每一个可用的视觉来源。记录其实际 MIME 类型、宽度、高度、画幅和字节大小。识别人物特征、服装、画风、场景、动作、情绪、镜头、构图以及本镜头应交付的已确定故事节拍。

  2. 构建镜头卡:人物特征、服装、画风、场景、动作、情绪、镜头、构图和可见结束状态。然后写出一条正向提示词,编码本镜头的动作、氛围和落点时刻。

  3. 按输入语义选择路线。调用 beatra.models.list 并传入匹配的能力,确认某张当前模型卡接受每一个实际媒体事实、画风控制项以及任何驱动音频。如果需要原创首帧图片,就单独读取对应的图片卡,并让请求匹配实时 pricing.options;绝不要按源图片数量倍增用户估价。除非用户已选定一个具体的可用模型,否则保持模型为 auto

  4. 展示确切的路线、源图片、使用参考媒体时的参考、提示词、模型行为、当前估价和付费边界。如果准入前无法唯一确定图片价格选项,就展示实时价格区间,并按最高值作为批准上限。每个阶段用一个不透明且稳定的 client_request_id 冻结参数;然后恰好提交一次该阶段调用。只调用随包 scripts/mcp_client.py:MCP 工具名是 CLI 参数,其参数是标准输入上的 JSON。例如,一张严格分镜的动画化:

    printf '%s' '{"image":{"type":"artifact","artifact_id":"art_panel"},"prompt":"Animate the character turning toward the camera with wind blowing through their hair, keeping the cel-shaded art style and costume unchanged.","client_request_id":"opaque-comic-animate-id"}' | python3 scripts/mcp_client.py call beatra.videos.animate
    

    严格的首尾分镜过渡:

    printf '%s' '{"first_frame":{"type":"artifact","artifact_id":"art_first"},"last_frame":{"type":"artifact","artifact_id":"art_last"},"prompt":"The character rises from a crouch into a determined stance, comic speed lines radiating outward.","client_request_id":"opaque-comic-interpolate-id"}' | python3 scripts/mcp_client.py call beatra.videos.interpolate
    

    多张松散参考:

    printf '%s' '{"references":[{"kind":"image","media":{"type":"artifact","artifact_id":"art_character"}},{"kind":"image","media":{"type":"artifact","artifact_id":"art_style"}}],"prompt":"A dynamic entrance shot of the character bursting through a door, matching the reference art style.","client_request_id":"opaque-comic-references-id"}' | python3 scripts/mcp_client.py call beatra.videos.generate_from_references
    

    无视觉来源——创建起始帧,确认后再动画化:

    printf '%s' '{"prompt":"A cel-shaded comic panel: a young swordsman in a tattered cloak standing on a cliff at dawn, determined expression, speed lines in the background, vertical composition.","client_request_id":"opaque-comic-frame-id"}' | python3 scripts/mcp_client.py call beatra.images.generate
    

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

  5. 立即记录返回的任务 ID,并用 beatra.tasks.get 轮询同一任务直到终态。交付每一个返回的视频素材或链接。只报告实际返回的任务状态、解析后的模型、尺寸、时长、用量和 billing.net_charged_credits。审阅可访问的结果,检查面部、服装、绘画风格、构图、动作可读性、适用的口型动作、端点行为以及跨独立生成镜头的人物特征连续性。说明宿主 Agent 能和不能查看的内容。

付费变更、恢复与取消

每个镜头是一个付费视频阶段。创建原创起始帧的图片阶段是独立的付费阶段,拥有自己的请求 ID。更换人物特征、画风、分镜、参考、提示词、模型、画幅或视频控制,都属于新的逻辑付费工作,配以新的 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 报告官方可用版本而不替换文件。