Developer tools

Turn your agent into a sound studio

Connect Sonilo to your AI agent and generate licensed music, sound effects, and dubbing right from the conversation. Sign in from your agent; there is no API key to create.

Turn your terminal into a sound studio

The full Sonilo API as a CLI you can script, pipe, and drop into any CI job or Dockerfile. Install from npm or PyPI.

Teach your agent sound design

Eleven open-source skills that auto-trigger on what you say, covering scoring, SFX, dubbing, and ducking. Your agent picks the skill, the skill drives the API.

1

Open Claude Code settings

Open its MCP connector settings. The link below goes straight there.

2

Add a custom connector

Name it Sonilo and paste the URL below. Save it.

3

Connect and sign in

Connect, sign in with your Sonilo account, and ask your agent to score a video. No API key anywhere in the flow.

1

Install the CLI

One command from npm or PyPI, with the same subcommands and the same output either way.

2

Sign in

OAuth opens in your browser. The credential stays on your machine and every command picks it up, so there is nothing to paste and nothing to rotate.

3

Generate

Every endpoint is a subcommand. Async jobs poll themselves, so you just get a file back.

1

Install

One command adds all eleven skills to any compatible assistant, or pick just the ones you need.

2

Connect Sonilo

Skills are instructions; the MCP server is the tools they drive. Register it, then sign in once, and the credential covers the CLI too. No MCP host? Install the CLI and sign in: the skills fall back to it on their own.

3

Ask in chat

Open the agent you added the skills to (Claude Code and Codex), signed in, and type this in its chat rather than a terminal. Skills auto-trigger on plain English, so describe the outcome with no tool names and no parameters.

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

One CLI. Every Sonilo endpoint.

The whole API as one command. It ships on npm and PyPI, takes one environment variable, and speaks JSON. Drop it into any terminal, CI job, or Dockerfile to batch-score a folder of renders, wire generation into a build, or dub a release in ten languages. Async jobs poll themselves, so you just get a file back.

16 commands9 generation endpoints2 packages--json on every command
Run this in your shell. It works in any terminal, CI job, or Dockerfile.
npmNodenpm install -g sonilo-cli
PyPIPythonpip install sonilo-cli
npxno installnpx sonilo-cli account

Sign in once with sonilo login; the credential is shared with the MCP server, so signing in here covers both. In CI, set SONILO_API_KEY instead. Open docs →

Runsonilo video-to-music --video clip.mp4
m4a · 30 sec

Real output, generated by the Sonilo CLI.

Ask for it in plain English, or run the command

Ten generation capabilities plus three account tools. Each one is a single MCP tool call for your agent, a single command in your shell, or just a sentence once the skills are installed.

musicvideo_to_music

“Score this clip so the music follows the cuts”

musictext_to_music

“Make 30 seconds of warm lo-fi piano with rain underneath”

musicvideo_to_video_music

“Add a soundtrack to this clip and give me the video back”

sound effectsvideo_to_sfx

“Add sound effects for whatever happens in this clip”

sound effectstext_to_sfx

“I need a glass bottle shattering on concrete”

sound effectsvideo_to_video_sfx

“Mix effects into this clip and return the video”

soundvideo_to_sound

“Give this clip music and effects in one balanced mix”

soundvideo_to_video_sound

“Full soundtrack on this clip, muxed back into the video”

audioaudio_ducking

“Duck this music under the voiceover”

speechdubbing

“Dub this into Japanese and Spanish, keep the music bed”

get_generation_task

Poll async jobs

get_usage

Spend & quota

get_account_services

What your key can do

Capabilities that chain

One request can move through several tools. Your agent picks the chain from what you asked for; from the CLI you run the same steps in order.

Score a cut, keep the speech clear

“Score this cut and keep the dialogue on top of the music.”

cut.mp4video_to_musicaudio_duckingscored.m4a

Ship a spot in more languages

“Add a soundtrack, then give me Japanese and Spanish versions.”

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

Sound-design a folder of renders

“Add foley to every clip in ./renders.”

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

Frequently asked questions

Start generating from your terminal