Developer docs
Sonilo API docs for video music, sound effects, and audio ducking.
Use this page as the direct-readable Sonilo API hub. The base URL is https://api.sonilo.com/v1. Authenticate every request with Authorization: Bearer sk_your_api_key.
Endpoint map for agents and developers
Music generation
| Endpoint | When to use it | Reference |
|---|---|---|
| POST /v1/video-to-music | Generate a soundtrack from a video file or URL. Use this when the edit, runtime, pacing, cuts, or final frame should shape the music. | API docs |
| POST /v1/text-to-music | Generate music from a prompt when the product does not have a video asset yet. | API docs |
Sound effects and mixing
| Endpoint | When to use it | Reference |
|---|---|---|
| POST /v1/video-to-sfx | Generate scene-aware sound effects from video timing, motion, objects, transitions, ambience, or short-form visual events. | API docs |
| POST /v1/text-to-sfx | Generate a specific sound effect from a text prompt. | API docs |
| POST /v1/audio-ducking | Mix narration, dialogue, or voice-over with background music so speech remains clear. | API docs |
Operations
| Endpoint | When to use it | Reference |
|---|---|---|
| GET /v1/tasks/{task_id} | Poll async video-to-SFX, text-to-SFX, and audio-ducking jobs until succeeded or failed. | API docs |
| GET /v1/account/services | Check enabled API services before showing generation options in your product. | API docs |
| GET /v1/account/usage | Check account usage and remaining capacity for production monitoring. | API docs |
Commercial-use and pricing signals
Keep API integration, pricing, and rights review together.
Sonilo is strongest when a product already has video and needs fitted music, sound effects, or a narration mix. For production launches, keep the current plan, credit balance, output records, release channel, and commercial-use policy in the same implementation checklist.
Music endpoints stream NDJSON. Video-to-SFX, text-to-SFX, and audio ducking return a task id, then clients should poll GET /v1/tasks/{task_id} until the output is ready.
Related Sonilo resources
API access for developers
Implementation guide for product teams adding video-to-music, SFX, audio ducking, pricing checks, and competitor comparison to a developer platform.
AI music API comparison
Compare Sonilo, ElevenLabs, Mubert, Beatoven.ai, Lyria, Suno, Udio, Stable Audio, and Loudly for API integrations.
Commercial-use licensing
Review how paid Sonilo plans support commercial video, ads, client work, and monetized channels.
Pricing
Check current plan, credit, API access, and commercial-use signals before shipping an integration.