# Nova AI Inference API — Structured Data Extraction

> Nova AI Inference API — Structured Data Extraction is a paid API for AI agents from ova.orbonomy.xyz, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-16).

Extracts structured data from unstructured text using AI, optionally guided by a target schema and custom instructions, paid per-call in USDC on Base.

## Facts

- Endpoint: POST https://ova.orbonomy.xyz/api/extract
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nova-ai-inference-api-structured-data-extraction-b68e9608
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_v2sPmq1vjZEZ-d6B8pwpi

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 nova-ai-inference-api-structured-data-extraction-b68e9608 -d '<json body>'
```

Example prompt: Extract the invoice number, date, vendor name, and total amount from this text: 'Invoice #INV-2041 issued by Acme Corp on March 15 2025 for a total of $4,320.00 including tax.' Return it as structured JSON with a confidence score.

## When to prefer this

Use this endpoint when you need to turn free-form or semi-structured text into a typed, schema-conformant JSON object and want a confidence score alongside the result. Ideal for invoice parsing, form extraction, entity recognition, or any NLP pipeline that requires pay-per-call pricing in USDC without subscription overhead.

## Known failure modes

- Missing required 'text' field returns a 400-level error
- Text too long for model context window may fail or truncate
- Malformed 'schema' object may produce unstructured or empty 'extracted' output
- Low confidence scores indicate ambiguous or insufficient input text
- Payment failure (insufficient USDC balance) returns 402 Payment Required
- Network timeout or upstream model outage returns 5xx

## How this service works

Pay-per-call AI inference. Chat, reason, translate, analyze, generate. USDC on Base.

## Output

Returns a JSON object containing an 'extracted' field with the structured data parsed from the input text, a 'confidence' number (0–1) indicating extraction certainty, the model name used, and token usage stats. Wrapped in a 'data' envelope with a boolean 'success' flag.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "text"
 ],
 "properties": {
  "text": {
   "type": "string",
   "description": "Text to extract data from"
  },
  "schema": {
   "type": "object",
   "description": "Expected output schema"
  },
  "instructions": {
   "type": "string",
   "description": "Additional extraction instructions"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "object",
   "properties": {
    "model": {
     "type": "string"
    },
    "usage": {
     "type": "object"
    },
    "extracted": {
     "type": "object"
    },
    "confidence": {
     "type": "number"
    }
   }
  },
  "meta": {
   "type": "object"
  },
  "success": {
   "type": "boolean"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nova-ai-inference-api-structured-data-extraction-b68e9608/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ova.orbonomy.xyz](https://www.zero.xyz/host/ova.orbonomy.xyz/llms.txt)