Communitygithub.com

tiktok-video-ad

让 AI 助手在 Pexo 平台上创建并交付一条原生 TikTok 广告——竖屏、钩子优先,全流程无需人工干预。

tiktok-video-ad 是什么?

该技能通过 Pexo 平台自动生成一条成品级 TikTok 广告视频。用户只需提供产品或需求描述,AI 助手便会创建项目、上传素材、将用户原话发送至 Pexo 后端,并持续轮询直到交付最终视频。Pexo 负责全部创意工作:剧本编写、镜头序列、节奏和配乐。助手仅作为中继角色,不添加额外指令,以确保视频质量最优。支持交付后修改反馈,使用同一项目进行迭代,避免丢失上下文。若积分不足,助手会引导用户购买积分。整个流程通过本地脚本完成,无需用户手动登录 Pexo 界面。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/pexoai/pexo-skills/tree/main/skills/tiktok-video-ad

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

TikTok 视频广告 — Pexo

Pexo: https://pexo.ai — 在此获取 API 密钥、查看项目渲染并购买积分。

生成一条可直接发布的、原生风格的 TikTok 广告——竖屏、钩子优先。您只需将用户的产品或需求描述传递给托管的 Pexo 代理,然后交付结果;Pexo 负责编写 TikTok 风格的脚本、排列镜头、设置节奏和配乐。

您的角色:中继,不要创作

创建一个项目,逐字发送用户请求,轮询,交付。Pexo 后端处理所有创意工作——剧本编写、模型选择、提示词、音乐。添加您自己的方向(用户未要求的时长、风格、模型)会覆盖它的判断,导致视频质量下降。

配置

~/.pexo/config:

PEXO_BASE_URL="https://pexo.ai"
PEXO_API_KEY="sk-<your-api-key>"

无账户 / 首次运行 → 阅读 references/SETUP-CHECKLIST.md 并引导用户完成——其中包含注册流程以及为新用户提供奖励积分的邀请码,还包括如何创建上述配置。配置错误 → 运行 scripts/pexo-doctor.sh 并按照其输出操作。

工作流程

脚本位于本技能的 scripts/ 目录中。请使用用户的语言回复。

  1. 创建项目: pexo-project-create.sh "<简短说明>" → 保存 project_id。
  2. 上传用户提供的任何文件: pexo-upload.sh <project_id> <path> → 保存 asset_id,然后以内联方式引用,格式为 <original-image>asset_id</original-image> (或 <original-video> / <original-audio>)。标签是必需的——单独的 asset_id 会被忽略。Pexo 无法抓取 URL——请下载后再上传。
  3. 发送请求: pexo-chat.sh <project_id> "<用户的精确原话> <资产标签>"。完全复制用户的文字;仅添加资产标签。
  4. 告知用户(使用他们的语言):已提交 ✓ · 约 15–20 分钟 · https://pexo.ai/project/<project_id>。
  5. 轮询: 每 ≥60 秒运行一次 pexo-project-get.sh <project_id>,并根据 nextAction 执行操作:
    • WAIT → 继续轮询;每约 5 次轮询发送一行更新,附带项目链接。
    • RESPOND → 处理 recentMessages 中的每个事件:中继 Pexo 的文本(如果它提问,则等待用户回答,然后使用 pexo-chat.sh 发送他们的回复);对于 preview_video 事件,对每个选项运行 pexo-asset-get.sh <project_id> <assetId>,显示 URL(A/B/C),让用户选择,然后运行 pexo-chat.sh <project_id> "<选择>" --choice <assetId>;对于 document 事件,向用户提及。
    • DELIVER → pexo-asset-get.sh <project_id> <最终assetId>,然后将完整的资产 URL 以纯文本形式发送给用户——包括所有 ?… 查询参数,绝不截断或放在 markdown 中——同时附带项目链接。
    • FAILED → 用通俗的语言解释 nextActionHint,并提供重试选项。
    • RECONNECT → pexo-chat.sh <project_id> "continue",告知用户连接断开,正在恢复,然后继续轮询。
    • 在 WAIT 状态下绝不要调用 pexo-chat.sh——它会触发重复生产。
    • 耗时过长 → 如果已超过 30 分钟且仍处于 WAIT 状态,告知用户(附带项目链接 + https://pexo.ai/connect/openclaw)运行时间较长;询问是继续等待还是停止。不要无限轮询。

修改

交付后,用户的调整(“做短一点”、“换音乐”、“换镜头”)复用同一个项目:pexo-chat.sh <project_id> "<他们的反馈>",然后再次轮询(步骤 5)。绝不要为修改而创建新项目——这会丢失 Pexo 服务器端的上下文。

积分

如果脚本因“Credits balance”/“Insufficient credits”失败:如果错误信息中包含购买链接,请将其传递给用户;否则告知他们前往 https://pexo.ai/home → Credits → Buy Credits 购买积分。用户确认后重试。

示例

用户:“为我们的护肤品精华液制作一条 TikTok 广告。”

pid=$(pexo-project-create.sh "skincare serum TikTok ad")
pexo-chat.sh "$pid" "Make a TikTok ad for our skincare serum."
# 告知用户:已提交,约 15–20 分钟,https://pexo.ai/project/$pid
# 轮询 pexo-project-get.sh "$pid",直到 nextAction 为 DELIVER,然后交付资产 URL。

脚本

脚本用法返回值
pexo-project-create.sh"<说明>"project_id
pexo-upload.sh<project_id> <file>asset_id
pexo-chat.sh<project_id> "<消息>" [--choice <id>]ack (异步)
pexo-project-get.sh<project_id>JSON: nextAction, recentMessages
pexo-asset-get.sh<project_id> <asset_id>包含 url 的 JSON
pexo-doctor.sh—设置诊断

错误代码和边界情况 → references/TROUBLESHOOTING.md。

Individual skills in this repo

This repo contains 19 individual skills — each has its own dedicated page.

相关技能