Upload a background
upload_backgroundUpload your own photo or video, or use one of your music videos, to design a New Look around Photo: JPEG, PNG or WebP, at least 720 px on the short side, up to 25 MB. Video: MP4, MOV or WebM, 4–180 seconds, at least 720 px on the short side, up to 300 MB; it becomes a seamless loop of up to 20 s. Only with the rights to use it. Or video_id: one of this workspace's delivered music videos (list_videos with type music-video and the song's song_id), copied in as a video background (no rights_confirmed needed); the answer's music_video names its song and section (trim). preview_url is a still (a photo, or a video's poster) and video_url the video itself (null for a photo), both signed for about a week. A lyric video with it must be of that song: it takes that section (send that trim, or leave trim out), and the music video plays once from its first frame in step with the lyrics, with its own sound. Then quote a lyric video with look {"mode":"new","category":"…","background":{"source":"upload-photo" or "upload-video","upload_id":"…"},"visibility":"private"}. Needs an active plan (402 plan_required without one; get_account: plan.active) and room in its storage (402 storage_full when it would not fit; get_account: storage).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "upload_background"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file_url | No | A public https URL of the photo or video (a file on your computer: create_upload, then its file_url) | |
| video_id | No | One of your delivered music videos, instead of a file: it then plays in step with its song’s lyrics, with its own sound | |
| rights_confirmed | No | You have the rights to use this photo or video (required with a file or file_url) |