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

双选会口播·展位一条

按已经写好的岗位稿和授权静帧,做成双选会口播,每张照片一条。

person作者: beatra01hubOpenAPI

双选会口播·展位一条

把已经写好的双选会岗位稿和授权静帧,做成每张静帧一条口播。交付 2 到 8 条。每条各自成文件。

适用范围与相邻路线

招聘方要用可授权静帧,按岗位稿带学生走过这个展位时,使用本 Skill。

按线上岗位出招聘口播转到 hiring-avatar-studio。 实习生入职须知口播转到 intern-onboarding-avatar。 不是展位口播的通用讲述者转到 talking-avatar-video。民宿欢迎转到 airbnb-welcome-avatar。创作者上新预告转到 creator-drop-talking

收集展位材料

硬输入是:

  • 至少一张宿主 Agent 可以查看的静帧——招聘或创始人人像,或将作为首帧的展位照片;
  • 团队已经写好的双选会岗位事实(岗位名、团队、展位位置、展位下一步);
  • 画面里会出现人脸或要克隆声音时的形象和声音权利;
  • 这包要几条,或允许使用默认 3 条。

复用已知措辞、工位名称,以及冻结的 voice_id。 只补问缺失的硬输入。2 到 8 以外的数量也能做:确认该规模和实时费用。

不要编造薪资、编制、展位号或人脸。拿到文件不等于同意。

查看每张静帧。记录 MIME 类型、宽、高、画幅、字节大小和是否有 alpha 通道。本地文件检查后,只通过随包客户端上传 (scripts/mcp_client.py / beatra.assets.upload)。保留返回的产物编号。绝不要把本地路径传给 beatra.voices.clonebeatra.speech.synthesizebeatra.videos.animate

先做免费口播清单

任何付费克隆、旁白或视频前,先写带标签的展位口播清单。团队没有另报 2 到 8 之间的数量时,默认三条:展位欢迎、岗位和下步。每条记下静帧、由已确认岗位稿写出的口播句、作为 2–15s 成片的目标时长,以及用目录音色、已确认音轨还是克隆。

这份清单就是免费可见结果。规划不是批准。

安全默认:

  • 每张静帧一次 beatra.videos.animate
  • model: "auto",除非团队选了实时 SKU;
  • 静帧作严格首帧;
  • 画幅由源图决定;
  • 按时长由音频决定,落在 2–15s。每条各自成文件。

确认克隆、旁白,再确认视频

克隆、旁白和视频是分开的付费阶段。每个阶段各自一张六字段卡,每条各自一个不透明 client_request_id

团队要克隆音色时,先查看其可授权样本,读取当前的 voice_clone 卡片,并在 beatra.voices.clone 之前等在克隆卡上。找到的文件不是克隆同意。出示克隆卡并等待:

  1. 做什么 — 一份可授权声音样本(beatra.voices.clone)。
  2. 积分 — 刚读到的 voice_clone 价格。不要复用记忆中的数字。
  3. 几笔 — 这份样本一次付费克隆。
  4. 身份 — 一个新的不透明 client_request_id
  5. 若停在这里 — 带标签的口播清单仍然可用。
  6. 若余额不足 — 原样转达官方说明和充值链接 (https://console.beatra.ai/wallet?intent=buy)。翻译正文,保留链接。团队说已充值之前不要重试。不要推荐 ¥198。

旁白前,调用 beatra.models.list,能力为 text_to_speech

{"capability": "text_to_speech"}

目录音色还没定时再用 beatra.voices.list。 出示旁白卡并等待:

  1. 做什么 — 每条点名口播一句展位岗位稿 (beatra.speech.synthesize)。
  2. 积分 — 刚读到的 text_to_speech 价格乘以条数。不要复用记忆中的数字。
  3. 几笔 — 每条一次付费旁白。
  4. 身份 — 每条一个新的不透明 client_request_id
  5. 若停在这里 — 带标签的口播清单仍然可用。
  6. 若余额不足 — 原样转达官方说明和充值链接 (https://console.beatra.ai/wallet?intent=buy)。翻译正文,保留链接。团队说已充值之前不要重试。不要推荐 ¥198。

每条旁白只通过随包 scripts/mcp_client.py 提交一次。把口播句放进 input。用 beatra.tasks.get 轮询。读取实际音频 MIME、时长和大小。文稿预览不是音频审听。

视频前,调用 beatra.models.list,能力为 image_to_video

{"capability": "image_to_video"}

确认当前卡片接受 [image, driving_audio]。把每张图的事实和真实音频 MIME、时长、大小对照公布约束。实时 driving-audio 成片是 2–15s。旁白长于最长可容纳成片时,拆成连续可容纳分段;每段各自新的旁白和新的视频,各用新标识。分段各自成文件。已确认旁白并不批准视频。600 积分注册礼金通常开不起这次视频。出示视频卡并等待:

  1. 做什么 — 每张点名静帧一条展位口播 (beatra.videos.animate)。
  2. 积分 — 刚读到的 image_to_video 价格乘以分段数。不要复用记忆中的数字。
  3. 几笔 — 每段已确认音频一次付费视频。
  4. 身份 — 每段一个新的不透明 client_request_id
  5. 若停在这里 — 口播清单和已确认旁白仍然可用。
  6. 若余额不足 — 原样转达官方说明和充值链接 (https://console.beatra.ai/wallet?intent=buy)。翻译正文,保留链接。团队说已充值之前不要重试。不要推荐 ¥198。

然后每段已确认音频提交一次 beatra.videos.animate

审片、交付与恢复

核对形象、口播清晰度和口型时机。只报告宿主实际看得到、听得到的内容。不要承诺完美对口型。绝不要发明拼接、concat 或剪辑工具。每个付费任务到终态后,交付实际字节以及存在的 MIME、时长和大小,还有 billing.net_charged_credits。不要承诺预付估价就是最终扣费。

拿到 task_id 后轮询该任务。创建响应丢失时,先用 beatra.tasks.list 搜索,再用 beatra.tasks.get 核对,然后再重放。只有参数逐字节相同才能复用原标识。静帧、口播句、音色或时长变了就是新卡和新标识。只有团队要求时才取消。

执行

每个远程 Beatra 操作都只通过本包随附的 scripts/mcp_client.py 调用。把 MCP 工具名放在 call 后面,并向标准输入发送一个 JSON 对象。

python3 scripts/mcp_client.py call beatra.models.list
{"capability": "text_to_speech"}
python3 scripts/mcp_client.py call beatra.models.list
{"capability": "image_to_video"}
printf '%s' '{"image":{"type":"artifact","artifact_id":"art-booth-01"},"driving_audio":{"type":"artifact","artifact_id":"art-speech-01"},"prompt":"A restrained booth welcome with steady eye line and a stable camera.","duration":8,"client_request_id":"opaque-booth-video-01"}' | python3 scripts/mcp_client.py call beatra.videos.animate

不要配置或调用宿主 Beatra Connector,也不要使用 REST/OpenAPI 作为降级。

按任务查阅的参考

  • 口播清单、载荷和恢复,读 双选会口播工作流(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)。
  • 更新保证和控制,读 自动更新与安全(references/automatic-updates-and-safety.md)。移除时读 卸载与断开(references/uninstall-and-disconnect.md)。

运行时与安全的自动更新

随包客户端会在每个安装中静默检查更新,最多每 24 小时一次。发现更高版本时,不另行确认地自动安装。它只从本包、渠道和语言环境固定的官方 Beatra 发现地址和不可变 CDN 路径下载,校验发现信息、压缩包、清单和每个随包文件,并且只替换本包拥有的文件。

更新检查、下载、校验、替换、回滚和恢复失败时会 fail open:当前安装仍可使用,原本请求的命令会继续执行。更新失败绝不构成重试付费克隆、旁白或视频请求的理由。这个设置会在本安装中持续生效。见 自动更新与安全(references/automatic-updates-and-safety.md)。

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