SDKs

Official client libraries for the Sonilo API — first-class TypeScript and Python packages, plus companion video kits that mux a generated soundtrack into your video locally with ffmpeg.

JavaScript / TypeScript

The official TypeScript/JavaScript client. Zero runtime dependencies, works in Node.js 18+ and modern browsers.

Install

npm install sonilo

Quickstart

import { SoniloClient } from "sonilo";

const sonilo = new SoniloClient(); // reads SONILO_API_KEY

const track = await sonilo.textToMusic.generate({
  prompt: "cinematic orchestral score",
  duration: 60,
});
// track.audio is a Uint8Array of MP3 bytes

View on GitHub

Companion: video kit

Node-only companion that generates a soundtrack for a video and mixes it in locally with ffmpeg.

npm install sonilo sonilo-video-kit

Python

The official Python client. Python 3.9+, with sync and async clients included.

Install

pip install sonilo

Quickstart

from sonilo import Sonilo

client = Sonilo()  # reads SONILO_API_KEY

track = client.text_to_music.generate(
    prompt="cinematic orchestral score",
    duration=60,
)
track.save("output.mp3")

View on GitHub

Companion: video kit

Python companion that generates a soundtrack for a video and mixes it in locally with ffmpeg.

pip install sonilo sonilo-video-kit