Upload a background
- MCP tool
upload_background- CLI
kinetune backgrounds upload
/api/v1/backgroundsNot sent from the docs: it uploads files to your workspace. Run it with curl, the CLI or its MCP tool.
Upload your own photo or video to design a New Look around
Photo: JPEG, PNG or WebP, at least 720 px on the short side, up to 25 MB. Video: MP4, MOV or WebM, 4–180 seconds, at least 720 px on the short side, up to 300 MB; it becomes a seamless loop of up to 20 s. Only with the rights to use it. Then quote a lyric video with look {"mode":"new","category":"…","background":{"source":"upload-photo" or "upload-video","upload_id":"…"},"visibility":"private"}. 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
file_url?stringA public https URL of the photo or video
urilength <= 2000rights_confirmed*booleanYou have the rights to use this photo or video
curl -X POST 'https://kinetune.com/api/v1/backgrounds' \
-H 'Content-Type: application/json' \
-d '{
"rights_confirmed": true
}'