Send a file. Get answers.
One API call.

// Send a file + schema. Get verified, computed answers back.
import { TheDriveAI } from "@thedriveai/sdk";

const client = new TheDriveAI({ apiKey: "tda_live_..." });

const result = await client.analyze({
  file: "invoice.pdf",
  schema: {
    math_checks_out: { type: "boolean", description: "Do line items add up to the stated total?" },
    discrepancy:     { type: "number", description: "Dollar difference, if any" },
    correct_total:   { type: "number", description: "Recalculated total from line items + tax" },
  },
});

// → result.data.math_checks_out    → false
// → result.reasoning.math_checks_out → "$3,200 + $1,550 + $890 = $5,640, not $5,740"
// → result.data.discrepancy         → 100
// → result.data.correct_total       → 6091.20

# Send a file + schema. Get verified, computed answers back.
from thedriveai import TheDriveAI

client = TheDriveAI(api_key="tda_live_...")

result = client.analyze(
    file="invoice.pdf",
    schema={
        "math_checks_out": {"type": "boolean", "description": "Do line items add up to the stated total?"},
        "discrepancy":     {"type": "number", "description": "Dollar difference, if any"},
        "correct_total":   {"type": "number", "description": "Recalculated total from line items + tax"},
    },
)

# → result.data["math_checks_out"]    → False
# → result.reasoning["math_checks_out"] → "$3,200 + $1,550 + $890 = $5,640, not $5,740"
# → result.data["discrepancy"]         → 100
# → result.data["correct_total"]       → 6091.20

# Send a file + schema. Get verified, computed answers back.
curl -X POST https://dev.thedrive.ai/api/v1/analyze \
  -H "X-API-Key: tda_live_..." \
  -F file=@invoice.pdf \
  -F 'schema={
    "math_checks_out": {"type": "boolean", "description": "Do line items add up to the stated total?"},
    "discrepancy":     {"type": "number", "description": "Dollar difference, if any"},
    "correct_total":   {"type": "number", "description": "Recalculated total from line items + tax"}
  }'

# → {"data": {"math_checks_out": false, "discrepancy": 100, "correct_total": 6091.20},
#    "reasoning": {"math_checks_out": "$3,200 + $1,550 + $890 = $5,640, not $5,740", ...},
#    "confidence": {"math_checks_out": 0.97, "discrepancy": 0.97, "correct_total": 0.99}}

// Pull literal values from any file or URL. Fast path extraction.
import { TheDriveAI } from "@thedriveai/sdk";

const client = new TheDriveAI({ apiKey: "tda_live_..." });

const result = await client.extract({
  file: "contract.pdf",
  schema: {
    parties:        { type: "array", description: "All parties" },
    effective_date: { type: "string", description: "Start date (ISO 8601)" },
    liability_cap:  { type: "number", description: "Maximum liability", required: true },
  },
});

// → result.data.parties        → ["Acme Corp", "Globex Inc"]
// → result.data.liability_cap  → 500000
// → result.confidence.parties  → 0.96
// → result.citations.liability_cap → "...not exceed $500,000"

# Pull literal values from any file or URL. Fast path extraction.
from thedriveai import TheDriveAI

client = TheDriveAI(api_key="tda_live_...")

result = client.extract(
    file="contract.pdf",
    schema={
        "parties":        {"type": "array", "description": "All parties"},
        "effective_date": {"type": "string", "description": "Start date (ISO 8601)"},
        "liability_cap":  {"type": "number", "description": "Maximum liability", "required": True},
    },
)

# → result.data["parties"]        → ["Acme Corp", "Globex Inc"]
# → result.data["liability_cap"]  → 500000
# → result.confidence["parties"]  → 0.96
# → result.citations["liability_cap"] → "...not exceed $500,000"

# Pull literal values from any file or URL. Fast path extraction.
curl -X POST https://dev.thedrive.ai/api/v1/extract \
  -H "X-API-Key: tda_live_..." \
  -F file=@contract.pdf \
  -F 'schema={
    "parties":        {"type": "array", "description": "All parties"},
    "effective_date": {"type": "string", "description": "Start date (ISO 8601)"},
    "liability_cap":  {"type": "number", "description": "Maximum liability", "required": true}
  }'

# → {"data": {"parties": ["Acme Corp", "Globex Inc"],
#            "effective_date": "2025-01-15",
#            "liability_cap": 500000},
#    "confidence": {"parties": 0.96, "liability_cap": 0.93},
#    "citations": {"liability_cap": "...not exceed $500,000"}}