Developer docs

Set the artist image

MCP tool
set_artist_image
CLI
kinetune artists image set
POST/api/v1/artists/{artist_id}/image

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

Upload or replace the artist’s image, their picture on the artist page and in lists

The artist image (image_url on the artist) is kept as a 512 px square: upload the file (or a public https image_url, JPEG, PNG or WebP, at least 512 px on the short side, up to 15 MB) and, optionally, crop: the square to keep in fractions of the upright image (x/y the top-left corner, size the side relative to the image’s short side); left out, it is centered. It replaces the current image, which can’t be brought back; the uploaded file itself is not kept. It is only a display picture: never shown to a model (videos keep the artist from their character: list_characters). Works without a plan.

headerAuthorizationBearer <token>

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

artist_id*string

The artist id

Length1 <= length <= 120
  1. body
image_url?string

A public https URL of the image (a file on your computer: create_upload's file_url, or upload it with the CLI)

Formaturi
Lengthlength <= 2000
crop?

The square to keep, in fractions of the image; centered when omitted

Response Body

OK

Example Request
curl -X POST 'https://kinetune.com/api/v1/artists/string/image' \
  -H 'Content-Type: application/json' \
  -d '{}'
Example Response
Empty