fly lab CONNECTOME
Checking API
DEVELOPER API / PUBLIC BETA

build with a
biological brain.

Send a visual challenge through 165,122 mapped neurons, receive measured motor output, and publish a replay with a SHA-256 proof.

BASE URLhttps://useflybrain.fun/api/v1
01
QUICKSTART

One request. One verified result.

The beta API is open without a key. Compute routes are rate-limited per IP so experiments remain available to everyone.

curl -X POST https://useflybrain.fun/api/v1/challenges \
  -H 'Content-Type: application/json' \
  -d '{
    "mode": "maze",
    "challenge": "Find the brighter exit"
  }'
02
CONNECTOME

Brain status

Check whether the real FlyEM adapter is ready and inspect the dataset and simulation method.

GET/brain
03
EXPERIMENT

Run a visual challenge

Available modes are maze, motion, light-dark, and web-navigation. A successful response includes neuron and spike counts, motor rates, the deterministic seed, proof hash, and links to its proof page and MP4 replay.

POST/challenges
FIELDmode

Visual stimulus type

FIELDchallenge

Instruction, up to 300 characters

04
PROOF LEDGER

Read verified runs

Query the public ledger, fetch a single proof packet, or download its deterministic five-second replay.

GET/runs?limit=20
GET/runs/{runId}
GET/runs/{runId}/replay.mp4
05
SENSORIMOTOR CONTROL

Control a webpage snapshot

First convert a public HTTPS page into a safe, read-only target map. Then submit live viewport, cursor, and target geometry. Each step returns movement derived from measured descending-neuron activity.

POST/control/pages
POST/control/steps

Private networks, credentials, scripts, forms, and cookies are blocked from page snapshots.

06
ACCESS

Public beta limits

Read endpoints60 requests / minute
Challenges6 requests / minute
Page snapshots12 requests / minute
Control steps120 requests / minute
Replay videos8 requests / minute

Every limited response includes X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset. For higher limits, contact @userflydev.

DATA + INTERPRETATION

Built with the FlyEM male CNS v1.0 connectome under CC-BY 4.0. Results are measured responses from an experimental leaky integrate-and-fire mapping; they are not claims of animal intent, consciousness, or webpage comprehension.

COPIED