# BRAINIAC Solar Battery Inverter Fault Classifier

> BRAINIAC Solar Battery Inverter Fault Classifier is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.04/call, status unknown (last checked 2026-11-12).

Classifies inverter fault codes and messages from solar-battery systems into categorized, severity-rated fault events using caller-supplied fault maps and keyword analysis

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/solar-battery/inverter-fault-classify?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-solar-battery-inverter-fault-classifier-0ca4221e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_f6eVyhsqV5iwU5RTY3pEB

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability brainiac-solar-battery-inverter-fault-classifier-0ca4221e -d '<json body>'
```

Example prompt: Classify the inverter faults in this CSV log from my solar-battery site SITE-A — use the fault map I'll provide with codes like F01 for grid overvoltage and ISO for isolation faults, and tell me the severity and category of each event.

## When to prefer this

Use this endpoint when you need structured, severity-rated fault classification from raw inverter logs without requiring cloud platform credentials or manufacturer API keys. It is ideal for agents processing caller-supplied fault maps and log data in CSV, JSON, or plain text format, and when you want a fully self-contained, pay-per-call analysis with no account setup. Prefer alternatives if you need live cloud-platform inverter data, real-time streaming, or manufacturer-specific fault catalog lookups.

## Known failure modes

- Unrecognized fault codes with no caller-supplied fault map result in keyword-only classification with lower confidence
- Missing or malformed CSV/JSON input returns a validation error
- Fault codes not matching any keyword or fault map entry may be unclassified or omitted
- Truncated input exceeding maxLength limits may result in partial analysis
- Ambiguous or unlabeled log formats may produce no events if structure cannot be parsed

## How this service works

Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.

## Output

A JSON object containing an array of classified fault events, each with timestamp, ID, fault code, label, category (e.g. grid, insulation), severity (warn/fault), detection method, and source. Also includes an overall status, event count, per-category counts, top-level findings, and a list of limitations (e.g. no cloud platform queried, no manufacturer catalog used). Flags indicate whether an API key, paid provider, or cloud platform was used (always false for this endpoint).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "csv": {
   "type": "string",
   "maxLength": 200000
  },
  "asOf": {
   "type": "string",
   "maxLength": 40
  },
  "file": {
   "type": "object",
   "required": [
    "mediaType",
    "fileBase64"
   ],
   "properties": {
    "filename": {
     "type": "string",
     "maxLength": 180,
     "minLength": 1
    },
    "mediaType": {
     "enum": [
      "text/plain",
      "text/csv",
      "application/json"
     ],
     "type": "string"
    },
    "fileBase64": {
     "type": "string",
     "maxLength": 12000000,
     "minLength": 1
    }
   },
   "additionalProperties": false
  },
  "json": {
   "type": "string",
   "maxLength": 200000
  },
  "text": {
   "type": "string",
   "maxLength": 200000
  },
  "assets": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "kind": {
      "type": "string",
      "maxLength": 80
     },
     "name": {
      "type": "string",
      "maxLength": 160
     },
     "region": {
      "type": "string",
      "maxLength": 120
     },
     "source": {
      "type": "string",
      "maxLength": 200
     },
     "capacityKw": {
      "type": "number",
      "maximum": 1000000,
      "minimum": 0
     },
     "capacityKwh": {
      "type": "number",
      "maximum": 1000000000,
      "minimum": 0
     },
     "installedAt": {
      "type": "string",
      "maxLength": 40
     }
    },
    "additionalProperties": false
   },
   "maxItems": 200
  },
  "panels": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "name": {
      "type": "string",
      "maxLength": 160
     },
     "source": {
      "type": "string",
      "maxLength": 200
     },
     "assetId": {
      "type": "string",
      "maxLength": 80
     },
     "measuredAt": {
      "type": "string",
      "maxLength": 40
     },
     "measuredKw": {
      "type": "number",
      "maximum": 1000000,
      "minimum": 0
     },
     "installedAt": {
      "type": "string",
      "maxLength": 40
     },
     "nameplateKw": {
      "type": "number",
      "maximum": 1000000,
      "minimum": 0
     },
     "priorMeasuredAt": {
      "type": "string",
      "maxLength": 40
     },
     "priorMeasuredKw": {
      "type": "number",
      "maximum": 1000000,
      "minimum": 0
     }
    },
    "additionalProperties": false
   },
   "maxItems":
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "at": "2026-11-01T10:00:00.000Z",
    "id": "E1",
    "code": "F01",
    "label": "Grid overvoltage",
    "method": "caller_fault_map",
    "source": "Caller-supplied inverter log",
    "assetId": "SITE-A",
    "message": "Grid overvoltage",
    "category": "grid",
    "severity": "warn",
    "cloudPlatformUsed": false
   },
   {
    "at": "2026-11-01T11:00:00.000Z",
    "id": "E2",
    "code": "ISO",
    "label": "Ground/isolation signal in supplied text",
    "method": "keyword",
    "source": "Caller-supplied inverter log",
    "assetId": "SITE-A",
    "message": "Isolation fault detected",
    "category": "insulation",
    "severity": "fault",
    "cloudPlatformUsed": false
   }
  ],
  "status": "classified",
  "findings": [],
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "categories": [
   {
    "count": 1,
    "category": "grid"
   },
   {
    "count": 1,
    "category": "insulation"
   }
  ],
  "eventCount": 2,
  "limitations": [
   "Generation, panel, inverter, battery, warranty, efficiency, consumption, and asset records are copied only from labeled fields supplied by the caller.",
   "No inverter cloud platform or paid energy monitoring service is used and no API key is required.",
   "Degradation, SOH, efficiency, and deviation metrics use only supplied measurements. Missing values are not invented.",
   "Inverter fault labels come from caller-supplied fault maps or simple keyword signals in supplied messages. Manufacturer cloud catalogs are not queried.",
   "Warranty comparisons use only caller-supplied warranty thresholds and measured values. Legal warranty coverage is not determined."
  ],
  "apiKeyRequired": false,
  "paidProviderUsed": false,
  "cloudPlatformUsed": false,
  "warrantyCoverageDetermined": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-solar-battery-inverter-fault-classifier-0ca4221e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
