Back to skills
extension
Category: Marketing & GrowthNo API key required

TikTok达人Brief·达人主页转Brief图

TikTok达人Brief把达人主页和近期作品做成一组合作Brief图。

personAuthor: beatra01hubOpenAPI

TikTok达人Brief·达人主页转Brief图

把 TikTok 达人主页和近期作品,做成每条选定合作条件一张合作Brief图。交付 4 到 8 张。

适用范围与相邻路线

媒介已经选定一名 TikTok 达人,要用该主页、近期作品和已经写好的合作条件做合作Brief图时,使用本 Skill。

达人短名单转到 influencer-fit-analyzer。账号诊断和首条作品转到 creator-account-teardown。口播视频不走本包。

本包只读一名 TikTok 达人主页和一页作品并做Brief图,不在 TikTok 上发帖。当前连接没有 TikTok 用户或作品操作时,只用已经粘贴的原话。

收集达人和合作条件

硬输入是:

  • 公开 TikTok 主页链接或 @handle,或已经抄下的主页事实和近期作品;
  • 每张卡可以印出的已经写好的合作条件(产品、交付、费用或置换、截止日期、必写项);
  • 这包要几张,或允许使用默认 6 张。

复用已知品牌配色和投放位置。 只补问缺失的硬输入。4 到 8 以外的数量也能做:确认该规模和实时费用。

不要编造账号、粉丝数、播放数或合作条件。可选的品牌图只作版式参考,不是缺失条件的来源。拿到文件不等于同意。

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

先做免费备忘和清单

任何付费查找或出图前,先写带标签的查找备忘和Brief图清单。用户没有另报 4 到 8 之间的数量时,默认六条词条。每条词条记下用到的达人事实(查找或粘贴)、由运营已写文案印出的合作条件、版式、画布,以及是否用品牌图带版式。

这份清单就是用户已经粘贴内容上的免费可见结果。规划不是批准。

安全默认:

  • 每条词条一次 beatra.images.generate
  • model: "auto",除非用户选了实时 SKU;
  • 每条词条 count 为 1;
  • 正方形 2K,除非用户点名了别的投放比例。

查找主页单独一张卡

主页链接或账号并不等于批准查找。用户要当前连接去读公开 TikTok 主页或近期作品时,按 达人查找(references/creator-lookup.md) 先搜索或检视,然后出示六字段查找卡并等待:

  1. 做什么 — 为点名的达人读一页公开 TikTok 用户搜索、主页或作品 (beatra.social.execute,使用刚检视到的 operation_key)。
  2. 积分 — beatra.social.tools.get 刚刚返回的实时价格。 引用这个实时数字,不要用记住的数。
  3. 几笔 — 一次预付查找。用户搜索是一笔。主页读取是另一笔。作品页是另一笔。下一页是另一笔费用。
  4. 身份 — 每一次 execute 一个新的不透明 client_request_id
  5. 若停在这里 — 已粘贴主页的计划仍然可用。
  6. 若余额不足 — 原样转达官方说明和充值链接 (https://console.beatra.ai/wallet?intent=buy)。翻译正文,保留链接。用户说已充值之前不要重试。不要推荐 ¥198。

不要向用户展示 schema_hash。已确认的查找并不批准出图。查找到终态后,报告载荷、任务编号、终态和 billing.net_charged_credits。查找没有模型、画幅或时长可报。

确认出图,再确认可选变换或局部修改

查找和出图是分开的付费阶段。每个阶段各自一张六字段卡,每条词条各自一个不透明 client_request_id

出图前,调用 beatra.models.list,能力为 text_to_image

{"capability": "text_to_image"}

出示出图卡并等待:

  1. 做什么 — 每个点名词条一张合作Brief图 (beatra.images.generate)。
  2. 积分 — 刚读到的 text_to_image 价格乘以词条数。不要复用记忆中的数字。
  3. 几笔 — 每条词条一次付费出图。不要把几条条件合成一次 count
  4. 身份 — 每条词条一个新的不透明 client_request_id
  5. 若停在这里 — 带标签的清单仍然可用。
  6. 若余额不足 — 原样转达官方说明和充值链接 (https://console.beatra.ai/wallet?intent=buy)。翻译正文,保留链接。用户说已充值之前不要重试。不要推荐 ¥198。

每个出图词条只通过随包 scripts/mcp_client.py 提交一次。用 beatra.tasks.get 轮询。读取实际图像 MIME、画幅和大小,以及 billing.net_charged_credits

用户要已接受的卡片贴近一张品牌静帧时,读取当前的 image_to_image 卡片,并在 beatra.images.transform 之前等在单独的变换卡上:

{"capability": "image_to_image"}

只用 beatra.images.edit 在用户接受一张卡并要求局部修正之后,把那张已接受图作为 images[0]。先读取当前的 image_edit 卡片:

{"capability": "image_edit"}

已确认出图并不批准变换或局部修改。

审图、交付与恢复

查看每张静帧是否印出了选定达人事实,以及是否只印运营已写的合作条件。只报告宿主实际看得到的文字。把生成的小字当作审图项,不要当成认证报价。每个付费任务到终态后,交付实际字节以及存在的 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_image"}
python3 scripts/mcp_client.py call beatra.models.list
{"capability": "image_to_image"}
python3 scripts/mcp_client.py call beatra.models.list
{"capability": "image_edit"}
printf '%s' '{"query":"creator","platform":"tiktok","capability_family":"creator"}' | python3 scripts/mcp_client.py call beatra.social.tools.search
printf '%s' '{"prompt":"Create the approved collaboration brief still for the named creator term. Print only the operator-supplied collab line.","model":"auto","count":1,"canvas":{"type":"preset","tier":"2K","aspect":"1:1"},"client_request_id":"opaque-tiktok-brief-01"}' | python3 scripts/mcp_client.py call beatra.images.generate

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

按任务查阅的参考

  • 清单、查找、载荷和恢复,读 Brief图工作流(references/workflow.md) 和 达人查找(references/creator-lookup.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