Developer docs

Get a face check

MCP tool
get_face_check
CLI
kinetune characters face-check get
GET
/api/v1/characters/{character_id}/face-check

Try it with your own API key: it runs on that key's workspace, so a real key reads your real songs, videos and credits. Reads and quotes only; nothing is charged.

Whether a model can show this real person yet: their face check for it

Some models (get_options: music_video.models[].face_check) show a real person only once they have proved, live on camera, that the face on the character is theirs: a Kinetune face check, done once and covering every model that shares it. status: not_needed (the model needs none, or the character is AI-made: ai_made); not_checked; waiting (a check started in the last 30 minutes); passed; failed (the last one didn't pass: start another). Asked before quoting such a model for each real person in it (the performer and the people).

headerAuthorizationBearer <token>

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

character_id*string

The character id (kit_…)

Length1 <= length
model*string

The music video model

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

Response Body

OK

Example Request
curl -X GET 'https://kinetune.com/api/v1/characters/string/face-check?model=one-take'
Example Response
Empty