NeuroCortex API reference

Mint a key in Billing. Tokens are shown once and stored as a SHA-256 hash. Pass them as a Bearer header.

Authorization: Bearer neurocortex_v2_live_<your-key>

Core conversational call. Add an optional persona to spin up a specialist.

curl -X POST https://bharatneurotech.com/api/public/v1/neurocortex/chat \
  -H "Authorization: Bearer neurocortex_v2_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{ "role": "user", "content": "Decode this pricing page in 3 bullets." }]
  }'

{
  "engine": "neurocortex",
  "model": "neurocortex-v2",
  "message": { "role": "assistant", "content": "..." },
  "finish_reason": "stop",
  "usage": { "prompt_tokens": 24, "completion_tokens": 96 }
}

Image audit. Send a public image_url or inline image_b64.

curl -X POST https://bharatneurotech.com/api/public/v1/neurocortex/scan \
  -H "Authorization: Bearer neurocortex_v2_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "image": { "image_url": "https://example.com/landing.png" },
    "prompt": "Audit this landing page for conversion friction.",
    "lens": "neuro-marketing"
  }'

{
  "engine": "neurocortex",
  "model": "neurocortex-v2",
  "result": { "markdown": "## Attention\n..." }
}

Send a transcript. Mode audit for persuasion/intent, meeting for decisions/owners/risks.

curl -X POST https://bharatneurotech.com/api/public/v1/neurocortex/listen \
  -H "Authorization: Bearer neurocortex_v2_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "transcript": "Speaker 1: We need to ship by Q3...",
    "mode": "meeting",
    "kind": "audio",
    "duration_minutes": 12
  }'

Returns an ordered execution plan you can run yourself across chat/scan/listen/form stages.

curl -X POST https://bharatneurotech.com/api/public/v1/neurocortex/plan \
  -H "Authorization: Bearer neurocortex_v2_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "goal": "Audit our pricing page and propose 3 tested edits.", "max_stages": 4 }'

{
  "engine": "neurocortex",
  "model": "neurocortex-v2",
  "plan": {
    "name": "Pricing audit",
    "stages": [
      { "kind": "scan", "title": "Visual audit", "purpose": "...", "inputs": ["image_url"] },
      { "kind": "chat", "title": "Friction synthesis", "purpose": "...", "inputs": [] }
    ]
  }
}

curl -X POST https://bharatneurotech.com/api/public/v1/neurocortex/tools/generate \
  -H "Authorization: Bearer neurocortex_v2_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "prompt": "A cognitive-bias detector for board meetings", "mode": "form" }'

curl -X POST https://bharatneurotech.com/api/public/v1/neurocortex/tools/run \
  -H "Authorization: Bearer neurocortex_v2_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "spec": {
      "name": "Bias Auditor",
      "discipline": "cognition",
      "systemPrompt": "Detect cognitive biases in board decisions.",
      "outputSections": [{"key":"biases","title":"Biases"},{"key":"moves","title":"Moves"}]
    },
    "values": { "decision": "We will pivot to enterprise sales." }
  }'

Every API call is metered at 2× the equivalent in-Lab price, deducted from the same wallet you use in /lab. Daily cap defaults to ₹5,000 per key (configurable).

curl https://bharatneurotech.com/api/public/v1/neurocortex/account -H "Authorization: Bearer neurocortex_v2_live_..."

{
  "engine": "neurocortex",
  "balance_paise": 9700,
  "balance_inr": 97,
  "daily": { "cap_paise": 500000, "used_paise": 1200, "request_count": 6 }
}

• 401 invalid_api_key — token missing, malformed, or revoked.
• 402 insufficient_credits — top up wallet in /billing.
• 403 ip_not_allowed — caller IP not in key's allowlist.
• 429 daily_cap_exceeded — per-key daily cap exhausted.
• 503 engine_unavailable — NeuroCortex temporarily down. Retry with backoff.