개발자 도구

당신의 에이전트를 사운드 스튜디오로 만드세요

Q: 어떤 에이전트와 클라이언트를 지원하나요?

Claude에서는 Sonilo를 사용자 지정 커넥터로 추가하고, Codex에서는 Sonilo 플러그인을 설치하세요. 둘 다 명령어 하나로 MCP 서버를 등록할 수도 있으며, Model Context Protocol을 지원하는 다른 클라이언트도 같은 서버를 사용할 수 있습니다. CLI는 Node.js나 Python이 실행되는 곳이라면 어디서든 동작하고, 스킬은 agent skills를 지원하는 모든 어시스턴트에 설치할 수 있습니다.

Q: 요금은 어떻게 되나요?

MCP 서버, CLI, 스킬은 모두 무료입니다. 생성은 API와 동일한 사용량 기반 요금으로 출력 초당 과금됩니다. 자세한 내용은 요금제 페이지를 참고하세요. 셀프서브 계정은 대부분의 제품에 대해 무료 체험 한도를 제공합니다.

Q: 생성된 오디오를 상업적으로 사용할 수 있나요?

네. Sonilo의 결과물에는 상업적 사용 권리가 포함되어 있어 클라이언트 영상, 유료 광고, YouTube, 앱 모두 사용할 수 있습니다.

Q: MCP와 CLI가 API의 모든 기능을 지원하나요?

15개 도구가 음악, SFX, 결합 사운드, 영상 출력 변형, 더킹, 영상 번역 등 모든 생성 엔드포인트와 영상 분석, 자막 교정을 포괄하며, 작업 조회와 계정 조회 기능도 제공합니다. 도구 매개변수로 노출되지 않은 저수준 옵션은 REST API와 SDK를 통해 계속 사용할 수 있습니다.

Q: 영상 번역 같은 비동기 작업은 어떻게 동작하나요?

실행 시간이 긴 생성 작업은 작업 ID를 반환하고 자동으로 상태를 확인합니다. MCP 도구와 CLI는 결과가 준비될 때까지 대기한 뒤 출력 URL을 돌려줍니다. 세션이 만료된 경우, task-recovery 스킬이나 get_generation_task로 완료된 결과를 ID로 가져올 수 있습니다.

Q: 스킬이란 무엇이고 MCP와는 어떤 관계인가요?

스킬은 언제, 어떻게 Sonilo를 사용할지 에이전트에게 알려주는 오픈소스 지침 패키지(github.com/sonilo-ai/skills)입니다. 평범한 언어로 된 요청에 자동으로 반응하며, 내부적으로 MCP 서버(또는 CLI/SDK)를 구동합니다. MCP는 도구를 제공하고, 스킬은 노하우를 제공합니다.

Sonilo를 AI 에이전트에 연결하면 라이선스가 있는 음악, 효과음, 영상 번역을 대화 안에서 바로 생성할 수 있습니다. 에이전트에서 로그인하면 되고, 만들어야 할 API 키는 없습니다.

당신의 터미널을 사운드 스튜디오로 만드세요

Sonilo API 전체를 CLI로 쓸 수 있습니다. 스크립트로 작성하고, 파이프로 연결하고, 어떤 CI 작업이나 Dockerfile에도 넣을 수 있습니다. npm이나 PyPI에서 설치하세요.

에이전트에게 사운드 디자인을 가르치세요

말하는 내용에 따라 자동으로 실행되는 11개의 오픈소스 스킬로 스코어링, SFX, 영상 번역, 더킹을 다룹니다. 에이전트가 스킬을 선택하고, 스킬이 API를 구동합니다.

Claude 커넥터 설정 열기

Claude와 Claude Code 모두에서 작동합니다. 아래 링크를 누르면 커넥터 설정으로 바로 이동합니다.

Claude 커넥터 설정

커스텀 커넥터 추가

이름을 Sonilo로 지정하고 아래 URL을 붙여넣으세요. 저장하세요.

연결하고 로그인하기

연결한 뒤 Sonilo 계정으로 로그인하고, 에이전트에게 영상에 음악을 입혀 달라고 요청하세요. 전체 과정에서 API 키는 전혀 필요하지 않습니다.

Sonilo 플러그인 열기

Sonilo는 Codex 플러그인으로 출시되어 있습니다. 페이지를 열고 추가하세요.

Codex용 Sonilo 플러그인

Sonilo에 로그인하기

안내가 나오면 Sonilo 계정으로 로그인하세요. 전체 과정에서 API 키는 전혀 필요 없습니다.

자연어로 요청하기

Codex에게 영상 음악, 효과음 추가, 다른 언어로의 영상 번역을 요청하세요. 알맞은 Sonilo 도구를 알아서 고릅니다.

CLI 설치

npm이든 PyPI든 명령 하나면 됩니다. 하위 명령과 출력은 동일합니다.

생성

모든 엔드포인트가 서브커맨드입니다. 비동기 작업은 스스로 상태를 확인하며, 당신은 결과 파일만 받으면 됩니다.

설치

한 번의 명령으로 11개 스킬 전부를 호환되는 어시스턴트에 추가할 수 있고, 필요한 것만 선택할 수도 있습니다.

Sonilo 연결

스킬은 지침이고, 스킬이 실제로 구동하는 도구는 MCP 서버가 제공합니다. 서버를 등록한 뒤 한 번 로그인하면 그 자격 증명은 CLI에도 적용됩니다. MCP 호스트가 없다면 CLI를 설치하고 로그인하세요. 스킬이 알아서 CLI로 전환합니다.

채팅에서 요청

스킬을 설치한 에이전트(Claude Code 및 Codex)를 로그인된 상태로 연 다음, 터미널이 아니라 그 채팅창에 입력하세요. 스킬은 평범한 말에 자동으로 반응하므로 도구 이름도 매개변수도 필요 없고, 원하는 결과만 설명하면 됩니다.

text-to-musicvideo-to-musictext-to-sfxvideo-to-sfxvideo-to-soundaudio-duckingauto-dubbingtask-recoveryaccountaudio-playbacksetup-api-key

CLI 하나로 모든 Sonilo 엔드포인트 사용

전체 API를 명령어 하나로. npm과 PyPI에서 설치할 수 있고, 환경 변수 하나만 있으면 되며, JSON으로 응답합니다. 어떤 터미널, CI 작업, Dockerfile에도 넣어서 렌더링 폴더 전체를 일괄 스코어링하거나, 생성 기능을 빌드에 연결하거나, 릴리스를 10개 언어로 번역할 수 있습니다. 비동기 작업은 스스로 상태를 확인하며, 결과 파일만 받으면 됩니다.

16 개 명령어9 개 생성 엔드포인트2 개 패키지--json 모든 명령어에서

셸에서 실행하세요. 모든 터미널, CI 작업, Dockerfile에서 동작합니다.

npmNodenpm install -g sonilo-cli

PyPIPythonpip install sonilo-cli

npx설치 불필요npx sonilo-cli account

sonilo login으로 한 번 로그인하세요. 자격 증명은 MCP 서버와 공유되므로 여기서 로그인하면 둘 다 처리됩니다. CI에서는 SONILO_API_KEY를 설정하세요. 문서 열기 →

실행sonilo video-to-music --video clip.mp4

m4a · 30 sec

실제 출력입니다. Sonilo CLI가 생성했습니다.

평범한 말로 요청하거나 명령어를 실행하세요

12개의 기능과 3개의 계정 도구. 각각 에이전트에게는 MCP 도구 호출 한 번, 셸에서는 명령어 한 줄, 스킬을 설치했다면 그냥 문장 하나로 끝납니다.

musicvideo_to_music

"이 클립에 컷 편집을 따라가는 음악을 입혀줘"

musictext_to_music

"빗소리를 배경으로 따뜻한 로파이 피아노 30초 만들어줘"

musicvideo_to_video_music

"이 클립에 사운드트랙을 추가하고 영상을 돌려줘"

sound effectsvideo_to_sfx

"이 클립에서 일어나는 일에 맞춰 음향 효과를 추가해줘"

sound effectstext_to_sfx

"콘크리트 바닥에 유리병이 깨지는 소리가 필요해"

sound effectsvideo_to_video_sfx

"이 클립에 효과음을 믹싱하고 영상을 돌려줘"

soundvideo_to_sound

"이 클립에 음악과 효과음을 균형 있게 믹싱해줘"

soundvideo_to_video_sound

"이 클립에 완성된 사운드트랙을 입혀서 영상에 합쳐줘"

audioaudio_ducking

"이 음악을 보이스오버 아래로 더킹해줘"

speechdubbing

"이 영상을 일본어와 스페인어로 번역하고 배경 음악은 유지해줘"

speechproofread

"이 클립을 받아쓰고 편집 가능한 일본어와 스페인어 자막을 만들어줘"

videoanalyze_video

"생성하기 전에 이 클립을 보고 음악과 효과음 계획을 세워줘"

get_generation_task

비동기 작업 조회

get_usage

사용량과 할당량

get_account_services

당신의 키로 할 수 있는 일

서로 연결되는 기능

하나의 요청이 여러 도구를 거쳐 처리될 수 있습니다. 에이전트는 요청한 내용에 따라 연결 순서를 정하고, CLI에서는 같은 단계를 순서대로 실행합니다.

컷에 음악 입히고 대사는 선명하게 유지

"이 컷에 음악을 입히고 대사를 음악보다 앞세워줘."

cut.mp4video_to_musicaudio_duckingscored.m4a

여러 언어로 스팟 광고 제작

"사운드트랙을 추가하고, 그다음 일본어와 스페인어 버전도 줘."

spot.mp4video_to_video_musicdubbingspot-ja.mp4 · spot-es.mp4

렌더링 폴더 사운드 디자인

"./renders 안의 모든 클립에 폴리 효과음을 추가해줘."

renders/*.mp4video_to_sfx×12renders/*.m4a

자주 묻는 질문

어떤 에이전트와 클라이언트를 지원하나요?

요금은 어떻게 되나요?

생성된 오디오를 상업적으로 사용할 수 있나요?

MCP와 CLI가 API의 모든 기능을 지원하나요?

영상 번역 같은 비동기 작업은 어떻게 동작하나요?

스킬이란 무엇이고 MCP와는 어떤 관계인가요?

터미널에서 바로 생성을 시작하세요

회원가입 GitHub에서 보기