CLI

Gere música, efeitos sonoros e dobragem diretamente do seu terminal. O comando sonilo está disponível como pacote npm e como pacote PyPI — instale o que for adequado à sua configuração.

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 account

Python

pip install sonilo-cli

Autenticaçã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 7

Mú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.wav

Efeitos 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.wav

Mú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.mp4

Traduçã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.mp4

Tarefas 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 stdin

A 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-sound

A 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

Código-fonte