Revise a music video shot
- MCP tool
revise_music_video_shot- CLI
kinetune videos revise
/api/v1/videos/{video_id}/revisionsNot sent from the docs: it changes your workspace. Run it with curl, the CLI or its MCP tool.
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.
AuthorizationBearer <token>An organization API key (kt_live_…) or an OAuth access token
video_id*stringThe video id
1 <= length <= 120application/json- body
shot?integerThe shot to change (its index in the plan's shots); with note. Or send shots
1 <= value <= 9007199254740991note?stringWhat should change, in the artist's words
1 <= length <= 1000shots?array<>Several shots, each with its own note (instead of shot and note): all rewritten into one plan, one new version
1 <= items <= 12OK
application/json- response
id*stringsong_id*stringdraft*integer1 for the first plan, n+1 for a rewrite
-9007199254740991 <= value <= 9007199254740991revision_of*string|nullnote*string|nullbrief*What it was planned from: model, category, style, aspect_ratio, trim, direction, on_screen, performer, cast
title*|The film's name, as the director titled it
concept*stringstyle*stringclips*integer-9007199254740991 <= value <= 9007199254740991character?|The character who performs (the brief's performer, else the artist's; list_characters; null when nobody performs): each outfit is drawn on it when the video is made, priced in the quote
people?array<>The other characters in its shots (mentioned by @handle in direction: the artist's own and those other artists shared), each in one outfit throughout
on_screen?stringWho is on screen: the artist, a cast or no one
"artist""cast""none"revision*|A revision of a delivered music video (revise_music_video_shot): that video, and the shots made again (the others are reused as they were); null for a plan of a new video
world*What every shot keeps
places*array<>The real places it is set in: kit pieces (kit), or stock photos the director found (photo); neither: no usable photo was found, so it is imagined. Empty: every place is imagined
outfits*array<>The kit outfits it uses
props*array<>The kit props it uses
joins*integerIn a continuous take, the joins drawn as pictures (priced per picture); 0 otherwise
-9007199254740991 <= value <= 9007199254740991shots*array<>outro?|The release card the director designed for this video: used only when the video is ordered with outro (create_music_video outro); no outro is added otherwise. null before outros
created_at*string[key: string]?unknowncurl -X POST 'https://kinetune.com/api/v1/videos/string/revisions' \
-H 'Content-Type: application/json' \
-d '{}'{
"id": "string",
"song_id": "string",
"draft": -9007199254740991,
"revision_of": "string",
"note": "string",
"brief": {
"property1": null,
"property2": null
},
"title": "string",
"concept": "string",
"style": "string",
"clips": -9007199254740991,
"character": {
"id": "string",
"name": "string"
},
"people": [
{
"index": -9007199254740991,
"character": {
"id": "string",
"name": "string",
"handle": "string"
},
"name": "string",
"wardrobe": "string",
"outfit": {
"id": "string",
"name": "string",
"handle": "string"
}
}
],
"on_screen": "artist",
"revision": {
"video_id": "string",
"shots": [
-9007199254740991
],
"asked": [
-9007199254740991
]
},
"world": {
"setting": "string",
"wardrobe": "string",
"light": "string"
},
"places": [
{
"index": -9007199254740991,
"description": "string",
"kit": {
"id": "string",
"name": "string",
"handle": "string"
},
"photo": {
"stock_id": "string",
"thumbnail_url": "string",
"credit": {
"property1": null,
"property2": null
}
}
}
],
"outfits": [
{
"index": -9007199254740991,
"kit": {
"id": "string",
"name": "string",
"handle": "string"
},
"description": "string"
}
],
"props": [
{
"index": -9007199254740991,
"kit": {
"id": "string",
"name": "string",
"handle": "string"
},
"description": "string"
}
],
"joins": -9007199254740991,
"shots": [
{
"index": -9007199254740991,
"start_seconds": 0,
"end_seconds": 0,
"section": "string",
"lyrics": "string",
"summary": "string",
"places": [
-9007199254740991
],
"outfit": -9007199254740991,
"props": [
-9007199254740991
],
"people": [
-9007199254740991
],
"continues": true,
"performance": "sings",
"on_screen": "artist",
"framing": "close",
"cue": {
"said": "string",
"note": "string"
},
"camera": {
"size": "close",
"angle": "front",
"move": "push-in"
}
}
],
"outro": {
"property1": null,
"property2": null
},
"created_at": "string",
"property1": null,
"property2": null
}