Sag

• 커스텀 API 코드를 작성하지 않고 커맨드라인에서 표현력 있고 고품질의 AI 음성 오디오를 생성하고 싶을 때.
• Clawd와 같은 AI 에이전트가 [whispers], [excited], [sarcastic] 같은 태그를 사용하여 개성과 감정이 담긴 음성 응답을 생성해야 할 때.
• 음성 선택, 언어 정규화, 또는 모델 전환(eleven_v3, eleven_multilingual_v2, eleven_flash_v2_5)이 필요한 TTS 워크플로우를 스크립팅할 때.
• 시스템 음성 대신 프리미엄 ElevenLabs 음성을 사용하는 macOS say의 드롭인 대체제를 원할 때.

• ElevenLabs API 키가 없거나 ElevenLabs 사용 비용을 원하지 않는 경우 — 이 스킬에는 무료/오프라인 대체 수단이 없습니다.
• SSML <phoneme> 지원이 필요한 경우; Sag는 해당 기능을 제공하지 않습니다.
• macOS에서 기본 시스템 수준의 TTS만 필요하고 ElevenLabs 품질이 필요하지 않은 경우 — 내장된 say 명령으로 충분합니다.

eleven_v3(표현력이 풍부, 기본값), eleven_multilingual_v2(안정적, 다국어 지원), eleven_flash_v2_5(빠름) 중에서 선택하여 각 사용 사례에 맞게 품질, 속도, 언어 지원 범위의 균형을 맞출 수 있습니다.

[whispers], [shouts], [laughs], [excited], [sarcastic] 등의 태그를 사용하여 텍스트에 직접 전달 신호를 삽입하세요. 일시 정지 제어는 SSML 대신 [pause], [short pause], [long pause]를 사용합니다.

-v 플래그를 사용하여 이름 또는 ID로 ElevenLabs 음성을 지정하고, ELEVENLABS_VOICE_ID / SAG_VOICE_ID를 통해 기본 음성을 설정하며, sag voices 명령으로 사용 가능한 음성을 탐색할 수 있습니다.

단어를 다시 철자하거나, 하이픈을 사용하거나, 대소문자를 조정하여 잘못된 발음을 수정합니다. --normalize auto|off 플래그는 숫자, 단위, URL을 처리하며, --lang은 언어별 정규화를 안내합니다.

sag prompting을 실행하면 현재 선택된 모델에서 최상의 결과를 얻기 위해 텍스트를 구성하고 형식화하는 방법에 대한 모델별 안내를 확인할 수 있습니다.

-o 플래그를 사용하여 생성된 오디오를 디스크에 직접 저장합니다 (예: -o /tmp/reply.mp3). 이를 통해 AI 에이전트 응답이나 다운스트림 워크플로우에 오디오 파일을 쉽게 첨부할 수 있습니다.

AI 에이전트가 특정 캐릭터로 음성 응답을 생성합니다 — 예: sag -v Clawd -o /tmp/reply.mp3 "[excited] Here's what I found!" — 그런 다음 즉시 재생할 수 있도록 파일 경로를 응답에 포함합니다.

쉘 스크립트에서 텍스트나 문서 내용을 sag에 입력하여 내레이션이 포함된 오디오 파일을 대량으로 생성하고, --normalize auto 옵션을 활용해 숫자와 URL을 깔끔하게 처리하세요.

터미널에서 바로 프로덕션 보이스오버를 확정하기 전에 다양한 ElevenLabs 음성과 전달 스타일([whispers], [sarcastic], [sings])을 빠르게 테스트해 보세요.

eleven_multilingual_v2를 --lang de|fr|es|...와 함께 사용하여 영어 이외의 언어로 올바르게 정규화된 TTS를 생성하세요. 현지화된 콘텐츠 파이프라인에 적합합니다.