Create a Canvas
create_canvasMake the Canvas a quote priced (spends credits) Send the same request as the quote plus its quote_id. Returns the video ids at once; poll get_video until status is completed. Upload the file in Spotify for Artists. 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
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": {
"song_id": "<song_id>",
"quote_id": "<quote_id>"
},
"name": "create_canvas"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| style | No | Optional visual style | |
| source | No | ai-video (default), ai-image, stock-photo or stock-video | ai-video |
| quality | No | AI video model tier: standard or high | standard |
| seconds | No | Canvas length in whole seconds, 5–8 (default 8). Spotify loops it, so no part of the song is chosen | |
| song_id | Yes | The song id | |
| metadata | No | Your own JSON (an order id, for example): kept with the video and returned in its request. Quote and create with the same value | |
| quote_id | Yes | The quote_id from the matching quote: the request must be identical | |
| stock_id | No | With a stock source: the stock photo or video (search_stock with seconds) to use instead of the director's pick | |
| direction | No | Optional mood, motifs or references | |
| performer | No | A Creator workspace only: the character (list_characters with for_artist_id: one in the song's project's kit or one another project shared) who may appear, with feature_artist auto or always on an AI source. Omitted: the song's artist's character | |
| resolution | No | 1080p (1080×1920) or 720p | 1080p |
| variations | No | 1–4 different Canvases | |
| inspiration | No | Where the idea comes from: song (default; what the song means and how it sounds lead, the colors kept close to the cover, when there is one, so the two sit together in the player) or cover (the cover art's world, colors and motifs, brought to life; a song without a cover always uses song) | song |
| callback_url | No | An https URL to POST the finished video to (signed; see Callbacks). Quote and create with the same value | |
| feature_artist | No | Whether the Canvas shows the artist: auto (the director decides), always or never (AI sources; "always" needs the artist's character: list_characters, start_character makes one) | auto |