Communitygithub.com

Aseel1600/Edit01

fish.audio (S1/S2-generation 모델)로 감정 표현이 풍부한 다국어 내레이션을 생성하고, reference_id를 통해 복제된 음성을 재사용합니다. 사용자가 fish.audio/Fish Audio TTS를 선호하거나, 특정 플레이그라운드 음성 모델이 필요하거나, 고감성 음성 복제 내레이션이 필요할 때 사용하세요.

Edit01란 무엇인가요?

이 스킬은 Fish Audio의 TTS API를 활용하여 고품질의 감정 표현이 가능한 다국어 내레이션을 생성합니다. S2.1-pro, S2-pro, S1 등 최신 백엔드 모델을 지원하며, 인라인 감정 태그(예: [laugh], [whispers])를 사용하여 문장 중간에 전달 방식을 변경할 수 있습니다. 사용자는 fish.audio 플레이그라운드에서 음성 모델을 생성하고 reference_id로 전달하여 복제된 음성을 일관되게 재사용할 수 있습니다. 특히 S2.1-pro 모델은 80개 이상의 언어와 최상의 감정 표현 품질을 제공하여 영상 내레이션, 오디오북, 다국어 콘텐츠 제작에 적합합니다. 무료 프로모션 모델(s2.1-pro-free)은 2026년 8월 31일까지 $0로 사용 가능하지만, 상업적 사용과 프로덕션 환경에는 제한이 있으므로 최종 결과물에는 유료 모델을 사용해야 합니다. 이 스킬은 OpenMontage와 같은 도구에서 TTSSelector 또는 FishAudioTTS를 통해 직접 호출할 수 있으며, latency, normalize, prosody, temperature 등 다양한 품질 및 지연 시간 튜닝 옵션을 제공합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Aseel1600/Edit01/tree/HEAD/.agents/skills/fish-audio-tts

즐겨 사용하는 AI에게 물어보기

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

문서

fish.audio TTS

.env 파일에 FISH_AUDIO_API_KEY가 필요합니다 (https://fish.audio/go-api/api-keys/에서 생성 가능). fish.audio 플레이그라운드에서 음성 모델을 생성하고, 해당 ID를 reference_id로 전달하여 복제된 음성을 재사용하세요.

현재 API

원시 오디오 바이트를 반환하는 단일 동기 호출:

POST https://api.fish.audio/v1/tts
Authorization: Bearer ${FISH_AUDIO_API_KEY}
Content-Type: application/json
model: <백엔드 모델>     # HTTP 헤더로 백엔드 선택 (예: s1)

백엔드 모델은 본문 필드가 아닌 model HTTP 헤더로 선택됩니다. OpenMontage에서는 도구의 model 입력에 매핑됩니다.

백엔드 모델

model은 필수이며 기본값이 없습니다. 다음 중 하나를 전달하세요:

  • s2.1-pro — 최신 세대. 최고 품질: 인라인 감정 태그, 80개 이상의 언어, 다중 화자. 최고의 내레이션.
  • s2.1-pro-free — 프로모션 s2.1-pro 무료 액세스. 프로모션 기간 동안만 초안, 샘플 및 검증 실행 시 $0. fish.audio 공지에 따라: 2026년 8월 31일까지 무료, 공정 사용(Fair Use) 적용, SLA/지연 시간 보장 없음, 요청이 보관될 수 있음, 상업적 사용 제한. 프로덕션 또는 클라이언트 내레이션에는 절대 사용하지 마세요.
  • s2-pro — 최초 S2 세대. 감정 태그 지원이 포함된 안정적인 고품질.
  • s1 — 이전 주력 모델. 기존 통합과의 호환성을 위해 유지.

과금은 입력 텍스트의 UTF-8 바이트당 (문자가 아님) 부과됩니다. CJK 텍스트와 이모티콘은 동일한 시각적 길이의 ASCII 문자보다 3~4배 더 비쌉니다. 현재 목록 가격: s1 / s2-pro / s2.1-pro = 1M 바이트당 $15, s2.1-pro-free = 프로모션 기간 동안만 $0 (도구의 estimate_cost()는 2026년 8월 31일 이후 유료 s2.1-pro 요금으로 전환됨). 대량 배치 전에 https://docs.fish.audio/developer-guide/models-pricing/pricing-and-rate-limits 에서 현재 가격을 확인하세요.

인라인 감정 태그 (S2 모델 전용)

s2-pro / s2.1-pro / s2.1-pro-free는 텍스트에 포함된 인라인 감정 태그를 해석합니다:

  • [laugh], [whispers] 같은 태그는 문장 중간에 전달 방식을 변경합니다.
  • 예시: "That's hilarious [laugh] but let me explain seriously."
  • s1은 감정 태그를 해석하지 않습니다. 일반 텍스트로 읽힐 수 있으므로 s1을 대상으로 할 때는 태그를 제거하세요.

음성 선택 (reference_id)

  • fish.audio 플레이그라운드에서 음성을 빌드하거나 선택한 다음, 해당 모델 ID를 복사하세요.
  • reference_id로 전달합니다. 선택기의 일반 voice_id가 reference_id가 없을 때 별칭으로 허용됩니다.
  • reference_id가 없으면 fish.audio는 선택한 모델의 기본 음성을 사용합니다.

인라인 즉석 복제(요청당 참조 오디오 + 텍스트 업로드)는 이 도구에서 지원되지 않습니다. 먼저 플레이그라운드에서 음성 모델을 생성하세요.

OpenMontage 사용법

TTS 선택기로 생성:

from tools.audio.tts_selector import TTSSelector

result = TTSSelector().execute({
    "preferred_provider": "fish_audio",
    "text": "복리 이자가 어떻게 모든 빠른 부자 되기 계획을 조용히 이기는지 설명합니다.",
    "model": "s1",
    "reference_id": "<플레이그라운드 음성 모델 ID>",
    "output_path": "projects/my-video/assets/audio/narration.mp3",
})

또는 공급자를 직접 호출:

from tools.audio.fish_audio_tts import FishAudioTTS

result = FishAudioTTS().execute({
    "text": "승인을 위한 짧은 샘플 라인입니다.",
    "model": "s1",
    "reference_id": "<플레이그라운드 음성 모델 ID>",
    "output_path": "projects/my-video/assets/audio/fish_sample.mp3",
})

공급자는 output_path에 오디오를 쓰고 data.output과 함께 확인된 model 및 reference_id를 반환합니다.

품질 및 지연 시간 튜닝

  • latency: normal (기본, 최고 품질), balanced (약간 더 빠름), 또는 low (가장 빠름, 약간의 품질 저하).
  • normalize: 기본 true; 켜두면 숫자, 날짜 및 통화가 자연스럽게 읽힙니다.
  • prosody: 선택적 { "speed": 1.0, "volume": 0 }으로 속도/음량을 조정합니다.
  • mp3_bitrate: 128이 좋은 기본값입니다. 음악이 많이 섞인 믹스의 경우 192로 올리세요.
  • temperature: 기본 0.7. 감정 태그에 의존할 때는 0.9 쪽으로 올리면 더 표현력 있는 읽기가 가능합니다 (권장). 더 안정적이고 예측 가능한 전달을 위해서는 낮춥니다.
  • top_p / repetition_penalty: 일반적으로 기본값(0.7 / 1.2)을 그대로 둡니다.

권장 워크플로우

  1. 전체 유료 내레이션 전에 선택한 model + reference_id로 10~15초 샘플을 생성합니다.
  2. 사용자에게 음성 자연스러움, 감정 및 속도 승인을 요청합니다.
  3. 승인 후에만 전체 내레이션을 생성합니다.
  4. 비용이 중요한 배치/지역화 변형의 경우 s2.1-pro-free에서 프로토타입을 만들고(프로모션 기간 $0, 비상업적 초안 전용) 최종 버전을 s2.1-pro로 업그레이드합니다.

문제 해결

  • 401 Unauthorized: FISH_AUDIO_API_KEY가 잘못되었거나 누락되었습니다.
  • 402 / 결제 오류: 계정 크레딧이 소진되었습니다.
  • 404 / 잘못된 음성: reference_id가 잘못되었거나 이 계정 소유가 아닙니다.
  • 빈/짧은 오디오: text가 비어 있지 않은지, normalize가 전체 입력을 제거하지 않는지 확인하세요.

안전

API 키를 로그, 메타데이터, 패치 또는 프로젝트 아티팩트에 절대 출력하거나 기록하지 마세요. .env.example에는 빈 변수 이름만 포함되어야 합니다.

Individual skills in this repo

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

Aseel1600/Edit01

Generate AI videos from text prompts using multiple provider gateways. Use when: (1) Generating videos from text descriptions, (2) Creating AI-generated video clips for content production, (3) Image-to-video generation with a reference image, (4) Choosing between video generation providers (VEO, Kling, Sora, Runway, Seedance, MiniMax, Gemini Omni). Supports gateways: HeyGen API, fal.ai API, Kling official direct API, and the Gemini API (Gemini Omni Flash).

Aseel1600/Edit01

Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API. Use when: (1) Choosing a specific avatar and voice for a video, (2) Writing exact scripts for an avatar to speak, (3) Building multi-scene videos with different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control.

Aseel1600/Edit01

Use p5.js/canvas for local procedural character effects: particles, weather, squash/stretch, walk cycles, and environmental motion.

Aseel1600/Edit01

Review local character animation with schema checks, Playwright browser previews, frame sampling, and FFmpeg/ffprobe final output checks.

Aseel1600/Edit01

Create videos from a text prompt using HeyGen's Video Agent. Use when: (1) Creating a video from a description or idea, (2) Generating explainer, demo, or marketing videos from a prompt, (3) Making a video without specifying exact avatars, voices, or scenes, (4) Quick video prototyping or drafts, (5) One-shot prompt-to-video generation, (6) User says "make me a video" or "create a video about X".

Aseel1600/Edit01

Generate Mandarin and multilingual narration with Volcengine Doubao Speech 2.0. Use when creating Chinese voiceovers, when the user prefers Doubao/Volcengine/火山引擎/豆包 TTS, or when narration needs character-level timestamp metadata for subtitles.

Aseel1600/Edit01

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Aseel1600/Edit01

Use when implementing Disney's 12 animation principles with Framer Motion in React applications

Aseel1600/Edit01

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). HyperFrames-native: single paused timeline, seek-safe, deterministic.

Aseel1600/Edit01

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

Aseel1600/Edit01

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

Aseel1600/Edit01

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

Aseel1600/Edit01

Audio and media assets for HyperFrames compositions, produced by one shared audio engine (`scripts/audio.mjs`) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound effects (HeyGen audio-library retrieval by default, with local Lyria / MusicGen BGM generation and a bundled SFX library as the no-credential fallback), Whisper transcription, background removal, and caption authoring. Use for voiceover / TTS, BGM, SFX / sound effects, transcription, captions / subtitles / lyrics / karaoke / per-word styling, voice + provider selection, and music-mood prompting.

Aseel1600/Edit01

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, registry discovery, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

Aseel1600/Edit01

Use when the user wants a short, design-led motion graphic where motion is the message: kinetic typography, stat or number count-up, chart/data-viz hit, logo sting, brand lockup, lower-third, callout, social overlay, animated headline/tweet/news item, motion poster, or quick captured-page highlight. Usually under 10s and up to ~30s, with no narration arc, voice-over, or live-action subject. Can render to MP4 or transparent overlay. Not for longer, multi-scene, narrated, or brand-reel pieces (use general-video), narrated website videos (website-to-video), topic explainers (faceless-explainer), product promos (product-launch-video), PR videos (pr-to-video), or captions on existing footage (embedded-captions). When unsure whether it's a quick motion-first piece or a longer / narrated treatment, see /hyperframes.

Aseel1600/Edit01

Use when the user has a music track (an audio file, or a video to pull audio from) and wants a beat-synced HyperFrames video, calm to hard-hitting. The music drives everything: one analyzer reads it once, the orchestrator lays out the frames and fills a per-frame plan, and one sub-agent builds each frame. Typography and templates are the floor — a complete video needs zero assets — but any images or videos the user supplies are cut into the frames on the same beat grid (beat-cut / ken-burns). The genre (lyric video, slideshow, kinetic promo) falls out of the per-frame choices; the pipeline never branches on it.

Aseel1600/Edit01

Best practices for Remotion - Video creation in React

Aseel1600/Edit01

Toolkit-specific Remotion patterns — custom transitions, shared components, and project conventions. For core Remotion framework knowledge (hooks, animations, rendering, etc.), see the `remotion-official` skill.

Aseel1600/Edit01

Port an existing Remotion (React) composition to HyperFrames HTML. Use ONLY when the user explicitly asks to port/convert/migrate/translate a Remotion source. Do NOT use: (a) authoring a new HyperFrames composition; (b) Remotion mentioned in passing; (c) Remotion code shared as reference only; (d) "same video as my Remotion one" without explicit migrate request — treat as fresh build. Doubt → `/general-video`. One-way, Remotion-only: no reverse export (HyperFrames→Remotion or any framework), no non-Remotion source (After Effects, Framer Motion, plain React/CSS) → out of scope, re-create via `/general-video`. Flags unsupported patterns (useState, useEffect, async calculateMetadata, third-party React libs, `@remotion/lambda`) and recommends runtime interop over lossy translation. Unsure whether to port vs. build fresh, or only a passing Remotion mention? → /hyperframes.

Aseel1600/Edit01

Animate SVG character rigs with GSAP, CSS transforms, Remotion frame control, and HyperFrames-compatible browser previews.

관련 스킬