Developer docs

Draw a music video's cast

MCP tool
draw_music_video_cast
CLI
kinetune casting draw
POST/api/v1/music-video-castings/{casting_id}/draw

Not sent from the docs: it changes your workspace. Run it with curl, the CLI or its MCP tool.

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

headerAuthorizationBearer <token>

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

casting_id*string

The casting id

Match^casting_[0-9a-f-]{36}$
application/json
  1. body
credits*integer

The price shown: price.per_person × the people drawn

Range0 <= value <= 9007199254740991
people*array<>

The people kept: [{"index":1},{"index":2,"description":"…"},{"index":3,"character":"mia-torres"}]; [] keeps it to the artist

Itemsitems <= 3

Response Body

OK

Example Request
curl -X POST 'https://kinetune.com/api/v1/music-video-castings/string/draw' \
  -H 'Content-Type: application/json' \
  -d '{
  "credits": 0,
  "people": [
    {
      "index": 1
    }
  ]
}'
Example Response
Empty