Changelog
What changed in the API, newest first.
Clearer names for the music video steps
- ChangedThe docs, MCP tool titles and n8n operations call the two steps the lookbook (
design_music_video_shoot, optional: outfits, places and props drawn as pictures) and the shot list (plan_music_video, free). Tool names, endpoints and fields are unchanged.
- ChangedThe docs, MCP tool titles and n8n operations call the two steps the lookbook (
API v1 is stable
- Changed/api/v1 now only grows: new endpoints, optional fields and values arrive in v1 as they are, and anything that would break an integration is deprecated first, with Deprecation and Sunset headers, at least 180 days before it is removed.
- AddedMusic videos:
takes("cuts", the default, or "continuous") on music video plans, quotes and videos. - AddedMusic video plans:
shots[].transition, how each shot comes in from the one before (cut, dissolve, black, flash or whip; null for the first shot and one that continues), andshots[].continues. - ChangedThe CLI (@kinetune/cli) and the n8n node (@kinetune/n8n-nodes-kinetune) are 1.0.0 and follow semantic versioning: a major version only for a breaking change.
- AddedEvery answer carries
Kinetune-Api-Version: 1; a deprecated operation also answers withDeprecation,Sunsetand aLinkto this changelog. - ChangedMusic videos are edited from shots cut between the song’s lines (no longer one continuous take by default);
clipsin quotes and plans counts those shots.
AI music videos
- AddedMusic videos:
plan_music_video,get_music_video_plan,quote_music_video,create_music_videoandswap_music_video_place(REST:/music-video-plans,/quotes,/videoswithtype"music-video"), from 15 seconds to 10 minutes of a song. - AddedThe artist kit (
/kit: outfits, places and props with @handles a brief can mention) and the lookbook (/music-video-lookbooks). - Added
get_song_analysislistsparts, where a video can start and end without cutting a word, withmin_secondsfor the shortest part you need.
- AddedMusic videos:
Community and the catalog
- Added
suggest_idea(POST /ideas) suggests a feature on the Community board. - ChangedPlan and credit pack prices and credits come from
GET /options, set by Kinetune; quote before making a video rather than assuming a price.
- Added
Workspaces, plans and storage
- ChangedUploading and making videos need the workspace to have an active plan: without one they answer 402 with
"code": "plan_required". Reading, renaming, archiving and deleting don’t. - ChangedEach plan has a storage limit: an upload or video that would not fit answers 402 with
"code": "storage_full"(GET /accounthasstorage). Files are kept 90 days after a plan ends. - ChangedA workspace is an artist’s or a label’s:
POST /organizationstakes a requiredtype;update_organization(PATCH /organization) renames it or switches its type. In an artist workspace,artist_idmay be left out of song uploads.
- ChangedUploading and making videos need the workspace to have an active plan: without one they answer 402 with