Communitygithub.com

PrunaAI/pruna-skills (음성 나레이션)

음성 해설이나 내레이션이 필요할 때 사용합니다. 설명 영상 트랙, 다큐멘터리 대사, 또는 생성된 비디오와 짝지을 음성을 제공합니다.

pruna-skills (음성 나레이션)란 무엇인가요?

이 스킬은 AI 기반 음성 합성(TTS)을 통해 고품질의 음성 내레이션을 생성하는 스킬입니다. 사용자가 제공한 텍스트를 자연스러운 음성으로 변환하며, 감정 표현, 일시 정지, 말투 변경 등의 인라인 태그를 지원하여 보다 풍부하고 표현력 있는 음성 출력을 가능하게 합니다. Google의 Gemini 3.1 Flash TTS 모델을 기반으로 하며, Replicate API를 통해 호출됩니다. 생성된 오디오는 비디오 편집, 아바타 립싱크, 배경 음악과의 혼합 등 다양한 후속 작업에 활용할 수 있습니다. 이 스킬은 PrunaAI의 다른 스킬들과 연계되어 완전한 멀티미디어 제작 파이프라인을 구축할 수 있도록 설계되었습니다.

지원 대상~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에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

사전 준비 사항

생성 전에 다음 스킬들을 설치하고 로드하세요 (@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-apiPruna 또는 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의 가입 링크와 함께 중단), 필요한 입력을 요청하십시오. 첫 번째 POST 전에 인테이크 열기 → generation-diversity 설명 인테이크 (로케일, 음성, 스크립트)를 수행하십시오. 사용하지 말아야 할 경우가 더 적합한 경우 리디렉션하십시오.

사용하지 말아야 할 경우

대신 다른 스킬을 사용하십시오:

스킬설명설치 명령어
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누군가가 가벼운 기악 배경 음악을 원할 때 사용합니다 — 대화 아래의 앰비언트 배경 또는 릴 및 설명 영상의 언더스코어.npx skills add PrunaAI/[email protected] -y

환경

export REPLICATE_API_TOKEN=r8_...

트리밍, 장면 VO 연결 또는 배경음과 믹싱 시 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 readme를 참조하십시오.

필수 입력

  • 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-롤, 초안, 또는 시작/끝 프레임 애니메이션. 영화 같은 생성, 최고 품질, 정밀한 립싱크, 또는 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누군가가 가벼운 기악 배경 음악을 원할 때 사용합니다 — 대화 아래의 앰비언트 배경 또는 릴 및 설명 영상의 언더스코어.npx skills add PrunaAI/[email protected] -y
narrated-multi-scene누군가가 음성 해설이 포함된 여러 부분으로 구성된 스토리를 원할 때 사용합니다 — 에피소드 B-롤, 챕터별 프로모션, 또는 카메라 대화 없이 연결된 여러 비디오 장면.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.

관련 스킬