List videos
list_videosVideos, newest first, with status and thumbnails A page at a time (limit, default 50): next_cursor is null on the last page, otherwise pass it as cursor for the next one with the same filters. counts says how many videos match song_id, artist_id, quote_id and q: all, and by type (lyric_video, canvas, music_video). Each video's outputs carry aspect_ratio, poster_url, poster_seconds and web_url (for thumbnails and previews); get_video has the download links. A video that is waiting has queue: why (plan_limit or render_capacity), its place in line or about how long.
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": "list_videos"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Search the song title, artist name, Look name or video id | |
| type | No | ||
| limit | No | ||
| cursor | No | next_cursor from the previous page | |
| song_id | No | Only this song’s videos | |
| quote_id | No | Only the videos this quote made (none until it is used) | |
| artist_id | No | Only videos of this artist’s songs |