Quote a lyric video, a Canvas or a music video
- MCP tool
quote_lyric_video- CLI
kinetune quote lyric-video- MCP tool
quote_canvas- CLI
kinetune quote canvas- MCP tool
quote_music_video- CLI
kinetune quote music-video
Try it with your own API key: it runs on that key's workspace, so a real key reads your real songs, videos and credits. Reads and quotes only; nothing is charged.
The exact credits for a lyric video, before anything is charged
Returns quote_id, credits (total), credits_per_video 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. A quote is valid for 30 minutes.
The 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.
The exact credits for an AI music video, before anything is charged
Returns quote_id, credits and a breakdown; the price follows the section's length (clips of about 15 seconds). The song's artist performs it, so the artist needs photos. Always quote first and tell the user the credits before creating; credits are reserved at creation and charged only when the video is delivered.
AuthorizationBearer <token>An organization API key (kt_live_…) or an OAuth access token
application/json- body
type*unknownsong_id*stringThe song id
1 <= length <= 120variations?integer1–4 different New Looks, one video each (an Existing Look renders one)
1 <= value <= 41callback_url?stringAn https URL to POST the finished video to (signed; see Callbacks). Quote and create with the same value
length <= 2000metadata?Your own JSON (an order id, for example): kept with the video and returned in its request. Quote and create with the same value
look*|{"mode":"existing","id":"look_…"} to reuse a saved Look (add "lyric_style" to render it in another lyric style, at no extra cost), or {"mode":"new","category":"…","lyric_style":"…","background":{"source":"ai-image","quality":"high"},"visibility":"private","direction":"…"} to have one designed (background.source "upload-photo"/"upload-video" with background.upload_id from upload_background designs it around your own media; such a Look stays private. "stock-photo"/"stock-video" with background.stock_id from search_stock uses that stock photo or clip instead of the director's pick). lyric_style (optional, from get_options) sets how the lyrics are presented and animated: block-stack, punch, player, neon, terminal, cinematic… Omit it and the director picks one. background.scenes (2–4, AI image only) makes that many shots of the same world that cut on the song's sections, each priced like the first. background.references "stock" (AI image or AI video, default "none") with feature_artist "always" makes the background one real stock photo of a place the director picks, with the artist put into it and restyled a little for the Look; no extra cost. The singer is left out unless asked: feature_artist "always" (default "never") makes them the subject of the background, recognizable from their artist photos (add_artist_photos); it needs an AI image or AI video background, a private Look and display.cover false (the cover would hide them), and that Look then only serves this artist's songs. A saved Look that shows an artist (featured_artist) only serves that artist's songs, also with display.cover false
aspect_ratios?array<>Formats to render, each its own file: "9:16" (vertical), "16:9" (wide), "1:1" (square)
1 <= items <= 3[ "9:16"]display?Which elements show (title, artist, cover, lyrics, badges, headline) and their sizes. cover must be false to show the artist in the background
{ "title": true, "artist": true, "cover": true, "lyrics": true, "badges": true}trim?Render only this section of the song (at least 8 seconds). Best: a part from get_song_analysis (parts[]: its start and end never cut a word)
curl -X POST 'https://kinetune.com/api/v1/quotes' \
-H 'Content-Type: application/json' \
-d '{
"type": "lyric-video",
"song_id": "string",
"look": {
"mode": "new",
"category": "release"
}
}'