Developer docs

Start a face check

MCP tool
start_face_check
CLI
kinetune characters face-check start
POST/api/v1/characters/{character_id}/face-check

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

The page where the person proves, live on camera, that the face is theirs

Returns only a link (url, good for 30 minutes) to Kinetune's own face check page: this tool takes and returns no image, video or face data, and nothing about a face passes through the conversation. Only the person shown on the character can pass it, on that page, on a phone with a camera; then get_face_check says passed or failed. consent: the person said, in their own words, that they agree to Kinetune checking their face on that page and keeping the result to match their pictures in this model's videos (kinetune.com/privacy, Face checks); ask them first, never assume it or set it for them. They can delete it any time with withdraw_face_check. A failed check is started again.

headerAuthorizationBearer <token>

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

character_id*string

The character id (kit_…)

Length1 <= length
application/json
  1. body
model*string

The music video model it is for

Value in"one-take""seedance-2-0""seedance-2-0-fast""seedance-2-0-mini""seedance-2-5"
consent*boolean

The person agreed to the face check

Response Body

OK

Example Request
curl -X POST 'https://kinetune.com/api/v1/characters/string/face-check' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "one-take",
  "consent": true
}'
Example Response
Empty