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 field | what it is |
|---|---|
observed_colors | Colours measured in the picture, with crayon-box names and shares. Never chosen by a model. |
shapes | Forms seen. source: "measured" shapes carry a count; "ai" shapes are the model's reading, labelled as such. |
composition, style_scores | How 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_techniques | Likely media, always possible or likely: a photo cannot prove a medium. |
description, positive_feedback | Warm sentences about the picture. Any sentence that grades, compares, diagnoses or talks about the child is replaced by a template. |
activities, materials, supervision_notes | Two 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_passed | An 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.