Communitygithub.com

PrunaAI/pruna-skills

當使用者需要口語敘述或配音時使用——解說音軌、紀錄片旁白,或為生成的影片配上語音。

pruna-skills 是什麼?

這項技能專為需要生成高品質口語敘述(如解說、紀錄片旁白或為影片配音)的場景設計。它基於 Replicate 平台上的 Google Gemini 3.1 Flash TTS 模型,支援詳細的語音風格提示、多種語音選擇以及內嵌情感標籤(如 [whispering]、[excitedly]),讓生成的語音自然且富有表現力。技能會引導使用者在首次回覆時確認 REPLICATE_API_TOKEN,並透過 generation-diversity 技能釐清使用者的語系、語音和腳本需求,確保每次請求都符合最佳實踐。此外,它與 Pruna 生態系中的其他技能(如 p-video、p-video-avatar、narrated-multi-scene)緊密整合,可作為後續影片製作或編輯的音軌輸入。使用者需注意文字與提示的總長度限制(約 8,000 位元組),以及輸出長度上限(約 655 秒);若音軌將用於 p-video 等技能,則建議每段旁白不超過 19 秒,以避免 Pruna API 的 20 秒截斷限制。

相容平台~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/PrunaAI/pruna-skills/tree/HEAD/skills/audio/gemini-3.1-flash-tts

在你喜歡的 AI 中提問

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

說明文件

先決條件

在生成之前請先安裝並載入這些技能(若已透過 @pruna 置入上下文則可跳過):

技能說明安裝方式
generation-diversity當撰寫任何生成式提示詞時使用——在付費 API 呼叫前,使用儀式化種子、明確結構、情境軸線與品質閘門。npx skills add PrunaAI/pruna-skills@generation-diversity -y
audio-prompting當為任何生成式音訊模型設計 TTS、音樂或背景提示詞時使用——導演風格、歌曲結構與後製疊層。npx skills add PrunaAI/pruna-skills@audio-prompting -y
video-prompting當為任何生成式模型設計影片或動態提示詞時使用——戲劇結構、鏡頭、基於物理安全的動態、幀錨點與片段串聯。npx skills add PrunaAI/pruna-skills@video-prompting -y
pruna-api在進行任何 Pruna 或 Replicate HTTP 呼叫前使用——憑證、上傳/輪詢/下載、平行批次與代理安全性。npx skills add PrunaAI/pruna-skills@pruna-api -y

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

請遵循每個技能的 生成前 / 設計章節——不要在此重複指南內容。

代理習慣

在第一個回覆中,以反引號標示 `gemini-3.1-flash-tts`,確認 REPLICATE_API_TOKEN(否則透過 pruna-api 提供的註冊連結停止),然後詢問必要輸入。開啟收件程序 → generation-diversity 澄清收件程序(語系、語音、腳本),然後才進行第一次 POST。當不適合使用的情況更合適時,請引導使用者改用其他技能。

不適合使用的情況

請改用其他技能:

技能說明安裝方式
p-video-avatar當使用者想要一個人在鏡頭前說出台詞時使用——從肖像照片生成的對嘴主播、發言人或敘事頭像。npx skills add PrunaAI/pruna-skills@p-video-avatar -y
music-2.5當使用者想要一首帶有人聲的原創 AI 歌曲時使用——歌唱歌詞、風格提示音軌,或作為音樂影片的原始音源。npx skills add PrunaAI/[email protected] -y
stable-audio-2.5當使用者想要輕柔的器樂背景音樂時使用——對話下的環境氛圍或為 Reels 和解說影片配樂。npx skills add PrunaAI/[email protected] -y

環境變數

export REPLICATE_API_TOKEN=r8_...

當需要修剪、串聯場景配音或混合背景音時,需要 ffmpeg / ffprobe。

HTTP (curl)

curl -s -X POST \
  -H "Authorization: Bearer ${REPLICATE_API_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "text": "[warmly] The plush went flying. [short pause] And then it was gone.",
      "voice": "Sulafat",
      "prompt": "Warm storybook narrator, gentle pace, empathetic, no announcer voice.",
      "language_code": "en-US"
    }
  }' \
  "https://api.replicate.com/v1/models/google/gemini-3.1-flash-tts/predictions"

輪詢 urls.get 直到 status 為 succeeded;下載 output(音訊 URL)。共用客戶端:遵循 pruna-api(工具技能中的 Replicate HTTP 部分)。

生成前

  1. 完成先決條件指南的閱讀順序。
  2. 與使用者確認 text、voice、prompt 和 language_code。text、prompt 和內聯 [tags] 必須一致——具有相同的情感方向(請參閱 audio-prompting 的 tts-style-prompting 章節)。列出欄位時,請指名 REPLICATE_API_TOKEN(Replicate —— 不是 PRUNA_API_KEY)。
  3. **模型注意事項:**合併後的 text + prompt 不超過約 8,000 位元組;輸出上限約 655 秒。當 TTS 音訊作為 p-video 的 input.audio 時,請確保每條音段不超過約 19 秒(使用 ffprobe 檢查)—— P-API 會截斷超過 20 秒 的音訊。常用語音:Kore、Aoede、Sulafat、Achird、Charon、Puck、Vindemiatrix —— 完整列表請參閱 Replicate 說明文件。

必要輸入

  • text (字串) —— 要說的文案;支援內聯 [tags]。最大約 4,000 位元組。

常見選擇性欄位

  • voice (預設 Kore)
  • prompt —— 風格/導演說明(最大約 4,000 位元組)
  • language_code —— BCP-47 格式(預設 en-US)

內聯標籤(範例):[sigh] [laughing] [whispering] [short pause] [medium pause] [long pause] [excitedly]。

典型的後續步驟

使用此技能後常見的後續操作:

技能說明安裝方式
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
stable-audio-2.5當使用者想要輕柔的器樂背景音樂時使用——對話下的環境氛圍或為 Reels 和解說影片配樂。npx skills add PrunaAI/[email protected] -y
narrated-multi-scene當使用者想要一個帶有配音的多部分故事時使用——情節式 B-roll、章節式宣傳片,或幾個連結的影片場景,無需鏡頭前對話。npx skills add PrunaAI/pruna-skills@narrated-multi-scene -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 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 cinematic clip from text or start/end frames — product ads, documentary shots, or dialogue with generated audio. Not for 1080p, imported audio tracks, or talking-head-only hosts.

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.

相關技能