Developer docs

Start a character

MCP tool
start_character
CLI
kinetune characters start
POST/api/v1/character-requests

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

Photos of a person to draw a sheet from, a finished sheet to add, the camera's six shots, or a made-up person described in words

mode generate: 1 to 6 photos of one person (any angles); they are read (a clear face is needed, someone else is set aside) and given a base outfit line, which can be edited before drawing (draw_character_sheet, priced in credits). mode add: one finished sheet, read (one person, a clear face, the views it shows, any text on it) and kept as it is, free. mode camera: the six shots of Take from camera, in its order (the face from the front, the head turned left and right, the whole body from the front, the side and the back), or the three head shots when the body is skipped, each cut out and laid out as the standard sheet, which then goes the way of mode add (free; the shots themselves are not kept). mode describe: a made-up person from a description (description: looks, age, build, hair, style; no photos), read first (one adult, made up: never a real or famous person, 422 otherwise) and given a base outfit line, then drawn like photos (draw_character_sheet, priced in credits) and kept as AI-made. Photos, sheets and shots only with the rights to use these images (rights_confirmed). Uploads are kept until the character is kept (keep_character), or a day; a sheet drawn and paid for, 30 days (list_character_requests finds it). modes generate and describe need an active plan (402 plan_required without one; get_account: plan.active); modes add and camera work without one. A workspace starts at most 30 characters an hour and 50 a day (6 and 10 without a plan; 429 past them). Both need room in storage (402 storage_full when it would not fit; get_account: storage).

headerAuthorizationBearer <token>

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

  1. body
mode?string

generate (default): draw a sheet from photos; add: a finished sheet; camera: the camera shots in order (six, or the three head shots); describe: a made-up person from description

Value in"generate""add""camera""describe"
description?string

mode describe: who they are, in words (looks, age, build, hair, style); a made-up adult, never a real or famous person

Length10 <= length <= 600
photo_urls?array<>

Public https URLs of the photos, or of the one sheet (files on your computer: create_upload's file_url for each, or upload them with the CLI)

Items1 <= items <= 6
rights_confirmed?boolean

You have the rights to use these images of this person (needed with photos, a sheet or camera shots; not for describe)

Response Body

OK

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