Communitygithub.com

PrunaAI/pruna-skills

當使用者想要從文字或起始/結束影格產生電影級短片時使用——產品廣告、紀錄片鏡頭或搭配生成音訊的對話。不適用於 1080p、匯入音軌或僅談話頭的主持人。

pruna-skills 是什麼?

這個技能「PrunaAI/pruna-skills」是一個專為 AI 代理(如 Claude Code、Cursor 或 Codex)設計的綜合性工具組,用於透過 Pruna API 生成高品質、電影風格的短片。它依賴於多個輔助技能:`generation-diversity` 確保提示詞的多樣性與品質,`video-prompting` 提供專業的動態提示詞撰寫框架(包含戲劇結構、攝影機運鏡與物理安全的動作描述),而 `audio-prompting` 則負責處理文字轉語音或音樂生成。技能的核心是 `p-video-2-pro` 模型,它能從純文字、單張圖片或首尾兩張圖片生成帶有原生音訊的影片,支援從 480p 到 768p 的解析度,並提供成本、速度與品質三種模式選擇。此技能也明確定義了使用邊界:不處理 1080p 影片、不支援匯入外部音軌、不適合僅有談話頭的主持人場景;對於這些需求,它會建議改用 `p-video-2`、`p-video-avatar` 或其他相關技能。

相容平台~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/PrunaAI/pruna-skills/tree/HEAD/skills/video/p-video-2-pro

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

先決條件

在生成前請先安裝並載入這些技能(如果已透過 @pruna 存在於上下文中則可跳過):

技能描述安裝指令
generation-diversity撰寫任何生成式提示詞時使用——隨機種子、明確結構、場景軸線,以及在付費 API 呼叫前的品質門檻。npx skills add PrunaAI/pruna-skills@generation-diversity -y
video-prompting為任何生成式模型設計影片或動態提示詞時使用——戲劇結構、攝影機運鏡、符合物理的動作、影格錨點與片段串接。npx skills add PrunaAI/pruna-skills@video-prompting -y
audio-prompting為任何生成式音訊模型設計文字轉語音、音樂或背景提示詞時使用——導演風格、歌曲結構與後製分層。npx skills add PrunaAI/pruna-skills@audio-prompting -y
pruna-api在進行任何 Pruna 或 Replicate HTTP 呼叫前使用——憑證、上傳/輪詢/下載、平行批次與代理安全。npx skills add PrunaAI/pruna-skills@pruna-api -y

或一次安裝完整套件:npx skills add PrunaAI/pruna-skills@pruna -y

請遵循每個技能的**「生成前」**/撰寫章節——請勿在此重複指南內容。

代理習慣

路由: `p-video-2-pro` 是電影級生成的短片(文字/第一影格/第一+最後影格),並附帶生成音訊。當需求需要 1080p、匯入音訊或草稿預覽時,請使用 `p-video-2`。使用 `p-video` 可獲得更便宜、更快速的草稿。僅談話頭(沒有原生場景音訊)→ `p-video-avatar`。對現有素材進行指令編輯 → `p-video-edit`。

在第一次回覆中,請用反引號標示 `p-video-2-pro`,確認 PRUNA_API_KEY(或如果沒有,請從 pruna-api 提供註冊連結停止),然後詢問所需的輸入。開始受理→在第一次 POST 之前進行 generation-diversity 的釐清受理。在草擬動態提示詞時,請遵循**「提示詞撰寫(動態 + 忠實)」和 video-prompting(p-video-2-pro-prompting)——請勿貼上技能範例。當「何時不使用」**更合適時,請重新導向。

提示詞撰寫(動態 + 忠實)

每個 input.prompt 必須是全新且具體的,並且必須符合使用者的節奏。多樣性絕不能凌駕於需求之上。與 p-video-2 的差異:video-prompting(p-video-2-pro-prompting)。請將聲音或對話寫入提示詞——此模型沒有 audio 上傳功能。

應該做不應該做
執行 generation-diversity 的隨機種子儀式;說明它;當需求允許時,旋轉 ≥2 個自由軸線(攝影機運鏡、光線變化、材質、節奏)複製此技能的 curl 範例(sports car、person turns……)或重複使用先前工作階段的提示詞
先鎖定使用者要求的事實(主體、動作、場景;當有影格錨點時,OPEN/MID/CLOSE;當需求包含音訊時,寫出語句/SFX)為了「更酷」的片段而更換主體或動作,忽略原始請求
使用 video-prompting 的戲劇結構進行結構化——主體 + 動作 + 場景;加上攝影機、光線、風格和音訊意圖,以獲得鎖定的最終版本模糊的純情緒字串(cinematic vibe, neon energy)或當需求要求語音或配樂時使用無聲提示詞
將說話者控制在一到兩位;在提示詞中寫出台詞在一個片段中塞入 3 個以上說話的臉孔,或發送 audio / draft / fps(此 API 不支援)
在使用者尚未鎖定文字時,在 POST 前展示草擬的提示詞 + mode / prompt_upsampler / duration / resolution使用與批准內容不同的主體或節奏進行無聲重新生成

**忠實度檢查(付費前):**如果你從提示詞中移除了使用者指定的主體/動作/場景,那麼任務就是錯的——請重寫。自由軸線只能填補需求中未指定的部分。

在展示草擬的提示詞時,仍然要標示 `p-video-2-pro`(指南協助撰寫;此工具擁有呼叫權)。

技能邊界

此技能 = 每次呼叫一次 p-video-2-pro 預測。

超出範圍(請勿由此技能執行):

  • 多場景組合、串接、子代理協調或平行場景批次
  • 匯入音訊 / 混合旁白 / 1080p / 草稿預覽 → p-video-2
  • 從範本影片進行動作轉移 → p-video-animate
  • 僅談話頭 / 無原生場景音訊的嘴型同步主持人 → p-video-avatar
  • 對現有素材進行指令編輯 → p-video-edit

如果請求超過一個片段,請停止並建議:image-to-video(一個節拍)、visual-transition-reel(多場景視覺)或 narrated-multi-scene(多場景 + 上傳旁白——該路徑使用 p-video-2)。

何時不使用

請改用其他技能:

技能描述安裝指令
p-video-2當使用者想要從文字、圖片或匯入音訊中獲得一個精緻的短片時使用——1080p B-roll、起始/結束影格動畫,或帶有混合音軌的動態鏡頭。不適用於電影級生成音訊片段或僅談話頭的主持人。npx skills add PrunaAI/pruna-skills@p-video-2 -y
p-video當使用者想要從文字或圖片中獲得一個簡單的短片時使用——快速 B-roll、草稿,或起始/結束影格動畫。不適用於需要電影級生成、最高品質、嚴格嘴型同步或匯入音訊到 1080p 的情況。npx skills add PrunaAI/pruna-skills@p-video -y
p-video-avatar當使用者想要一個人在鏡頭前朗讀腳本時使用——從肖像照片生成嘴型同步的主持人、發言人或帶旁白的虛擬人物。npx skills add PrunaAI/pruna-skills@p-video-avatar -y
p-video-animate當使用者想要一張照片像另一個影片一樣移動時使用——從範本片段進行動作轉移、舞蹈混音或表演變體。npx skills add PrunaAI/pruna-skills@p-video-animate -y
p-video-replace當使用者想要在現有素材中更換人物、服裝或產品,同時保持攝影機運鏡和音訊時使用。npx skills add PrunaAI/pruna-skills@p-video-replace -y
p-video-edit當使用者想要透過文字指令編輯現有影片時使用——重新上色、重新風格化、移除或添加物件、改變環境或光線、更新螢幕文字,或套用可選的參考引導產品與配件編輯。不適用於從頭開始的新片段或 ffmpeg 組合。npx skills add PrunaAI/pruna-skills@p-video-edit -y
video-editing當使用 ffmpeg 組合或打磨已渲染的片段時使用——串接、交叉淡出、燒錄字幕、文字/標誌疊加、前/後滑桿、背景音樂、平台匯出——或使用 Hyperframes 組建多層 HTML 組合影片。不適用於 AI 影片生成、提示詞撰寫或基於模型的影片編輯。npx skills add PrunaAI/pruna-skills@video-editing -y

HTTP (curl)

上傳圖片以進行圖像轉影片 / 影格錨點

curl -X POST "https://api.pruna.ai/v1/files" \
  -H "apikey: ${PRUNA_API_KEY}" \
  -F "content=@/path/to/first-frame.png"

將 urls.get 作為 input.image(第一影格)和/或 input.last_frame_image(最後影格)傳入。請勿為此模型上傳音訊。

建立(非同步文字轉影片——推薦)

curl -X POST 'https://api.pruna.ai/v1/predictions' \
  -H 'Content-Type: application/json' \
  -H "apikey: ${PRUNA_API_KEY}" \
  -H 'Model: p-video-2-pro' \
  -d '{
    "input": {
      "prompt": "A sports car drifting through a neon-lit city at night, cinematic aerial shot",
      "duration": 5,
      "resolution": "768p",
      "aspect_ratio": "16:9"
    }
  }'

輪詢和下載:請遵循 pruna-api。

在撰寫提示詞前完成 generation-diversity 的隨機種子儀式——請勿將儀式字串作為 API seed 傳入。

計費按回傳的秒數計費(不是請求的 duration)。速率限制:每分鐘 250 個請求。

解析度mode=costmode=speed(預設)mode=quality
480p$0.01 / s$0.02 / s$0.04 / s
768p$0.025 / s$0.035 / s$0.075 / s

cost 的輸出品質與 speed 相同,但更便宜且更慢。prompt_upsampler 不改變價格。

圖像轉影片(第一影格)

curl -X POST 'https://api.pruna.ai/v1/predictions' \
  -H 'Content-Type: application/json' \
  -H "apikey: ${PRUNA_API_KEY}" \
  -H 'Model: p-video-2-pro' \
  -d '{
    "input": {
      "prompt": "The camera slowly pushes in, the person turns their head and smiles",
      "image": "https://api.pruna.ai/v1/files/FIRST_ID",
      "duration": 5,
      "resolution": "768p"
    }
  }'

第一/最後影格(視覺過渡)

curl -X POST 'https://api.pruna.ai/v1/predictions' \
  -H 'Content-Type: application/json' \
  -H "apikey: ${PRUNA_API_KEY}" \
  -H 'Model: p-video-2-pro' \
  -d '{
    "input": {
      "prompt": "Start on the still product hero. The camera holds, then a slow push-in as light moves across the metal. End exactly on the last-frame packshot, label readable, no extra props.",
      "image": "https://api.pruna.ai/v1/files/START_ID",
      "last_frame_image": "https://api.pruna.ai/v1/files/END_ID",
      "duration": 8,
      "resolution": "768p",
      "mode": "speed",
      "prompt_upsampler": "turbo"
    }
  }'

此模型沒有場景錨點三元組(audio 未暴露)。上傳的旁白/音樂 → p-video-2。

建立(同步——僅快速測試)

curl -X POST 'https://api.pruna.ai/v1/predictions' \
  -H 'Content-Type: application/json' \
  -H "apikey: ${PRUNA_API_KEY}" \
  -H 'Model: p-video-2-pro' \
  -H 'Try-Sync: true' \
  -d '{
    "input": {
      "prompt": "A sports car drifting through a neon-lit city at night, cinematic aerial shot",
      "duration": 5,
      "resolution": "480p",
      "mode": "cost"
    }
  }'

生成前

  1. 按順序完成先決條件指南閱讀(generation-diversity → video-prompting)。
  2. 儀式種子 → 草擬一個動態 + 忠實的動態提示詞(上方章節)→ 與使用者確認模式(T2V / I2V / 影格配對)、duration(5–15 秒,預設 5)、resolution(480p / 768p)、mode(cost / speed / quality)、prompt_upsampler 和 prompt。
  3. Pruna 備註:當設定了 image 或 last_frame_image 時,aspect_ratio 會被忽略(畫布跟隨靜止圖片)。輸出為 24 fps——請勿發送 fps。輸出包含生成音訊;在提示詞中寫入聲音或對話。請勿發送 audio、draft、save_audio 或 prompt_upsampling。當價格為優先考量時,在 mode: cost 中迭代(與 speed 相同品質,但更便宜且更慢),或當實際時間重要時使用 mode: speed(預設);然後在保真度重要時使用 mode: quality 進行最終版本。如果請求是多場景——請停止(參見技能邊界)。不支援原生 4K。1080p / 匯入音訊 / 草稿 → p-video-2。

必填輸入

  • prompt(字串)

常見可選欄位

欄位角色
prompt_upsampler在生成前擴展提示詞:off、turbo(預設)或 max。獨立於 mode
image第一影格參考;設定時,aspect_ratio 會被忽略(支援 jpg、jpeg、png、webp)
last_frame_image可選的結束影格靜止圖片
duration5–15 秒(預設 5)
resolution768p(預設)或 480p
mode生成配方:cost(與 speed 相同品質,但更便宜且更慢)、speed(預設,更快)或 quality(更慢,更高保真度)
aspect_ratio當無參考圖片時:16:9(預設)、9:16、4:3、3:4、3:2、2:3、1:1
seed用於可重複執行的整數;省略則隨機

請勿發送: audio、draft、fps、save_audio、prompt_upsampling。

相關

相關技能:

技能描述安裝指令
p-video-2當使用者想要從文字、圖片或匯入音訊中獲得一個精緻的短片時使用——1080p B-roll、起始/結束影格動畫,或帶有混合音軌的動態鏡頭。不適用於電影級生成音訊片段或僅談話頭的主持人。npx skills add PrunaAI/pruna-skills@p-video-2 -y
p-video當使用者想要從文字或圖片中獲得一個簡單的短片時使用——快速 B-roll、草稿,或起始/結束影格動畫。不適用於需要電影級生成、最高品質、嚴格嘴型同步或匯入音訊到 1080p 的情況。npx skills add PrunaAI/pruna-skills@p-video -y
gemini-3.1-flash-tts當使用者需要口語旁白或配音時使用——解說音軌、紀錄片台詞,或與生成影片搭配的聲音。npx skills add PrunaAI/[email protected] -y
image-to-video當使用者想要從圖片中獲得一個短片節拍時使用——帶旁白的場景、故事時刻,或可選配音的電影級 B-roll。npx skills add PrunaAI/pruna-skills@image-to-video -y
visual-transition-reel當使用者想要一個帶有鏡頭過渡的蒙太奇時使用——動作場景片段或多場景片段,旁白為可選。npx skills add PrunaAI/pruna-skills@visual-transition-reel -y
narrated-multi-scene當使用者想要一個帶有旁白的多部分故事時使用——章節式 B-roll、分章節的宣傳片,或幾個沒有鏡頭前對話的連結影片場景。npx skills add PrunaAI/pruna-skills@narrated-multi-scene -y
p-video-avatar當使用者想要一個人在鏡頭前朗讀腳本時使用——從肖像照片生成嘴型同步的主持人、發言人或帶旁白的虛擬人物。npx skills add PrunaAI/pruna-skills@p-video-avatar -y
p-video-animate當使用者想要一張照片像另一個影片一樣移動時使用——從範本片段進行動作轉移、舞蹈混音或表演變體。npx skills add PrunaAI/pruna-skills@p-video-animate -y
video-editing當使用 ffmpeg 組合或打磨已渲染的片段時使用——串接、交叉淡出、燒錄字幕、文字/標誌疊加、前/後滑桿、背景音樂、平台匯出——或使用 Hyperframes 組建多層 HTML 組合影片。不適用於 AI 影片生成、提示詞撰寫或基於模型的影片編輯。npx skills add PrunaAI/pruna-skills@video-editing -y

Individual skills in this repo

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

PrunaAI/pruna-skills

Use when someone needs spoken narration or voiceover — explainer tracks, documentary lines, or voice to pair with generated video.

PrunaAI/pruna-skills

Use when someone wants an original AI song with vocals — sung lyrics, a style prompt track, or source audio for a music video.

PrunaAI/pruna-skills

Use when someone needs word-level timestamps from audio — lyric alignment, cut-safe line boundaries, or caption source timing before burn-in with video-editing.

PrunaAI/pruna-skills

Use before any Pruna or Replicate HTTP call — credentials, upload/poll/download, parallel batches, and agent safety.

PrunaAI/pruna-skills

Use when assembling or polishing already-rendered clips with ffmpeg — concat, crossfades, burned captions and subtitles, text/logo overlays, before/after sliders, background music beds, platform export — or when composing a multi-layer HTML combination video with Hyperframes. Not for AI video generation, prompt craft, or model-based video edits.

PrunaAI/pruna-skills

Use when crafting video or motion prompts for any generative model — dramaturgy, camera, physics-safe motion, frame anchors, and clip chaining.

PrunaAI/pruna-skills

Use when someone wants to edit an existing photo — change outfits or backgrounds, compose from reference images, or apply prompt-driven edits.

PrunaAI/pruna-skills

Use when someone explicitly wants the fastest, cheapest photo generation — mood boards, bulk panels, or quick iterations — not when controlled photoreal or in-image text is needed.

PrunaAI/pruna-skills

Use when someone wants virtual try-on — dress a person in clothes from reference photos for fashion or ecommerce.

PrunaAI/pruna-skills

Use when installing the full Pruna generative media suite — all guides, tools, and workflows in one package.

PrunaAI/pruna-skills

Use when someone wants a polished short clip from text, images, or imported audio — 1080p B-roll, start/end frame animation, or a motion shot with a mixed track. Not for cinematic generated-audio clips or talking-head-only hosts.

PrunaAI/pruna-skills

Use when someone wants to edit an existing video with a text instruction — recolor, restyle, remove or add objects, change environment or lighting, update on-screen text, or apply optional reference-guided product and accessory edits. Not for a new clip from scratch or ffmpeg assembly.

PrunaAI/pruna-skills

Use when someone wants a simple short clip from text or images — quick B-roll, drafts, or start/end frame animation. Not when the brief needs cinematic generation, highest quality, tight lip-sync, or imported audio at 1080p.

相關技能