Add a kit piece
- MCP tool
add_kit_piece- CLI
kinetune kit add
/api/v1/kitNot sent from the docs: it uploads files to your workspace. Run it with curl, the CLI or its MCP tool.
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 photos: outfits (an artist’s), places and props (the workspace’s, for every artist). Each has a name and an @handle; 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; a place or prop is the workspace's. 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).
AuthorizationBearer <token>An organization API key (kt_live_…) or an OAuth access token
- body
kind*stringoutfit (an artist’s), place or prop (the workspace’s)
"outfit""place""prop"name*stringWhat it is called, e.g. Blue set
1 <= length <= 60artist_id?stringThe artist an outfit belongs to (outfits only)
1 <= length <= 120handle?stringIts @handle (default: from the name)
^[a-z0-9][a-z0-9-]{0,39}$description?stringWhat it is, for the director (a stock photo’s caption by default)
length <= 300crop?The rectangle to keep, in fractions of the image: {"x","y","w","h"}; the whole image when omitted
file_url?stringA public https URL of the image (or upload a file with the CLI)
urilength <= 2000stock_id?stringA stock photo id from search_stock instead of an image
^\d{1,20}$rights_confirmed?booleanYou have the rights to use the image (needed for an upload or file_url)
curl -X POST 'https://kinetune.com/api/v1/kit' \
-H 'Content-Type: application/json' \
-d '{
"kind": "outfit",
"name": "string"
}'