개발자 문서

예시

오디오 예시

나레이션·음악·효과음을 터미널에서 만듭니다. 음성 읽기 모델은 프롬프트가 곧 읽을 글입니다.

나레이션

ElevenLabs 음성 읽기는 [밝게] 같은 태그를 글 안에 넣어 말투를 정합니다. 태그는 읽지 않습니다.

터미널
aimz generate el_tts --prompt "[밝고 또렷하게] 안녕하세요. 오늘은 조선의 궁궐 다섯 곳을 차례로 둘러보겠습니다." -o ./audio

xAI 음성 읽기는 언어와 속도를 정할 수 있습니다.

터미널
aimz generate xai_tts --prompt "신제품 출시를 알려 드립니다. 이번 주 금요일부터 매장에서 만나 보세요." -p voice=eve -p language=ko -o ./audio
모델목소리 고르기
xai_ttseve · ara · leo · rex · sal
el_ttsElevenLabs 목소리 id — 웹 화면의 목소리 고르기에서 확인

음성 읽기는 글자 수만큼 값이 듭니다. 긴 원고는 aimz estimate 로 먼저 확인하세요.

배경 음악

보컬 없는 배경 음악은 instrumental=true 로 만듭니다. ElevenLabs Music 은 길이를 초로 정합니다.

터미널
aimz generate el_music --prompt "잔잔한 로파이 피아노, 비 오는 카페, 느린 템포" -p duration=90 -p instrumental=true -o ./audio

가사 있는 노래

여러 줄 가사는 JSON 파일로 넘기는 게 편합니다(셸마다 줄바꿈·따옴표 규칙이 달라서). Suno 는 한 번에 두 곡을 돌려줍니다.

song.json
{
  "title": "바다 소리",
  "vocal_gender": "여성",
  "lyrics": "[Verse]\n창문을 열면 파도가 먼저 와\n오늘은 천천히 걸어도 돼\n\n[Chorus]\n바다 소리 따라 노래해\n여름이 끝나기 전에"
}
터미널
aimz generate suno --prompt "밝은 시티팝, 신스와 베이스, 여름 해변" --params-json @song.json -o ./audio
참고
Suno 의 제목·피할 스타일 같은 값은 가사가 있을 때만 반영됩니다. 가사 없이 --prompt 만 주면 Suno 가 가사까지 지어 만듭니다.

효과음

터미널
aimz generate el_sfx --prompt "나무 문이 천천히 삐걱 열린다" -p duration=4 -o ./sfx
aimz generate el_sfx --prompt "처마 끝에 떨어지는 빗소리, 멀리 천둥" -p duration=15 -o ./sfx

효과음은 22초까지 만들 수 있습니다.

영상 하나에 붙일 소리 세트

나레이션·음악·효과음을 같은 --session 으로 만들면 라이브러리에서 한 묶음으로 보여 편집할 때 찾기 쉽습니다. 이 명령들은 모든 셸에서 그대로 실행됩니다.

터미널
aimz generate el_tts --prompt "[차분하게] 작은 항구 마을의 하루는 해가 뜨기 전부터 시작됩니다." --session harbor -o ./harbor
aimz generate el_music --prompt "잔잔한 어쿠스틱 기타와 첼로, 새벽 바다 분위기" -p duration=60 -p instrumental=true --session harbor -o ./harbor
aimz generate el_sfx --prompt "멀리서 들리는 뱃고동과 잔잔한 파도" -p duration=10 --session harbor -o ./harbor