CLI
Instalação
Ambos os pacotes instalam o mesmo executável sonilo. Escolha um; instalar os dois colocará dois comandos com o mesmo nome no seu PATH.
Node
npm install -g sonilo-cli
# or run it without installing:
npx sonilo-cli accountPython
pip install sonilo-cliAutenticação
A CLI lê a sua chave a partir do ambiente. Todos os comandos também aceitam --api-key, caso precise substituí-la numa única chamada.
export SONILO_API_KEY=sk-...
# or, per command:
sonilo account --api-key sk-...Comandos
Conta e utilização
# Plan limits, available services, and free-trial quota
sonilo account
# Usage summary (defaults to the last 30 days)
sonilo usage --days 7Música
# Music from a text prompt
sonilo text-to-music --prompt "warm lo-fi piano, rain in the background" --duration 30
# Music matched to a video, written as WAV
sonilo video-to-music --video clip.mp4 --prompt "tense, driving synths" --output score.wav --format wav
# Music that changes style at timed points
sonilo video-to-music --video clip.mp4 \
--segments '[{"start":0,"label":"intro","prompt":"soft solo piano"},{"start":20,"label":"chorus","prompt":"full orchestra"}]' \
--output score.wavEfeitos sonoros
# A sound effect from a text prompt
sonilo text-to-sfx --prompt "glass bottle shattering on concrete" --duration 3
# A sound effect matched to a video
sonilo video-to-sfx --video clip.mp4 --output foley.wav
# Different sound effects for different parts of the video
sonilo video-to-sfx --video clip.mp4 \
--segments '[{"start":0,"end":4,"prompt":"footsteps on gravel"},{"start":4,"end":10,"prompt":"car door slam then engine starts"}]' \
--output foley.wavMúsica e efeitos sonoros juntos
# A music bed and sound effects for one clip, mixed into a single track
sonilo video-to-sound --video clip.mp4 \
--music-prompt "tense strings" \
--sfx-prompt "footsteps, distant thunder" \
--output mix.wav
# Sound effects timed to specific moments, mixed with a music bed
sonilo video-to-sound --video clip.mp4 \
--music-prompt "tense strings" \
--segments '[{"start":0,"end":4,"prompt":"footsteps on gravel"},{"start":4,"end":10,"prompt":"car door slam then engine starts"}]' \
--output mix.wav
# Same, but muxed back into the video
sonilo video-to-video-sound --video clip.mp4 --sfx-prompt "footsteps" --output scored.mp4Tradução de vídeo
# Dub a video into other languages — one file is written per language
sonilo dubbing --video clip.mp4 --languages es,fr --output dubbed.mp4Tarefas assíncronas
# Fetch the current state of an async task
sonilo tasks get <task-id>
# Poll until it finishes
sonilo tasks wait <task-id>Segmentos
Os comandos que aceitam --segments recebem um array JSON numa destas três formas:
--segments '[{"start":0,"label":"intro","prompt":"airy pads"}]' # inline JSON
--segments @segments.json # from a file
--segments @- # from stdinA forma de cada item depende do comando:
music { start, prompt, label? } text-to-music, video-to-music
sfx { start, end, prompt } video-to-sfx, video-to-sound, video-to-video-soundA CLI verifica apenas se cada segmento tem a forma correta antes de o enviar; as regras de tempo são aplicadas pela API, por isso um erro 422 vem de lá — consulte o parâmetro de segmentos de música ou de efeitos sonoros para mais detalhes.
Lista completa de opções
Cada comando documenta as suas próprias flags — caminhos de saída, formatos, durações, idiomas de destino, além de opções de ducking e voz.
sonilo --help
sonilo video-to-music --help