Developer docs

Draw a character sheet

MCP tool
draw_character_sheet
CLI
kinetune characters draw
POST/api/v1/character-requests/{request_id}/draw

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

Draws the sheet for the credits shown (again with a note to redraw)

From photos, a description (mode describe), or an added sheet drawn again as a plain base sheet (nothing worn or held beyond one plain outfit). credits must be price.credits from get_character_request: tell the user first. outfit: the base outfit line as the user left it (always drawn plain: one top and fitted trousers or skirt, solid colours, barefoot, no jewellery). note: what to change when drawing again ("her hair is shorter"). Charged only once the sheet passes its check (one person, a clear face, no text); a failed check is redrawn once at no charge. 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

request_id*string

The request id (charreq_…)

Length1 <= length
application/json
  1. body
credits*integer

price.credits, as shown to the user

Range0 < value <= 9007199254740991
outfit?string

The base outfit line

Lengthlength <= 220
note?string

What to change, when drawing again

Lengthlength <= 500

Response Body

OK

Example Request
curl -X POST 'https://kinetune.com/api/v1/character-requests/string/draw' \
  -H 'Content-Type: application/json' \
  -d '{
  "credits": 1
}'
Example Response
Empty