Percify APIBackground music for videos
A mood description becomes an original track to sit under a video. For video tools and creators.
- Price
- $0.20 eachwith Lyria 3 Pro
- You send
- a prompt for the track
- You get
- track
How it works
Send a prompt for the track
One POST to /run with the model id and your input. It answers at once with an id.
We run Lyria 3 Pro
$0.20 each. Charged when it starts, refunded by itself if it fails.
Collect a track
GET /generations/{id}?wait=55 returns an original music track, as a file URL. Or pass a webhook and we call you.
3 models for this, by price
Prices are read from the live catalog. Each one opens the playground with this use case filled in.
The request
Filled in with sample files from our CDN, so it runs as it is. Swap in your own URLs.
curl https://api.percify.io/v3/playground/v1/run \
-H "Authorization: Bearer $PERCIFY_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"modelId": "lyria-3-pro",
"input": {
"prompt": "Warm lo fi beat with soft piano, relaxed, 90 bpm, no vocals"
}
}'Full reference in the docs. Every field Lyria 3 Pro takes is on its model page.
Questions
What do I send to background music for videos?
Send a prompt for the track in one POST to https://api.percify.io/v3/playground/v1/run. You get an original music track.
What does it cost?
With Lyria 3 Pro it is $0.20 each (8 credits each). The picks on this page range from $0.125 each to $0.375 each. The estimate call returns the exact price of your input before you run it, and a run that fails is refunded.
Which model should I use?
Budget: Mureka V9 (Song) ($0.125 each). Balanced: Lyria 3 Pro ($0.20 each). Premium: Music 2.6 ($0.375 each). Switching is one string in the request: the model id.
Can an AI agent do this for me?
Yes. Connect your agent to the MCP server at https://mcp.percify.io/mcp and ask for it in plain words. The agent calls the generate tool with the same model id and input shown on this page, and the call spends the same credits.
