Sonilo Video-to-Music API

Sonilo Video-to-Music

Sonilo Video-to-Music generates music from a video input, with an optional style prompt to guide the soundtrack. It is designed for turning visual content into matching background music for short films, ads, social content, trailers, highlight clips, and other video-driven audio workflows.

Why Choose This?

Video-driven music generation
Generate music that fits the pacing and feel of an uploaded video.
Optional style guidance
Add a prompt to steer the mood, genre, instrumentation, or production style of the generated music.
Simple workflow
Upload one video, optionally add a style prompt, and generate a matching music track.
Supports longer inputs
Works with videos up to 360 seconds.
Production-ready API
Suitable for trailers, branded content, social videos, cinematic edits, and background scoring workflows.

Parameters

Parameter	Required	Description
video	Yes	Input video URL. Maximum supported video length is `360` seconds.
prompt	No	Optional style prompt for the generated music.

How to Use

Upload your video — provide the source video you want to score with music.
Add a style prompt (optional) — describe the mood, genre, instrumentation, or production feel you want.
Submit — run the model and download the generated music.

Example Prompt

Cinematic emotional orchestral score with soft piano, warm strings, slow build, inspiring and modern trailer mood

Pricing

Pricing is based on the uploaded video duration.

Billing Rules

Pricing is $0.009 per billed second
Billing is based on the uploaded video duration
Billed duration is rounded up to the next whole second
Minimum billed duration is 1 second
Maximum billed duration is 360 seconds
prompt does not affect pricing

Example Costs

Video Duration	Cost
1s	$0.009
5s	$0.045
10s	$0.090
30s	$0.270
60s	$0.540
120s	$1.080
360s	$3.240

Best Use Cases

Social media videos — Generate music beds for short-form clips.
Ads and promos — Create matching soundtrack material for branded content.
Trailers and highlights — Add cinematic or energetic music to visual edits.
Creator workflows — Quickly generate background music for uploaded video content.
Prototype scoring — Explore soundtrack directions before final post-production.

Pro Tips

Use a style prompt when you want stronger control over genre, mood, or instrumentation.
Keep the prompt focused and specific for more predictable results.
Shorter videos are useful for quickly testing soundtrack direction before scoring longer content.
Upload the cleanest final or near-final edit possible so the music better matches pacing and structure.

Notes

video is required.
Maximum supported video length is 360 seconds.
Pricing depends only on billed video duration.
Video duration is rounded up to the next whole second for billing.

Related Models

Sonilo audio generation workflows — Useful when you need prompt-first music generation instead of video-driven scoring.
Background music generation workflows — Useful when you need standalone music without a video input.
Video sound design workflows — Useful when you want synchronized effects instead of generated music.

Video To Music API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/sonilo/video-to-music with your input as JSON. The endpoint returns a prediction id. Start polling the result endpoint around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. On completed, read URLs from data.outputs. Examples for Video To Music below.

HTTP example

# Submit the prediction
curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST "https://api.wavespeed.ai/api/v3/sonilo/video-to-music" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "video": "https://example.com/your-input.mp4"
}'

# Wait at least 2 seconds, then poll. Safe GET requests may be retried.
curl --fail-with-body --connect-timeout 10 --max-time 30 \
  --retry 4 --retry-all-errors --retry-delay 1 \
  -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# Start at 2 seconds and increase the interval for long-running tasks.
# Stop on completed, failed, cancelled, or timeout.

Node.js example

// npm install wavespeed
const { Client } = require('wavespeed');

const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
const client = new Client(apiKey);

try {
  const result = await client.run("sonilo/video-to-music", {
        "video": "https://example.com/your-input.mp4"
}, {
    timeout: 3600,
    pollInterval: 2.0,
  });
  console.log(result.outputs);
} catch (error) {
  console.error('Generation failed:', error);
  process.exitCode = 1;
}

Python example

# pip install wavespeed
import os
from wavespeed import Client

client = Client(api_key=os.environ["WAVESPEED_API_KEY"])

try:
    output = client.run(
        "sonilo/video-to-music",
        {
    "video": "https://example.com/your-input.mp4"
},
        timeout=3600.0,
        poll_interval=2.0,
    )
    print(output["outputs"])
except Exception as error:
    raise SystemExit(f"Generation failed: {error}") from error

Video To Music API — Frequently asked questions

What is the Video To Music API?

Video To Music is a Sonilo model for AI inference, exposed as a REST API on WaveSpeedAI. Sonilo Video-to-Music is a fast AI music generation model that creates background music synced to an input video’s mood, pacing, and scene transitions. Ready-to-use REST inference API for video soundtracks, social media content, advertising creatives, cinematic clips, product videos, creator workflows, and professional video-to-music generation with simple integration, no coldstarts, and affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the Video To Music API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID. Poll the result endpoint starting around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. The playground generates production-oriented Python, JavaScript, and cURL examples with timeouts, transient-error handling, and safe GET retries. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/sonilo/sonilo-video-to-music.

How much does Video To Music cost per run?

Video To Music starts at $0.009 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Video To Music accept?

Key inputs: `prompt`, `video`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/sonilo/sonilo-video-to-music.

How do I get started with the Video To Music API?

Sign up for a free WaveSpeedAI account to claim starter credits, copy your API key from /accesskey, then call the endpoint shown in the API tab of the playground. The playground also auto-generates a code sample in Python, JavaScript, or cURL for the parameters you've set.

Can I use Video To Music outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (Sonilo). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.

示例查看全部

相关模型

README