Quote a Canvas
quote_canvasThe exact credits for a Spotify Canvas, before anything is charged Returns quote_id, credits and a breakdown. Always quote first and tell the user the credits before creating; credits are reserved at creation and charged only when the video is delivered.
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>"
},
"name": "quote_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 | |
| 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 |