Drive On Twos from your own code

{ "ok": true,  "data":  { ... } }
{ "ok": false, "error": { "code": "...", "message": "...", "status": 402, "details": { ... } } }

{"task": "pose", "verdict": "one_shot", "shot": "...", "summary": "...",
 "poses": [{"n": 1, "label": "...", "kind": "key", "preset": "stand", "frames": 4, "note": "..."}, ...],
 "principles": [{"id": "anticipation", "poses": [2], "why": "..."}, ...],
 "missing": [], "splits": [], "tip": "..."}

{
 "task": "pose",
 "move": "Standing next to the sofa, the figure lets the knees go, drops backwards onto the cushions with arms flung wide, bounces once and settles into a slump.",
 "seconds": "2",
 "fps": "12",
 "target_frames": "24",
 "page_actions": "1"
}

{
 "task": "pose",
 "verdict": "one_shot",
 "shot": "Drop backward onto the sofa",
 "summary": "The figure stands, drops backward onto the sofa with arms wide, bounces once, and settles into a slump.",
 "poses": [
  {
   "n": 1,
   "label": "Standing beside the sofa",
   "kind": "key",
   "preset": "stand",
   "frames": 2,
   "note": "The figure stands upright next to the sofa before the knees give way."
  },
  {
   "n": 2,
   "label": "Knees let go",
   "kind": "breakdown",
   "preset": "crouch",
   "frames": 2,
   "note": "The knees bend and release, starting the drop backward toward the sofa."
  },
  {
   "n": 3,
   "label": "Drops back, arms flung wide",
   "kind": "breakdown",
   "preset": "fall",
   "frames": 4,
   "note": "The body drops backward through the air with arms flung wide."
  },
  {
   "n": 4,
   "label": "Lands on the cushions",
   "kind": "breakdown",
   "preset": "land_squash",
   "frames": 2,
   "note": "The body lands on the cushions, weight sinking in on impact."
  },
  {
   "n": 5,
   "label": "Bounces once off cushions",
   "kind": "breakdown",
   "preset": "jump",
   "frames": 2,
   "note": "The body lifts slightly off the cushions in one small bounce."
  },
  {
   "n": 6,
   "label": "Settles into a slump",
   "kind": "key",
   "preset": "slump",
   "frames": 12,
   "note": "The figure settles down into a slump on the cushions."
  }
 ],
 "principles": [
  {
   "id": "anticipation",
   "poses": [
    1,
    2
   ],
   "why": "Before dropping backward, the knees let go first, a small downward move opposite the backward fall to come."
  },
  {
   "id": "secondary_action",
   "poses": [
    3
   ],
   "why": "Flinging the arms wide as the body drops backward is a smaller move supporting the fall."
  },
  {
   "id": "squash_stretch",
   "poses": [
    4,
    5
   ],
   "why": "The body sinks into the cushions on landing, then springs up slightly in the bounce."
  },
  {
   "id": "slow_in_out",
   "poses": [
    5,
    6
   ],
   "why": "The bounce passes quickly while the final slump holds far longer, slowing into the settle."
  }
 ],
 "missing": [],
 "splits": [],
 "tip": "Fold a cloth into a low pad, prop the figure on a wire rig as it tips back and bounces, then photograph each change."
}

{
 "task": "pose",
 "move": "Jumping in surprise when a balloon pops behind them.",
 "seconds": "1.5",
 "fps": "24",
 "target_frames": "36",
 "page_actions": "1"
}

{
 "task": "pose",
 "verdict": "missing_key",
 "shot": "Jump of surprise at the pop",
 "summary": "Four poses show the figure flinching, pushing off, and rising to the jump's peak; start and finish positions aren't stated.",
 "poses": [
  {
   "n": 1,
   "label": "Flinching down at the pop",
   "kind": "key",
   "preset": "crouch",
   "frames": 11,
   "note": "The figure drops low, bracing in surprise just after the balloon pops behind it."
  },
  {
   "n": 2,
   "label": "Pushing off the ground",
   "kind": "breakdown",
   "preset": "stretch_tall",
   "frames": 7,
   "note": "The body stretches upward, legs driving against the ground to launch into the jump."
  },
  {
   "n": 3,
   "label": "Rising fast off the ground",
   "kind": "breakdown",
   "preset": "jump",
   "frames": 9,
   "note": "The figure leaves the ground, rising quickly as the jump carries it upward."
  },
  {
   "n": 4,
   "label": "At the peak of the jump",
   "kind": "key",
   "preset": "jump",
   "frames": 9,
   "note": "The figure hangs at its highest point, caught mid-air in surprise from the pop."
  }
 ],
 "principles": [
  {
   "id": "squash_stretch",
   "poses": [
    1,
    2
   ],
   "why": "The figure compresses low in the dip, then stretches tall as it pushes off the ground."
  },
  {
   "id": "anticipation",
   "poses": [
    1
   ],
   "why": "The downward dip at the pop moves opposite the upward jump that follows it."
  },
  {
   "id": "slow_in_out",
   "poses": [
    1,
    4
   ],
   "why": "More frames sit on the startled dip and the peak, fewer on the quick push and rise."
  }
 ],
 "missing": [
  "What position is the figure in just before the balloon pops?",
  "Where does the figure land, and what happens after the jump?"
 ],
 "splits": [],
 "tip": "Place a small ball behind the figure to mark the balloon's spot, and hold it aloft on a wire or putty-stick for the peak."
}

{
 "task": "pose",
 "move": "Getting out of bed: throw off the duvet, swing both legs to the floor, stand up and stretch, then shuffle to the window and open the curtains.",
 "seconds": "3",
 "fps": "12",
 "target_frames": "36",
 "page_actions": "2"
}

{
 "task": "pose",
 "verdict": "split_it",
 "shot": "Getting out of bed",
 "summary": "The description includes several separate actions; this sequence shows only the first, getting out of bed.",
 "poses": [
  {
   "n": 1,
   "label": "Lying under the duvet",
   "kind": "key",
   "preset": "lie",
   "frames": 6,
   "note": "The figure lies still under the duvet before the action begins."
  },
  {
   "n": 2,
   "label": "Throwing off the duvet",
   "kind": "breakdown",
   "preset": "arms_out",
   "frames": 4,
   "note": "The figure throws the duvet up and off the body."
  },
  {
   "n": 3,
   "label": "Swinging legs to the floor",
   "kind": "breakdown",
   "preset": "sit",
   "frames": 5,
   "note": "The figure sits up and swings both legs over onto the floor."
  },
  {
   "n": 4,
   "label": "Pushing up to stand",
   "kind": "breakdown",
   "preset": "lean_forward",
   "frames": 9,
   "note": "Weight shifts forward and the body rises up from sitting."
  },
  {
   "n": 5,
   "label": "Standing and stretching",
   "kind": "key",
   "preset": "stretch_tall",
   "frames": 12,
   "note": "Fully upright, the body stretches upward before holding still."
  }
 ],
 "principles": [
  {
   "id": "staging",
   "poses": [
    1,
    5
   ],
   "why": "Lying under the duvet and standing stretched both read clearly as the start and end of the action."
  },
  {
   "id": "timing",
   "poses": [
    2,
    3,
    4
   ],
   "why": "Short counts make tossing off the duvet and swinging the legs feel quick, while rising takes longer."
  },
  {
   "id": "follow_through",
   "poses": [
    4,
    5
   ],
   "why": "After the body finishes rising, it keeps moving upward into the stretch."
  }
 ],
 "missing": [],
 "splits": [
  "Getting out of bed",
  "Shuffling to the window",
  "Opening the curtains"
 ],
 "tip": "Drape a folded cloth over your figure as the duvet, then nudge its legs slightly between photos as it sits up and stands."
}

const K = TwosKit, A = TwosArt;
const built = K.buildInput({ move: "Sitting on a stool, the figure reaches up to a shelf and steps down onto the floor.", seconds: 2, fps: 12 });
built.input.target_frames;              // "24" - 2 s at 12 fps
built.prescan.verdict;                  // the page's quick word read
const wire = K.toWire(built.input);     // POST this to /estimate and /run
// then: const reply = K.normalize(K.parseReply(job.output.output));
// K.check(reply, built).notes          // the page's re-check of the reply
// K.sheet(reply.poses, 12)             // one row per frame, the exposure sheet
// A.stage(reply.poses, 1)              // the puppet stage at frame 1, as SVG

BASE="https://api.skillsafe.ai/v1/app-api"
TOKEN="paste-your-token-here"   # from https://on-twos.skillsafe.ai/tokens.html
api() { # api METHOD PATH [JSON-BODY]
  curl -s -X "$1" "$BASE$2" -H "Content-Type: application/json" \
    ${TOKEN:+-H "Authorization: Bearer $TOKEN"} ${3:+--data "$3"}
}

# a guest token (enough for /me and /estimate); a run needs your personal token from /tokens.html
TOKEN=$(curl -s -X POST "$BASE/guest" -H "Content-Type: application/json" -d '{"slug":"on-twos"}' | jq -r '.data.token')

api GET /me | jq '.data | {subject_type, credits}' 

# input.json: the run input object - {"task": "pose", "move": "...", "seconds": "2", "fps": "12", "target_frames": "24", "page_actions": "1"} - see the field table
api POST /estimate "$(cat input.json)" | jq '.data | {hold_credits, min_credits, model, model_alias, markup_bps, warnings}' 

KEY="on-twos:pose:$(shasum -a 256 input.json | cut -c1-16):a1"
JOB=$(curl -s -X POST "$BASE/run" -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $KEY" --data @input.json | jq -r '.data.job_id')
while :; do
  J=$(api GET "/jobs/$JOB"); S=$(echo "$J" | jq -r '.data.status')
  case "$S" in succeeded|failed|cancelled) break;; esac; sleep 2
done
echo "$J" | jq -r '.data.output.output' > reply.json   # one JSON object, the reply contract
echo "$J" | jq '.data | {charged_credits, truncated}' 

# Server-Sent Events: tick/delta events while the job runs, then a final event with the job
curl -N -s -X POST "$BASE/run-stream" -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: on-twos:pose:$(shasum -a 256 input.json | cut -c1-16):a1" --data @input.json