Kinetune
Server Details
Lyric videos, music videos and Spotify Canvas loops from your songs, quoted in credits first.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- OAuth
- Works in Glama
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 112 tools
The set has many near-identical workflow clusters: cast_music_video vs draw_music_video_cast vs get_music_video_casting, plan_music_video vs design_music_video_shoot vs render_music_video_lookbook, and quote/create/make/redraw variants for covers. The long descriptions mitigate some confusion, but with 112 tools an agent still faces multiple unclear boundaries around sequencing and presentation versus data retrieval.
Names are consistently snake_case and mostly verb-first with predictable create/get/list/update/delete prefixes. Minor deviations exist, notably cast_music_video vs draw_music_video_cast vs get_music_video_casting, vote_for_idea vs remove_idea_vote, and show/list/get variants for songs, Looks and videos.
112 tools is far beyond the typical 3-15 range and well past the 25+ 'too many' threshold. Even for a broad video-production platform, this surface is extremely oversized and imposes heavy selection overhead.
Coverage is broad: artists, songs, imports, kit pieces, characters, videos, covers, Looks, community ideas, organizations, uploads, stock and face checks all have lifecycle operations. A few gaps remain, such as no obvious delete operation for a kept character and no standalone create_look tool, but core workflows are covered.
Publisher details
- Operator
- Kinetune · Publisher source
- Operator website
- https://kinetune.com
- Vendor relationship
- Unknown
- Documentation
- https://kinetune.com/developers#mcp
- Privacy policy
- Not provided
- Trust center
- Unknown
- Restrictions
- Unknown
Available Tools
112 toolsadd_kit_pieceAdd a kit pieceAInspect
An outfit, place or prop from an image, a link or a stock photo, cropped The kit is what a music video is made from besides the artist’s character: outfits, places and props. Each is in one artist’s kit (owner_artist_id, a project in a Creator workspace; an outfit’s is its artist_id) and serves their songs; shared true offers it to every other artist’s songs too (owner_name says whose it is). Each has a name and an @handle unique in the workspace; a music video brief (direction) that mentions @handle uses that piece exactly as it is, and the director designs the rest. An outfit needs artist_id (its artist's kit); a place or prop goes in owner_artist_id's kit (left out: the workspace's only artist, else its first, shared). shared true offers it to every other artist's songs too (default false). The image is an upload or file_url (JPEG, PNG or WebP, at least 512 px on its short side, up to 15 MB, with rights_confirmed) or a stock_id from search_stock (credited, no rights needed). crop keeps a rectangle of it (fractions; at least 256 px on its short side), for a prop cut out of a bigger photo. handle follows the name (Blue set → blue-set; -2 when taken) unless given. 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).
Inputs: kind (required), name (required), crop, handle, +7 more.
add_song_import_audioAdd the file to a song importAInspect
Give the audio of a released song Kinetune couldn’t fetch The song is made from the file with the release’s title and cover (MP3, WAV or M4A up to 250 MB), and analyzed. For a failed import (or one still queued).
Inputs: import_id (required), audio_url.
archive_artistArchive an artistADestructiveIdempotentInspect
Remove an artist that has no songs Refused (409) while the artist still has songs.
Inputs: artist_id (required).
archive_songArchive a songBDestructiveIdempotentInspect
Remove a song (its videos stay)
Inputs: song_id (required).
cancel_song_importLet a song import goADestructiveIdempotentInspect
Remove a failed (or queued) import from the list Its song isn’t made; it can be imported again later.
Inputs: import_id (required).
cancel_videoCancel a videoADestructiveIdempotentInspect
Stop a queued or processing video (credits released)
Inputs: video_id (required).
cast_music_videoCast a music videoAInspect
The director proposes who else is in it: up to 3 new people, each drawn as a character sheet only after a yes Optional, after the idea and before the lookbook and the shot list (nobody appears on screen without a character sheet). Free (a limited number an hour), a few seconds: returns a casting whose people (at most 3, never more than the model's room in a shot beside the performer and the people already given) each have a role, a first name, what they do (does), a description their sheet is drawn from, and about how many shots they are in. With cast_mode exact, nobody on screen or no room, it proposes nobody (status ready, people []), without a director call. Show each person with price.per_person (price.credits for all); the user may drop anyone, edit a description, or put a kit character in that role instead; then draw_music_video_cast after their yes, or order the video with casting_id to draw them inside the order. Same brief as plan_music_video. Needs an active plan (402 plan_required without one; get_account: plan.active).
Inputs: song_id (required), cast, trim, model, +13 more.
clear_song_lyricsRemove a song’s lyricsBDestructiveIdempotentInspect
Go back to the transcribed words Videos made from then on show the words as transcribed.
Inputs: song_id (required).
create_artistCreate an artistBInspect
Add an artist by name Names are unique per organization (409 when taken). An artist workspace holds one artist: a second one is refused (409) until the workspace becomes a label (update_organization). Works without a plan, so onboarding can add the artist first.
Inputs: name (required), catalog_artist_id, catalog_confirmed.
create_canvasCreate a CanvasAIdempotentInspect
Make 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).
Inputs: song_id (required), quote_id (required), style, source, +11 more.
create_lyric_videoCreate a lyric videoAIdempotentInspect
Make the lyric video 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 (or failed). Each video has one file per format. 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).
Inputs: look (required), song_id (required), quote_id (required), trim, +5 more.
create_music_videoCreate a music videoAIdempotentInspect
Make the music video 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. It takes about 5 minutes for a minute of song, longer for the whole song. 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).
Inputs: song_id (required), quote_id (required), cast, test, +25 more.
create_organizationCreate an organizationAInspect
A new organization owned by you, with its own music, videos, Looks and credits Creates an empty organization (a workspace, in the app) with the signed-in person as its owner; with an API key, the member who created the key (the key needs organizations:write). type artist is for one artist (add that artist next with create_artist; its songs then need no artist_id), label for a roster. It starts with no plan and no credits, so nothing can be created in it until it has one. These credentials keep acting for their current organization: to work in the new one, sign in again and pick it, or create an API key in it.
Inputs: name (required), type (required).
create_songUpload a songAInspect
Add a song: master audio, and square cover art if it has one Audio: MP3, WAV or M4A up to 250 MB. Cover (optional): a square JPEG or PNG, 1000–6000 px (3000×3000 recommended), up to 20 MB; it is kept at 1536, 640 and 160 px, not as uploaded. Without one the song has no cover (cover_art null) and every video still works; set_song_cover adds one later. The song is analyzed next (lyrics, beats, sections): poll get_song until analysis.status is "ready", usually about a minute. Pass lyrics (or set them later with set_song_lyrics) to have the videos spell every word right. The file’s tags fill what is left out: its title, ISRC, embedded lyrics and embedded cover (a square one, 1000 px or more). The same song already in the workspace (the same audio file, or the same ISRC) is refused with 409, code duplicate, and its song_id. A released song of a linked artist can be imported instead of uploaded (import_songs). 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).
Inputs: title, lyrics, language, artist_id, +3 more.
create_uploadSend a file from your computerAInspect
A signed upload URL for a local file, and the file_url to use it For an agent that has a file on the person's computer but can only pass URLs (the CLI sends files itself): returns upload_url, where you PUT the file's bytes within an hour with the headers given, e.g. curl -X PUT -H "content-type: image/png" --upload-file desk.png "<upload_url>"; then pass file_url in any *_url field within a day: create_song (audio_url, cover_art_url), add_kit_piece (file_url), start_character (photo_urls), upload_background (file_url), set_artist_image (image_url). That field checks the file like an upload (format, size, rights) and keeps its own copy; this one is deleted after a day. size_bytes must be the file's exact size (up to 300 MB), content_type its type. Up to 100 files a day; without a plan, only a free song's audio and cover.
Inputs: filename (required), size_bytes (required), content_type (required).
delete_coverDelete a coverADestructiveIdempotentInspect
Deletes one of the song’s covers for good Its files go too. Deleting the cover in use leaves the song without one (409 song_busy while a video of the song is being made). Ask the user first.
Inputs: song_id (required), cover_id (required).
delete_kit_pieceDelete a kit pieceBDestructiveIdempotentInspect
Remove an outfit, place or prop A plan that used it can’t be made any more: plan again.
Inputs: kit_id (required).
delete_lookDelete a LookADestructiveIdempotentInspect
Remove one of your Looks (videos made with it stay)
Inputs: look_id (required).
delete_music_video_castingDelete a castingADestructiveIdempotentInspect
Deletes a casting; the people already kept stay in the kit Not while its people are drawn (409).
Inputs: casting_id (required).
delete_music_video_lookDelete a music video LookBDestructiveIdempotentInspect
Removes the workspace's own Look (its reward goes back if it was public)
Inputs: look_id (required).
delete_music_video_lookbookDelete a lookbookADestructiveIdempotentInspect
Deletes a lookbook nothing was made from, with its pictures Only a lookbook no shot list or video was made from (those keep theirs: 409), and not while its pictures are drawn (409). Pictures already drawn are not refunded.
Inputs: lookbook_id (required).
delete_music_video_planDelete a shot listADestructiveIdempotentInspect
Deletes a shot list no video was made from, with every draft of it Deletes the shot list with the drafts it was rewritten from and into, and their drawn frames. One a video was made from (or a delivered video's revision) stays with it: 409.
Inputs: plan_id (required).
delete_videoDelete a videoADestructiveIdempotentInspect
Delete a finished video and its files
Inputs: video_id (required).
design_music_video_shootDesign a music video lookbookAInspect
The director designs the outfits, places and props the brief leaves to it as pictures, before the shot list Optional, before the shot list (plan_music_video). Free to design (a limited number an hour), about a minute: returns a lookbook whose pieces are the brief's own kit pieces (yours, used as they are) and the director's designs (an outfit drawn on the artist, a place drawn empty, a prop alone), not drawn yet. price.draw.credits is what drawing them costs: tell the user, then render_music_video_lookbook after their go. Same brief as plan_music_video. 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).
Inputs: song_id (required), cast, trim, model, +13 more.
discard_character_requestDiscard a character in the makingCDestructiveIdempotentInspect
Deletes its uploads and sheet
Inputs: request_id (required).
draw_character_sheetDraw a character sheetAInspect
Draws the sheet for the credits shown (again with a note to redraw) From photos, a description (mode describe), or an added sheet drawn again as a plain base sheet (nothing worn or held beyond one plain outfit). credits must be price.credits from get_character_request: tell the user first. outfit: the base outfit line as the user left it (always drawn plain: one top and fitted trousers or skirt, solid colours, barefoot, no jewellery). note: what to change when drawing again ("her hair is shorter"). Charged only once the sheet passes its check (one person, a clear face, no text); a failed check is redrawn once at no charge. Needs an active plan (402 plan_required without one; get_account: plan.active).
Inputs: credits (required), request_id (required), note, outfit.
draw_music_video_castDraw a music video's castAInspect
Draws the people the user kept as character sheets (spends credits) Only after the user's yes to the people and the price. people: the ones kept, by index (the others are declined), each with an edited name or description if the user changed it, or character: a kit character's handle (list_characters) in that role instead, free. An empty list keeps it to the artist (nobody else is cast). credits must be price.per_person times the people drawn (0 when none is); another price answers 409 with the current one. Each description is read first like start_character's describe mode (one made-up adult, never a real or famous person: 422 naming the person's index). One hold for all; each sheet is drawn plain (base clothes, the person only: the video dresses them later), charged once it passes its check, and kept in the song artist's kit as AI-made, not shared. Poll get_music_video_casting until ready, then add people_for_brief to people. Needs an active plan (402 plan_required without one; get_account: plan.active).
Inputs: people (required), credits (required), casting_id (required).
draw_music_video_frameDraw an opening frameADestructiveInspect
Draws the picture a planned shot opens on (spends credits) Paid per picture: tell the user the price (list_music_video_frames: price.credits) and draw only after their go, then show them the picture (image_url). Drawing a shot again replaces its frame (the earlier picture is gone) for the same price. Good for the shots that matter most (the opening, the hook); the others are made from their references as usual. credits is the price the user agreed to; another price answers 409 with the current one. Takes about a minute; nothing is charged if it fails. 400 with the reason for a shot that can't have one (list_music_video_frames: unavailable). Then quote_music_video and create_music_video with the plan_id as usual. 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).
Inputs: shot (required), credits (required), plan_id (required).
draw_place_anglesDraw other angles of a placeAInspect
The same set from three-quarter, side or low, each a new place (spends credits) A place only. Without confirm: the price (credits per angle and the total), nothing drawn; tell the user, then send confirm true after their go (and credits: the total shown; a different price answers 409 with the current quote). Each angle is one picture of the same place, its layout, props, colours and light, from another side, empty of people, drawn in about a minute; it comes back as a new place in the same artist's kit (owned and shared like the place), named " · side", with angle_of (the first place of its set) and angle. A new angle is pending: the user keeps it (update_kit_piece with kept true) or leaves it out (delete_kit_piece); a brief can mention it once kept. A brief that mentions places of one set gets them as one set: the director cuts between the angles. Credits are held, then charged for each picture drawn (failed lists any that couldn't be, not charged). 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).
Inputs: kit_id (required), angles, confirm, credits.
edit_song_briefCorrect a song’s briefAIdempotentInspect
Rewrite what the song is about, in the user’s words The brief (get_song: brief) is what every director reads before making anything for the song: its theme, the story under it, how the feeling moves through its sections (mood_arc), the setting it evokes and its tone. When it reads the song wrong ("it’s about my father, not a breakup"), send the fields to change; the others stay. mood_arc replaces the whole list (a section with an empty feeling is dropped); null or "" clears tone, story or setting; theme can’t be emptied. Plain text, on one line each. The correction is the user’s: brief.edited is true, every video, Canvas and cover made from then on reads it, and nothing replaces it (new lyrics or a new analysis keep it) until rewrite_song_brief. 409 while a song without a brief yet is sent no theme.
Inputs: song_id (required), tone, story, theme, +2 more.
find_artist_in_catalogFind an artist’s released songsARead-onlyIdempotentInspect
Search the music catalog for an artist by name, to link their released songs The public music catalog (Apple Music’s; no account or login): each match with its id, name, song_count, newest_release and up to five covers of their releases (picture_url, covers), so the user can tell which profile is theirs. Search by the full name they release under (exact matches only), or pass their Apple Music artist link. Then link_artist with the id the user confirms. Only for the user’s own music: they must own or have the rights to the songs they bring in.
Inputs: q (required).
follow_ideaFollow an ideaBIdempotentInspect
The person hears by email when it ships Sent under the Product news email topic (the person can switch it off in the app).
Inputs: idea_id (required).
get_accountGet the accountARead-onlyIdempotentInspect
Who you are signed in as, the organization (workspace) and its credit balance Returns the organization the credentials act for (the workspace, as the app calls it; type artist holds one artist, label a roster, creator projects), how they authenticate and their scopes, the credit balance (available, monthly, top-ups) and its plan, if any: active says whether it lets the workspace create (without an active plan, creating answers 402 plan_required), storage (used_bytes against limit_bytes: an upload or new video that does not fit answers 402 storage_full, and deleting videos or archiving songs frees space at once), where it is billed, when the period ends, and a downgrade or interval switch waiting for the renewal as scheduled_change. Without a plan, free_song says where the person's one free song stands (signed in as them, never with an API key, where it is null, as it is with a plan): available (upload one song now, with create_song; it plays in the Looks), unverified (they confirm their email first), used (its song_id and title, and video: available true while its one free video is still to make, video_id once it is) or taken (it went to another workspace or account). The free video is a lyric video of the free song with an existing Look (look.mode existing) in one aspect ratio, of at most 60 seconds of it (a trim: a part of a longer song), quoted and created as usual: it holds no credits; anything else answers 402 plan_required. Monthly credits reset every month; top-ups never expire. On the organization, image_url is the picture uploaded for it (null without one); while it has none, image_fallback is the cover of its newest song still there that has one (song_id, preview_url 640 px and thumbnail_url 160 px WebP), to show in its place, or null without such a song. It is read-only, never saved as the picture, and follows the newest song (a new song or an archived one changes it). Check it before creating anything.
Inputs: no named parameters.
get_artistGet an artistBRead-onlyIdempotentInspect
One artist, with their song count and picture image_url is the picture uploaded for it (null without one); while it has none, image_fallback is the cover of its newest song still there that has one (song_id, preview_url 640 px and thumbnail_url 160 px WebP), to show in its place, or null without such a song. It is read-only, never saved as the picture, and follows the newest song (a new song or an archived one changes it).
Inputs: artist_id (required).
get_character_requestGet a character in the makingBRead-onlyIdempotentInspect
What was read from the photos, the outfit line, the sheet as drawn status: analyzed (problem says what stops it, if anything), drawing (about a minute), drawn (a sheet to keep: sheet.url), failed. price.credits is what drawing costs now; charged is what the drawn sheet cost. extras, on an added sheet: what keeps it from being a plain base (jewellery, glasses, a hat, something held); draw_character_sheet draws it again as a base sheet.
Inputs: request_id (required).
get_cover_requestGet a round of coversBRead-onlyIdempotentInspect
Each idea with its cover once drawn status: queued, drawing (covers appear as they are drawn), drawn, or failed (nothing charged; error says why). covers[].status: drawing, ready (cover: the cover kept on the song) or failed (it failed its check twice; not charged). credits: what the round cost.
Inputs: request_id (required).
get_face_checkGet a face checkARead-onlyIdempotentInspect
Whether a model can show this real person yet: their face check for it Some models (get_options: music_video.models[].face_check) show a real person only once they have proved, live on camera, that the face on the character is theirs: a Kinetune face check, done once and covering every model that shares it. status: not_needed (the model needs none, or the character is AI-made: ai_made); not_checked; waiting (a check started in the last 30 minutes); passed; failed (the last one didn't pass: start another). Asked before quoting such a model for each real person in it (the performer and the people).
Inputs: model (required), character_id (required).
get_ideaGet an ideaBRead-onlyIdempotentInspect
One idea with its comments and Kinetune's word on it status_note is the team's word on its status. An idea merged into another answers with that one. People appear by name and picture only.
Inputs: idea_id (required).
get_kit_pieceGet a kit pieceCRead-onlyIdempotentInspect
One outfit, place or prop
Inputs: kit_id (required).
get_lookGet a LookBRead-onlyIdempotentInspect
One Look with its design and preview images backgrounds.portrait and backgrounds.landscape are the background plates the video uses; backgrounds.previews has 480 px wide copies of them for thumbnails (null for a Look without a photo or video background).
Inputs: look_id (required).
get_music_video_castingGet a castingARead-onlyIdempotentInspect
A casting's people as proposed, then as drawn status: proposed (not drawn), drawing (their sheets are drawn: check back in about a minute), ready or failed. Each person: index, name, role, does, description, shots, state (proposed, declined, drawing, kept: drawn and in the song artist's kit; chosen: a kit character in that role; failed, with error) and character once kept or chosen. price.per_person is a sheet's price; charged is what was spent. people_for_brief, once ready: the {character, does} entries to add to people in plan_music_video, design_music_video_shoot and create_music_video.
Inputs: casting_id (required).
get_music_video_lookGet a music video LookARead-onlyIdempotentInspect
One music video Look With the video it was saved from while that video is public in the Showcase: video (its song_title, aspect_ratio, the artist and creator as the Showcase credits them, poster_url, video_url, poster_seconds, duration_seconds) and story (the director's idea as concept, and its shots along the song: section, start_seconds, end_seconds, summary). Both are null while the video isn't public. Never its maker's written brief.
Inputs: look_id (required).
get_music_video_lookbookGet a lookbookARead-onlyIdempotentInspect
A lookbook with its pictures as they are drawn status is proposed (not drawn), rendering (being drawn: check back in about a minute), ready or failed. Each piece has its picture (image_url) once drawn, kept (true unless left out) and whether it is yours. price: per picture, to draw the rest (draw) and to redesign the director's pieces (redesign).
Inputs: lookbook_id (required).
get_music_video_planGet a music video planCRead-onlyIdempotentInspect
A plan made earlier
Inputs: plan_id (required).
get_optionsList the optionsBRead-onlyIdempotentInspect
Video types, Look categories, background sources, formats and the current credit prices Everything a request can choose from, with the credit table (plans and credit_packs: the plan catalog the app shows, each plan's monthly credits, limits, features and shelf, its prices in cents and the app's highlighted one, and each pack's credits and price; reference only, nothing is bought through the API; music_video.categories: each kind, with demos, the real music videos of it Kinetune chose: one per model (model: its id) and a fallback (model null) for a model without its own; each with sound in video_url, a few silent seconds from its poster moment hover_seconds in hover_url, its poster in still_url, made_with: the model and quality it was made with, and story: its brief, the director's idea and its shots; signed for about a week. Show the one for the model in hand, else the fallback; demo is the fallback alone, as before. music_video.styles: each visual style (how the video is rendered), with its one picture: image_url (512 px square WebP) and thumbnail_url (160 px); its demo and demos are deprecated (still given until 2027-05-05: use image_url). music_video.models[].guide: what each model is best for (best_for), its strengths and weaknesses, the kinds it suits, its sharpest resolution (max_quality), public benchmark scores (board, entry, score, source, url, date) and page_url, the page comparing them; music_video.categories[].recommended_model: the offered model to suggest for that kind when the person hasn't named one. The catalog is set by Kinetune's admins and can change; a subscription keeps what it was bought with. credits.character_sheet: what drawing one character sheet costs now (draw_character_sheet). credits.cover: what a round of covers costs now, counts by how many (1 to 4), and redraw, one cover redrawn with a note (make_cover, redraw_cover). credits.examples: what a lyric video of a song_seconds song costs now in one 9:16 format, by how its Look is made (saved_look, new_look, new_look_ai_video), and clips: the same for the parts of a song people post (seconds: 15, 30, 60). Use it to pick a category or source and to explain prices.
Inputs: no named parameters.
get_songGet a songCRead-onlyIdempotentInspect
One song and its analysis status cover_art.url is the cover at up to 1536 px (JPEG; width and height describe it), preview_url a 640 px and thumbnail_url a 160 px WebP; cover_art is null for a song without cover art (it is optional). Image links are signed for 7 days and stay the same all day, so they can be cached. analysis.lyrics.status says whose words its videos show: "transcribed" (as heard), "checked" (your lyrics, timed from the audio; corrected, added and kept count what checking did), "waiting" (your lyrics, checked once the analysis finishes) or "mismatch" (your lyrics didn’t match what’s sung, so the transcription is used). brief: what the song is about as every director reads it (theme, tone, story, mood_arc by section, setting), null before the analysis; status writing while it is written (a song analysed without one has it started by this call: get it again in half a minute), edited true once the user corrected it (edit_song_brief).
Inputs: song_id (required).
get_song_analysisGet a song’s analysisARead-onlyIdempotentInspect
Word-timed lyrics, tempo, beats, sections, hook and the parts a video can be cut to parts lists where a video can start and end without cutting a word: each section (Verse 1, Chorus 1…), clips of about 15 seconds cut between the lines of long sections (kind "clip", parent: its section) and each verse with the chorus after it (kind "pair"); pass a part’s start and end as a video’s trim (start_seconds, end_seconds), picking one at least as long as the video type’s minimum (a lyric video 8 seconds, a music video 15). default_part is the one the app starts on: the sung part nearest 15 seconds. lyrics.text is the song’s lyrics to edit: yours as you gave them, or the transcription a line per phrase (lyrics.yours says which). The analysis also listens for who sings: map.voices lists where someone other than the lead artist sings (voice "other": another solo voice; "group": a choir, a crowd or backing singers), and those words carry backing: true (music videos keep them off camera, never lip-synced by the artist); map.instrumental is true when no vocals were heard. A song analyzed before voices were heard has no map.voices until its first music video plan listens to it.
Inputs: song_id (required), min_seconds.
get_song_importGet a song importBRead-onlyIdempotentInspect
One import: queued, fetching, done (with its song) or failed (and why)
Inputs: import_id (required).
get_videoGet a videoBRead-onlyIdempotentInspect
Status, progress, credits and, when completed, the download links status is queued, processing, completed, failed or cancelled. While it waits, queue says why: plan_limit (the organization already makes as many videos at once as its plan allows; position is its place in line) or render_capacity (every render machine is busy; estimated_wait_seconds is about how long). Completed videos have outputs with download_url (full quality), web_url (720p) and poster_url, signed for 7 days. A lyric video's poster is a frame with one whole lyric line on screen (the hook when it can be), ready to set as the thumbnail where you post it; a Canvas's is its first frame; a music video's a frame of its first seconds. poster_seconds says where in that file the poster was cut, for posts that take a cover frame offset instead of an image (TikTok); null on videos made before it was kept. Failed videos have error and error_code; AI_VIDEO_UNAVAILABLE means the AI video couldn’t be made for a reason on our side, so make it again later.
Inputs: video_id (required).
import_songsImport released songsAInspect
Bring in released songs of a linked artist by their track ids, without uploading Each track (list_released_songs: id) becomes an import: Kinetune fetches the song’s audio (about half a minute each), then the song is made with the release’s title and cover and analyzed like an upload; poll get_song_import or list_song_imports (status queued, fetching, done with song_id, or failed with why). A song we can’t fetch fails, and the user adds the file to it instead (add_song_import_audio). Songs already in the workspace or being imported are skipped (skipped: track_id and reason). Up to 50 at once, and a daily number per workspace (429 daily_limit). Only the user’s own songs: confirm they own or have the rights to them. 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). Without a plan, the user’s free song covers one import.
Inputs: artist_id (required), track_ids (required), distinct_track_ids.
keep_characterKeep a characterADestructiveInspect
Keeps the sheet in the kit, as an artist or as named cast artist_id: it is that artist (one each, in their own kit; replace true takes the place of theirs); or name: cast, with an @handle from the name (or handle), in owner_artist_id's kit (left out: the workspace's only artist, else its first, shared). shared true offers them to every other artist's videos too (default false). ai_made: ask the user whether this is an AI-made person who looks like no real person, or a real person (false: a model that needs a face check shows them once they pass it); never guess it. Left out, they count as real. The uploads are deleted, and replace true deletes the artist's current character for good.
Inputs: request_id (required), name, handle, shared, +4 more.
keep_music_video_lookbook_pieceKeep or leave out a lookbook pieceCIdempotentInspect
Whether a piece goes into the video
Inputs: kept (required), piece (required), lookbook_id (required).
link_artistLink an artist to their released songsAIdempotentInspect
Set the artist’s catalog profile, once: their released songs are then listed to import Available to Artist and Label workspaces. Send catalog_artist_id from find_artist_in_catalog with catalog_confirmed=true after the user confirms they manage the selected profile. The artist names must match exactly. Also sets their Apple Music link (links.apple_music) unless one is set. Linking again replaces it; unlink with update_artist catalog_artist_id null. Then list_released_songs and import_songs.
Inputs: artist_id (required), catalog_artist_id (required), catalog_confirmed.
list_artistsList artistsARead-onlyIdempotentInspect
Artists by name, with their song counts and a picture Songs belong to an artist; create the artist first. Sorted by name, 50 per page by default: pass q to search by name, and limit/offset to page. image_url is the picture uploaded for it (null without one); while it has none, image_fallback is the cover of its newest song still there that has one (song_id, preview_url 640 px and thumbnail_url 160 px WebP), to show in its place, or null without such a song. It is read-only, never saved as the picture, and follows the newest song (a new song or an archived one changes it).
Inputs: q, limit, offset.
list_character_requestsList sheets waiting to be keptARead-onlyIdempotentInspect
Photos read and ready to draw, character sheets being drawn, or drawn and paid for but not kept yet Newest first. Photos read and ready to draw (status analyzed, nothing charged yet) wait a day; a sheet drawn and paid for waits 30 days to be kept (keep_character), then is deleted; one being drawn shows status drawing.
Inputs: no named parameters.
list_charactersList charactersBRead-onlyIdempotentInspect
The people videos can show: your artists' characters and your cast Each character is one sheet in the kit (a front close-up, full body front, three-quarter, profile and back, in a plain base outfit), made with start_character. artist_id set: it is that artist (one each); otherwise cast, used by its handle. Each is in one artist's kit (owner_artist_id, owner_name; an artist's character is in their own) and appears in their videos; shared true offers it to every other artist's videos too (update_kit_piece shares it). outfit is the base outfit line it was drawn in; missing lists the views an added sheet doesn't show.
Inputs: artist_id, for_artist_id, owner_artist_id.
list_ideasList ideasARead-onlyIdempotentInspect
The Community board's ideas, most voted first, with your vote and follow Everyone's ideas for Kinetune, a page at a time (limit, default 30): next_cursor is null on the last page, otherwise pass it as cursor with the same filters. Before suggesting an idea, search for it (q) and vote for the one that is already there. status: one status, or open for every open one (under_review, planned, in_progress); yours true: ones the person suggested or voted for. counts says how many match area and q, by status. Each idea has its votes, voted and following (the person's), and its author by name only.
Inputs: q, area, sort, limit, +3 more.
list_kitList the kitARead-onlyIdempotentInspect
Outfits, places and props a music video brief can mention The kit is what a music video is made from besides the artist’s character: outfits, places and props. Each is in one artist’s kit (owner_artist_id, a project in a Creator workspace; an outfit’s is its artist_id) and serves their songs; shared true offers it to every other artist’s songs too (owner_name says whose it is). Each has a name and an @handle unique in the workspace; a music video brief (direction) that mentions @handle uses that piece exactly as it is, and the director designs the rest. With artist_id: what a brief for their song can mention, their own pieces first, then those other artists shared; with owner_artist_id: only their own (their kit page); without either, every piece. url is the piece cropped, up to 1536 px (what the AI receives; width and height describe it), thumbnail_url a 320 px copy, source_url the image the crop is a rectangle of. Every piece by default; pass q to search by name, @handle or description, and limit/offset to page. total is how many pieces match.
Inputs: q, kind, limit, offset, +2 more.
list_looksList LooksARead-onlyIdempotentInspect
Browse Official, Community and your own Looks A Look is a complete, reusable lyric-video design. Pass its id as {"mode":"existing","id":…} to reuse it exactly. A Look that shows an artist (featured_artist) is private and only serves that artist's songs: choosing for a song, pass its artist_id to leave out Looks that show another artist.
Inputs: q, sort, limit, scope, +4 more.
list_music_video_draftsList music video draftsARead-onlyIdempotentInspect
A song's music videos in the making: shot lists not made yet and lookbooks not used yet The latest draft of each shot list of the song that no video was made from, and the lookbooks no shot list was written from, from the last 30 days, newest first. Pick one up with get_music_video_plan or get_music_video_lookbook.
Inputs: song_id (required).
list_music_video_framesList a plan's opening framesARead-onlyIdempotentInspect
The opening frames drawn for a plan's shots, and the price of one more Optional, for users who want control over key shots: an opening frame is a picture of the moment a shot opens on (its people, outfit and place, in the video's format), and the video then starts that shot from it, on every model. Returns frames (shot, image_url, thumbnail_url; signed for 7 days), price.credits (what drawing one more costs) and unavailable (shots that can't have one, with the reason: a shot that carries straight on from the one before, or a real person shown with others to Seedance). A frame stays with its shot across drafts while the shot is unchanged, and is never part of the video's quote. 404 when frames aren't offered.
Inputs: plan_id (required).
list_music_video_looksList music video LooksBRead-onlyIdempotentInspect
Music video Looks made public, and the workspace's own scope: all (default), community (public ones) or mine. A Look carries category, style, takes, lipsync, a treatment and its places and props (pieces); pass its id as look_id with those choices.
Inputs: q, sort, limit, scope, +1 more.
list_organizationsList your organizationsARead-onlyIdempotentInspect
The organizations you belong to, your role in each and the one these credentials act for Every organization (workspace, in the app) the signed-in person is a member of; with an API key, the member who created it (the key needs organizations:read). type is artist (one artist and its songs), creator (projects: the same records as artists, a performer optional) or label (a roster of artists). current marks the organization these credentials act for. image_url is the picture uploaded for it (null without one); while it has none, image_fallback is the cover of its newest song still there that has one (song_id, preview_url 640 px and thumbnail_url 160 px WebP), to show in its place, or null without such a song. It is read-only, never saved as the picture, and follows the newest song (a new song or an archived one changes it). Each organization has its own plan, music, videos, Looks and credits: to work in another one, sign in again and pick it on the consent screen, or use an API key created in it.
Inputs: no named parameters.
list_released_songsList an artist’s released songsARead-onlyIdempotentInspect
The linked artist’s songs in the music catalog, each saying whether it is already in Kinetune Newest release first; an EP or album’s tracks in order. Each has id (the track_id to import), title, release (name, kind single, ep or album, date; a date of null is announced, not out yet), track_number, duration_seconds, cover_url (up to 3000 px), song_id when it is already in the workspace, possible_duplicates for close title and duration matches, and import while it is being imported (status, error). q narrows them to a title or release. The artist must be linked first (409 artist_not_linked: find_artist_in_catalog, then link_artist).
Inputs: artist_id (required), q.
list_song_coversList a song’s coversARead-onlyIdempotentInspect
Every cover the song has had, made or uploaded, the one in use marked, and what making more costs Newest first; each cover is kept until deleted (delete_cover). in_use is the cover the song uses; any other can be put back in use (use_cover). A made cover (source made, ai_made true) has the idea it came from (title, pitch, style, director_pick). download_url saves its full size (full_size px square: 3000 for a made cover). rounds: covers being made now (make_cover), and the newest round if it failed. can.plan: making covers needs a paid plan; can.ready: the song is analysed; can.artist: the artist can be on a cover (they have a character). price.counts: the credits for 1 to 4 covers; price.redraw: redrawing one with a note. artist_look: the colours and typeface the artist's covers keep, once their first made cover is used.
Inputs: song_id (required).
list_song_importsList song importsARead-onlyIdempotentInspect
Released songs being imported, failed ones waiting for a file, and today’s done ones Newest first. status: queued, fetching, done (song_id: the song made) or failed (error says why; add_song_import_audio with the file, or cancel_song_import).
Inputs: status, artist_id.
list_songsList songsARead-onlyIdempotentInspect
Songs with their cover, duration and analysis status A song must be analyzed (analysis.status "ready") before videos can be made. 50 per page by default: pass q to search, and limit/offset to page. cover_art.url is the cover at up to 1536 px (JPEG; width and height describe it), preview_url a 640 px and thumbnail_url a 160 px WebP; cover_art is null for a song without cover art (it is optional). Image links are signed for 7 days and stay the same all day, so they can be cached.
Inputs: q, sort, limit, offset, +2 more.
list_videosList videosARead-onlyIdempotentInspect
Videos, 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.
Inputs: q, type, limit, cursor, +3 more.
make_coverMake coversAInspect
Kinetune’s cover art director makes 1 to 4 covers for a song, each a different idea The director reads the song (its meaning, never a lyric drawn literally), the user's choices and the artist's character, and the image model draws each cover; each is checked (no letters in the picture, reads as a thumbnail) and kept on the song (list_song_covers) as it is drawn, in about a minute. Only covers that pass are charged; the song keeps its cover until the user picks one (use_cover). style: how it is made (auto: the director picks); vibes: up to 2 moods (dark, sad, hood, luxury…); artist: auto (the director decides), always (needs their character), never; when the song is about two people (a love song, a duet) the director may show the other person beside the artist, partly or fully, always an invented person, never a real likeness (never with artist never); idea: the user's own words; words: none, title, or artist_title, lettered into the cover in the artist's typeface and read back letter by letter, always spelled as the song (the type style needs words); look: overrides the artist's colours and typeface. Ask the user for their choices rather than guessing, and quote first (quote_cover): credits must match. Needs a paid plan (402 plan_required) and an analysed song (409 song_not_ready); one round per song at a time (409 covers_in_progress).
Inputs: credits (required), song_id (required), idea, look, +5 more.
plan_music_videoWrite a music video shot listAInspect
The director's shot list for a music video, the idea and every shot, before anything is charged Free (a limited number an hour). Takes about a minute. Returns a plan: the concept, the character it keeps the artist from, and its shots (cut between the song's lines, up to about 14 seconds each) with their lyrics and how each comes in (a cut, or carrying on in a continuous take). Show it to the user, rewrite it with revise until they like it, then quote_music_video and create_music_video with its plan_id.
Inputs: song_id (required), cast, trim, model, +15 more.
price_music_video_revisionPrice a music video revisionARead-onlyIdempotentInspect
What revising each shot of a delivered music video costs, before anything is rewritten For a music video whose revisable_until (get_video) is still ahead. shots: each shot's credits (its rewrite and the shots it makes again, remakes: a shot that the next one carries straight on from makes that one again too); base_credits: the revision's setup, paid once whatever is changed; outro_credits: finishing the video again with another outro and no shot made (create_music_video with refinish). A revision of several shots costs base_credits plus theirs; the exact price is the quote of the revision's plan.
Inputs: video_id (required).
quote_canvasQuote a CanvasARead-onlyIdempotentInspect
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.
Inputs: song_id (required), style, source, quality, +10 more.
quote_coverPrice coversBRead-onlyIdempotentInspect
What a round of 1 to 4 covers costs, and a redraw credits: what a round of count covers costs now (the direction once, each cover on top); redraw_credits: redrawing one cover with a note. Tell the user before make_cover or redraw_cover, and send the same credits.
Inputs: count.
quote_lyric_videoQuote a lyric videoARead-onlyIdempotentInspect
The exact credits for a lyric video, before anything is charged Returns quote_id, credits (total), credits_per_video and a breakdown, and free: true when, without a plan, it is the free song's free video (create_video then holds no credits). 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.
Inputs: look (required), song_id (required), trim, display, +4 more.
quote_music_videoQuote a music videoARead-onlyIdempotentInspect
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 their character (start_character). With a plan_id, test: true prices testing the plan first (its chorus's shots at 480p; test in the answer says which shots and seconds): offer it beside the whole video's quote. Always quote first and tell the user the credits before creating; credits are reserved at creation and charged only when the video is delivered.
Inputs: song_id (required), cast, test, trim, +24 more.
reanalyze_songAnalyze a song againBIdempotentInspect
Retry a failed analysis
Inputs: song_id (required).
redesign_music_video_lookbookRedesign a lookbookBInspect
Redesigns the director's pieces with a note and draws them again (spends credits) The user's own pieces stay. credits: price.redesign.credits.
Inputs: note (required), credits (required), lookbook_id (required).
redraw_coverRedraw a coverAInspect
Draws one cover of a round again with the user’s note Keeps the idea and changes what the note asks ("warmer, the moon bigger"). A new round of one cover; the cover it came from stays on the song. credits: redraw_credits from quote_cover, as shown to the user. Needs a paid plan.
Inputs: note (required), credits (required), cover_id (required), request_id (required).
redraw_music_video_lookbook_pieceRedraw a lookbook pieceCInspect
Draws one of the director's pieces again, with an optional note (spends credits) credits: price.credits_per_picture.
Inputs: piece (required), credits (required), lookbook_id (required), note.
remove_artist_imageRemove the artist imageADestructiveIdempotentInspect
Remove the artist’s image: they show their initial until another is set
Inputs: artist_id (required).
remove_idea_voteTake back a voteAIdempotentInspect
Remove the person's vote from an open idea
Inputs: idea_id (required).
rename_artistChange an artistAIdempotentInspect
Rename an artist, or set their catalog profile, Spotify id and links Send only what changes. catalog_artist_id: their profile in the music catalog (find_artist_in_catalog; link_artist does the same), null unlinks. spotify_artist_id: their Spotify artist id or open.spotify.com link. links: their pages, shown on their artist page: apple_music, spotify, youtube, instagram, tiktok (https links to that site) and website (any https link); a link set to null is removed, the others are kept.
Inputs: artist_id (required), name, links, catalog_artist_id, +2 more.
rename_lookRename a LookCIdempotentInspect
Rename one of your Looks
Inputs: name (required), look_id (required).
rename_songRename a songADestructiveIdempotentInspect
Change a song’s title A new title changes nothing else. instrumental is deprecated: the analysis hears whether a song has vocals. Switching it still analyzes the song again and replaces the analysis (an instrumental isn't transcribed, and its lyrics, including any set with set_song_lyrics, are deleted): poll get_song until analysis.status is "ready". Leave it out unless the user asks.
Inputs: song_id (required), title, instrumental.
render_music_video_lookbookDraw a lookbookAInspect
Draws the pieces not drawn yet (spends credits) credits is the price the user agreed to (price.draw.credits); a different price answers 409 with the current one. The credits are held, then charged as pictures are drawn; one that fails isn't charged. Poll get_music_video_lookbook until status is ready.
Inputs: credits (required), lookbook_id (required).
retry_videoMake a video againAInspect
Run a finished, failed or cancelled video again (new charge) Reuses the Look it made, with its background media and loops, so nothing already made is paid for again. A video that failed before its Look was saved is designed afresh.
Inputs: video_id (required).
revise_music_video_shotRevise a music video shotAInspect
The director rewrites one shot of a delivered music video from a note, or several shots each from its own note (free) For a music video whose revisable_until (get_video) is still ahead. Free (counted with the plans an hour), about half a minute. Several shots go in one call as shots (up to 12), each with its own note: one plan, one new version. Returns a plan whose revision names the video, the shots asked (asked) and the shots made again (shots): those asked, and each next one when it carries straight on from one of them. Show the rewritten shots, then quote_music_video with song_id, plan_id and the video's quality: only the shots made again are charged, the others are reused. create_music_video makes the revision as a new video; the original never changes.
Inputs: video_id (required), note, shot, shots.
rewrite_song_briefRewrite a song’s brief from the songADestructiveInspect
Drop the user’s correction and read the song again Writes the brief again from the song as it is now (its lyrics and analysis), in the background: the answer has status writing; poll get_song until brief.status is ready, usually within half a minute. The user’s correction (brief.edited) is dropped, so ask first. Free; a few times a day per song (429 past that). 409 while the song is being analysed.
Inputs: song_id (required).
save_music_video_lookSave a music video's LookAIdempotentInspect
A delivered music video's direction as a reusable Look (free) Made the first time (the director writes its treatment without the song, the lyrics or the artist), private to the workspace until the video is made public; its AI-drawn places and props travel with it, never the artist. Use it with plan_music_video or quote_music_video look_id on any song.
Inputs: video_id (required).
search_stockSearch stock mediaARead-onlyIdempotentInspect
Find stock photos or clips to use as a background 24 results a page. Pass an item's id as look.background.stock_id (source "stock-photo" or "stock-video") or as a Canvas's stock_id to use it instead of the director's pick, and credit the photographer (credit) wherever you show it. orientation: portrait for 9:16 and 1:1, landscape when 16:9 is among the formats (a Canvas is portrait). Clips too short for the loop are left out: pass seconds for a Canvas. thumbnail_url is a 480 px still, preview_url a 1280 px one (the photo, or the clip's poster), preview_video_url a small MP4 of a clip.
Inputs: q (required), kind (required), page, seconds, +1 more.
set_artist_imageSet the artist imageADestructiveIdempotentInspect
Upload or replace the artist’s image, their picture on the artist page and in lists The artist image (image_url on the artist) is kept as a 512 px square: upload the file (or a public https image_url, JPEG, PNG or WebP, at least 512 px on the short side, up to 15 MB) and, optionally, crop: the square to keep in fractions of the upright image (x/y the top-left corner, size the side relative to the image’s short side); left out, it is centered. It replaces the current image, which can’t be brought back; the uploaded file itself is not kept. It is only a display picture: never shown to a model (videos keep the artist from their character: list_characters). Works without a plan.
Inputs: artist_id (required), crop, image_url.
set_look_visibilityPublish or unpublish a LookAIdempotentInspect
Make one of your Looks public (earns 10 credits) or private Public Looks join the Community library under your @username. A Look that shows your artist stays private (409).
Inputs: look_id (required), visibility (required).
set_song_coverChange a song’s coverADestructiveIdempotentInspect
Replace a song’s cover art, or add one Adds cover art to a song without one, or replaces it. The new cover is checked like an upload’s (a square JPEG or PNG, 1000–6000 px, up to 20 MB) and kept at its full size and at 1536, 640 and 160 px; the cover before stays on the song (list_song_covers) and can be put back in use (use_cover). Videos already made keep the cover they had; quotes, Looks, Canvas loops, music video plans and videos made from then on use the new one. Refused (409, code song_busy) while a video of the song is being made: try again once it is done.
Inputs: song_id (required), cover_art_url.
set_song_lyricsSet a song’s lyricsADestructiveIdempotentInspect
Give a song its own lyrics, or replace them The song’s lyrics as text: plain (Suno-style [Verse]/[Chorus] tags and (x2) marks are fine), or the contents of an SRT, WebVTT or LRC file. Every word is still timed from the audio: your text fixes misheard words and sets where lines break in videos, and its section tags set the song’s sections (a chorus sung once is still a chorus). A part sung again (a chorus) can be written once; lyrics that don’t match what’s sung, or cover only part of it, are refused (409, the song unchanged). They are checked right away (analysis.lyrics in the answer says what changed), or once the analysis finishes if it hasn’t (202). Videos made from then on use them; videos already made stay as they are.
Inputs: lyrics (required), song_id (required).
show_looksShow LooksARead-onlyIdempotentInspect
Shows Looks to the person as a gallery they can play and pick from (each Look plays as the real render). Use it whenever they want to see, browse or choose Looks; pass song_id to preview the Looks with one of their analyzed songs. Their pick comes back as a message naming the Look.
Inputs: q, limit, scope, offset, +5 more.
show_songsShow songsARead-onlyIdempotentInspect
Shows the person's songs as a list with covers, length and analysis status, each offering a lyric video, a Canvas or a music video. Use it when they want to see or pick a song.
Inputs: q, limit, offset, artist_id.
show_videoShow videosARead-onlyIdempotentInspect
Shows videos as players: the card follows a render on its own (progress while it renders), then plays the finished video with a download per format. Call it right after create_lyric_video, create_canvas or create_music_video with the video ids it returned (no need to wait_for_video then), or whenever the person asks to see a video.
Inputs: video_ids (required).
start_characterStart a characterAInspect
Photos of a person to draw a sheet from, a finished sheet to add, the camera's six shots, or a made-up person described in words mode generate: 1 to 6 photos of one person (any angles); they are read (a clear face is needed, someone else is set aside) and given a base outfit line, which can be edited before drawing (draw_character_sheet, priced in credits). mode add: one finished sheet, read (one person, a clear face, the views it shows, any text on it) and kept as it is, free. mode camera: the six shots of Take from camera, in its order (the face from the front, the head turned left and right, the whole body from the front, the side and the back), or the three head shots when the body is skipped, each cut out and laid out as the standard sheet, which then goes the way of mode add (free; the shots themselves are not kept). mode describe: a made-up person from a description (description: looks, age, build, hair, style; no photos), read first (one adult, made up: never a real or famous person, 422 otherwise) and given a base outfit line, then drawn like photos (draw_character_sheet, priced in credits) and kept as AI-made. Photos, sheets and shots only with the rights to use these images (rights_confirmed). Uploads are kept until the character is kept (keep_character), or a day; a sheet drawn and paid for, 30 days (list_character_requests finds it). modes generate and describe need an active plan (402 plan_required without one; get_account: plan.active); modes add and camera work without one. A workspace starts at most 30 characters an hour and 50 a day (6 and 10 without a plan; 429 past them). Both need room in storage (402 storage_full when it would not fit; get_account: storage).
Inputs: mode, photo_urls, description, rights_confirmed.
start_face_checkStart a face checkAInspect
The page where the person proves, live on camera, that the face is theirs Returns only a link (url, good for 30 minutes) to Kinetune's own face check page: this tool takes and returns no image, video or face data, and nothing about a face passes through the conversation. Only the person shown on the character can pass it, on that page, on a phone with a camera; then get_face_check says passed or failed. consent: the person said, in their own words, that they agree to Kinetune checking their face on that page and keeping the result to match their pictures in this model's videos (kinetune.com/privacy, Face checks); ask them first, never assume it or set it for them. They can delete it any time with withdraw_face_check. A failed check is started again.
Inputs: model (required), consent (required), character_id (required).
suggest_ideaSuggest an ideaAInspect
Suggest a feature or change to Kinetune for others to vote on Posts an idea to the Community board in the app, where everyone signed in can vote and comment, and Kinetune says what is planned and what shipped. Use it when the person asks for something the product can't do yet ("I wish it could…"): say it in their words, one line, with how they would use it in body. It is public to Kinetune's users under the person's name, so leave out private links and contact details, and ask before posting. Suggesting votes for the idea and follows it: the person hears by email when it ships. At most 5 a day.
Inputs: title (required), area, body.
swap_music_video_placeChange a place's photoAIdempotentInspect
Another stock photo for one of a plan's places Returns the next draft: the same shot list, set in this photo (no director call, free). Pick a photo of the same kind of place, with no people, from search_stock.
Inputs: place (required), plan_id (required), stock_id (required).
unfollow_ideaStop following an ideaCIdempotentInspect
No more email about it
Inputs: idea_id (required).
update_kit_pieceChange a kit pieceBIdempotentInspect
Rename it, change its handle or description, crop it again, or share it crop is cut again from the image the piece was added from. kept true keeps another angle of a place that is pending (a brief can mention it then). shared: offer it (a character too) to every other artist's songs (true), or keep it to its own artist's (false); it stays in its own artist's kit either way. ai_made, on a character only: an AI-made person who looks like no real person (true), or a real one (false); a person who passed a face check is real (withdraw it first). Plans already made keep the pieces as they were planned.
Inputs: kit_id (required), crop, kept, name, +4 more.
update_music_video_lookbookSave a lookbook to the kit or notBIdempotentInspect
Whether its kept pieces join the kit when a video is planned from it save_to_kit true (default): the kept pieces become kit pieces of the workspace and the artist; false: they are used for that video only.
Inputs: lookbook_id (required), save_to_kit (required).
update_organizationUpdate the organizationAIdempotentInspect
Rename the organization (workspace) these credentials act for, or switch it between artist, label and creator Owners and admins only. An artist workspace can become a label or creator workspace any time, and those can switch between each other; they can become an artist workspace only while they have one artist or none (409 otherwise).
Inputs: name, type.
upload_backgroundUpload a backgroundAInspect
Upload 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).
Inputs: file_url, video_id, rights_confirmed.
use_coverUse a coverAIdempotentInspect
Puts one of the song’s covers in use Everything made from now on uses it; videos already made keep theirs. A made cover's colours and typeface become the artist's look for their next covers. Refused (409 song_busy) while a video of the song is being made. No plan needed.
Inputs: song_id (required), cover_id (required).
vote_for_ideaVote for an ideaAIdempotentInspect
Add the person's vote to an open idea Upvotes only, while the idea is open (409 once it shipped or was declined). Votes are public as a count, under the person's account: ask before voting.
Inputs: idea_id (required).
wait_for_videoWait for a videoARead-onlyIdempotentInspect
Waits up to max_seconds (default 50) for a video to finish, then returns it like get_video. Call again while status is queued or processing. While it waits, queue says why: plan_limit (the workspace already makes as many videos at once as its plan allows; position is its place in line) or render_capacity (every render machine is busy; estimated_wait_seconds is about how long) or generator_capacity (a music video: every music video generator is busy; position is its place in line). Tell the user.
Inputs: video_id (required), max_seconds.
withdraw_face_checkWithdraw a face checkADestructiveIdempotentInspect
Deletes the person's checked face: the model stops showing them Their checked face is deleted with every picture registered against it, and the models it covered can't show them until they pass a new check. Videos already made stay. Deleting the character withdraws every check.
Inputs: character_id (required), model.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
I do everything related to music and lyrics
Turn a song and its lyrics into a word-synced lyric video, with three styles to choose from.
Audio-reactive music visualizer: turn a track and cover art into a music video.
Turn audio or text into a finished AI music video: narrative, multi-provider clips, final cut.
Related MCP Servers
- AlicenseAqualityCmaintenanceLocal music video toolkit: BPM, key and Camelot detection, best 15/30 s clip, beat-synced shot lists, Spotify Canvas maker and platform specs. Runs on your machine with ffmpeg, no API key.5MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to create lyric videos by adding images, audio, styled text, and timed lyric lines, then rendering the final MP4.ISC
- AlicenseNot gradedqualityDmaintenanceTurn words, images, and audio into an animated video with MP4 export.MIT

Compeller MCPofficial
AlicenseNot gradedqualityDmaintenanceEnables agents to create AI music videos and audio-reactive visuals from songs through MCP, including style discovery, music search, rendering, webhook registration, and media management.1MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.