Communitygithub.com

tiktok-video-ad

透過 Pexo 代理產生原生、可直接發布的 TikTok 廣告影片,擅長豎屏與鉤子開場。你只需轉述用戶需求,Pexo 負責腳本、分鏡與節奏。

tiktok-video-ad 是什麼?

TikTok Video Ad 技能讓 AI 代理能透過 Pexo(pexo.ai)平台自動產生原生風格的 TikTok 廣告影片。代理的角色是「轉述者」而非「創作者」:將用戶的產品描述或簡報完整傳送給 Pexo 後端,後者處理所有創意工作——腳本撰寫、模型選擇、提示詞與音樂編排。支援的腳本包含建立專案、上傳素材、發送請求、輪詢進度與取得最終資產。工作流程包含五個階段:建立專案(pexo-project-create.sh)、上傳檔案(pexo-upload.sh 並使用 asset tags)、發送請求(pexo-chat.sh)、輪詢直到 nextAction 為 DELIVER,最後提供完整資產 URL。技能支援修訂(重複使用相同專案)與信用不足處理。此技能特別適用於 Claude Code、Cursor 或 Codex 等 AI 代理,幫助快速產生廣告素材而無須直接處理影片編輯工具。

相容平台~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> <路徑> → 儲存 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> "繼續",告知用戶連線中斷,正在恢復,然後繼續輪詢。
    • 在 WAIT 狀態下絕不呼叫 pexo-chat.sh — 這會觸發重複產出。
    • 花費過久 → 若超過 30 分鐘仍處於 WAIT 狀態,請告知用戶(附上專案連結 + https://pexo.ai/connect/openclaw)目前執行時間較長;詢問要繼續等待還是停止。不要無限輪詢。

修訂

交付後,用戶的調整(「縮短一點」、「換音樂」、「不同分鏡」)重複使用同一個專案:先執行 pexo-chat.sh <project_id> "<他們的意見回饋>",然後再次輪詢(步驟 5)。切勿為修訂建立新專案 — 這會丟棄 Pexo 伺服器端的上下文。

點數

若腳本因「點數餘額不足」/「點數不足」而失敗:如果錯誤訊息附帶購買連結,請將其傳給用戶;否則請告知用戶前往 https://pexo.ai/home → 點數 → 購買點數來加值。在用戶確認後重試。

範例

用戶:「為我們的護膚精華液製作一支 TikTok 廣告。」

pid=$(pexo-project-create.sh "護膚精華液 TikTok 廣告")
pexo-chat.sh "$pid" "為我們的護膚精華液製作一支 TikTok 廣告。"
# 告知用戶:已提交,約 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> <檔案>asset_id
pexo-chat.sh<project_id> "<訊息>" [--choice <id>]確認 (非同步)
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.

相關技能