Score a video
score_videoCompose music to a video and, by default, return the video with the music under it.
Tuney finds the picture cuts, speech and sonic logo, then arranges a track to them: the music
ends where the logo starts (or at the end), the turning point lands on the strongest cut in
the middle, hits land on other strong cuts outside speech, and the music is lowered while
people speak in the rendered video.
- prompt: describe the music ("upbeat pop for a sneaker ad"); or cue_id: one of the user's tracks.
- ending: "fade" lands exactly on the length; "short" ends on a stab.
- turning_point_seconds / no_turning_point: override the automatic turning point.
- music_end_seconds / logo_start_seconds: where the music must stop (a sonic logo starts).
- hits: sound effects on strong cuts; render: also return the scored video.
Scoring takes about a minute; if the result says timed_out, call wait_for_task with the
task_id and kind="score_video". The result has the track (preview_url), the plan, and the
video link when rendered. Previews and renders are free; downloading the track costs credits.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"video_id": "<video_id>"
},
"name": "score_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hits | No | ||
| cue_id | No | ||
| ending | No | fade | |
| prompt | No | ||
| render | No | ||
| video_id | Yes | ||
| no_turning_point | No | ||
| music_end_seconds | No | ||
| logo_start_seconds | No | ||
| turning_point_seconds | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||