Developer docs

Revise a music video shot

MCP tool
revise_music_video_shot
CLI
kinetune videos revise
POST/api/v1/videos/{video_id}/revisions

Not 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.

headerAuthorizationBearer <token>

An organization API key (kt_live_…) or an OAuth access token

video_id*string

The video id

Length1 <= length <= 120
application/json
  1. body
shot?integer

The shot to change (its index in the plan's shots); with note. Or send shots

Range1 <= value <= 9007199254740991
note?string

What should change, in the artist's words

Length1 <= length <= 1000
shots?array<>

Several shots, each with its own note (instead of shot and note): all rewritten into one plan, one new version

Items1 <= items <= 12

Response Body

OK

application/json
  1. response
id*string
song_id*string
draft*integer

1 for the first plan, n+1 for a rewrite

Range-9007199254740991 <= value <= 9007199254740991
revision_of*string|null
note*string|null
brief*

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*string
style*string
clips*integer
Range-9007199254740991 <= value <= 9007199254740991
character?|

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?string

Who is on screen: the artist, a cast or no one

Value in"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*integer

In a continuous take, the joins drawn as pictures (priced per picture); 0 otherwise

Range-9007199254740991 <= value <= 9007199254740991
shots*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]?unknown
Example Request
curl -X POST 'https://kinetune.com/api/v1/videos/string/revisions' \
  -H 'Content-Type: application/json' \
  -d '{}'
Example Response
{
  "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
}