Extraction API؛ استخراج فیلدهای تایپ‌دار از متن و تصویر

curl https://1ai.ir/v1/extraction \
  -H "Authorization: Bearer $ONEAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "cloudflare/clairic",
    "state": "فاکتور شماره INV-2291 از شرکت نوین، تاریخ 2026-09-02، مهلت پرداخت ۳۰ روز. ۴ پالت هر کدام ۲۵۰ دلار و هزینه ارسال ۸۰ دلار.",
    "fields": {
      "invoice_number": { "type": "text" },
      "issue_date": { "type": "date" },
      "due_date": { "type": "date", "instructions": "تاریخ صدور به‌علاوه‌ی مهلت پرداخت" },
      "total": { "type": "number", "decimals": 2, "instructions": "مبلغ کل با هزینه ارسال" },
      "po_number": { "type": "text", "instructions": "شماره سفارش خرید" }
    }
  }'

# pip install requests
import base64, os, requests

with open("receipt.jpg", "rb") as f:
    image = "data:image/jpeg;base64," + base64.b64encode(f.read()).decode()

res = requests.post(
    "https://1ai.ir/v1/extraction",
    headers={"Authorization": f"Bearer {os.environ['ONEAI_API_KEY']}"},
    json={
        "model": "cloudflare/clairic",
        "images": [image],
        "fields": {
            "store": {"type": "text"},
            "total": {"type": "number", "decimals": 2},
            "items": {"type": "list", "items": "text"},
        },
    },
    timeout=120,
)
res.raise_for_status()
for name, answer in res.json()["answers"].items():
    print(name, answer["value"])  # None means "not established": never fall back to guess

{
  "model": "cloudflare/clairic",
  "answers": {
    "invoice_number": { "type": "text", "value": "INV-2291", "guess": "INV-2291", "confidence": 0.99, "p_null": 0.00001, "span": [13, 21] },
    "due_date": { "type": "date", "value": "2026-10-02", "confidence": 0.99 },
    "total": { "type": "number", "value": 1080, "confidence": 0.99 },
    "po_number": { "type": "text", "value": null, "guess": "INV-2291", "confidence": 0.99, "p_null": 1 }
  },
  "truncated": false,
  "usage": { "state_tokens": 61, "image_tokens": 0, "schema_tokens": 472, "input_tokens": 655, "output_tokens": 0, "passes": 3 }
}