KidArt AI API

Photograph a child's drawing, say the age band and the materials at home, and get the colours and shapes measured in the picture, a warm description, and two or three art activities. Descriptive and positive only: no score, grade or comparison, and never a reading of the child. Machine-readable spec: /api/openapi.json.

Authenticate

curl -H "Authorization: Bearer $KIDARTAI_KEY" https://kidartai.sensifai.com/api/v1/meta

Create keys on the dashboard under Settings (an account admin can). X-API-Key works too. Only POST /api/v1/analyses is billed, once, after the analysis is delivered; everything else on this page is free.

Check a photo first (free)

curl -X POST -H "Authorization: Bearer $KIDARTAI_KEY" \
  -F [email protected] \
  https://kidartai.sensifai.com/api/v1/preview
# 200 {"usable":true,"image_quality":{"score":96,"usable":true,"problems":[]},
#      "observed_colors":[{"hex":"#EA5D23","name":"sunset orange","family":"orange","share_percent":36}, ...], ...}

A blank, too dark, blurry or tiny photo answers 200 with "usable":false and a message. Nothing is stored or billed.

Analyse a drawing

curl -X POST -H "Authorization: Bearer $KIDARTAI_KEY" \
  -F [email protected] -F age_band=5-6 -F materials=crayons,glue,scissors,colored_paper \
  https://kidartai.sensifai.com/api/v1/analyses
# 202 {"job_id":"01a2b3c4","status":"queued","poll":"/api/v1/jobs/01a2b3c4"}

curl -H "Authorization: Bearer $KIDARTAI_KEY" https://kidartai.sensifai.com/api/v1/jobs/01a2b3c4
# {"id":"01a2b3c4","status":"succeeded","analysis_id":"01a2b3c4", ...}

curl -H "Authorization: Bearer $KIDARTAI_KEY" https://kidartai.sensifai.com/api/v1/analyses/01a2b3c4

JSON works too: {"photo":"<base64>","age_band":"5-6","materials":["crayons","glue"]}. Age bands are 3-4, 5-6, 7-9, 10-12; GET /api/v1/meta lists every material, subject and technique id. A photo that is not a drawing, an unusable photo and any failure are never charged.

What comes back

report fieldwhat it is
observed_colorsColours measured in the picture, with crayon-box names and shares. Never chosen by a model.
shapesForms seen. source: "measured" shapes carry a count; "ai" shapes are the model's reading, labelled as such.
composition, style_scoresHow the page is used (fill, placement, balance, stroke, contrast, variety) and eight descriptive 0-10 dials, each with the measurement behind it. Dials describe how a picture is made; neither end is better.
possible_techniquesLikely media, always possible or likely: a photo cannot prove a medium.
description, positive_feedbackWarm sentences about the picture. Any sentence that grades, compares, diagnoses or talks about the child is replaced by a template.
activities, materials, supervision_notesTwo or three catalogue activities with steps, hazards and supervision level, checked in Go against the age band and the materials at home; what they need; adult-facing safety lines.
checks, checks_passedAn independent verifier re-derives everything. A failing check is shown, never hidden.

Browse activities and trends (free)

curl -H "Authorization: Bearer $KIDARTAI_KEY" \
  "https://kidartai.sensifai.com/api/v1/activities?age=5-6&materials=crayons,glue&ready=true"
curl -H "Authorization: Bearer $KIDARTAI_KEY" "https://kidartai.sensifai.com/api/v1/history?days=90"

Errors

Problems are RFC 7807 JSON with a stable code and a detail sentence safe to show an adult. 402 means the prepaid wallet is empty (top_up_url is included), 403 that there is no active subscription (subscribe_url), 422 that a choice or the photo is not usable, 429 that an hourly limit was reached.