PDF.chat API

பொதுவான

PDF.chat API ஒரு சிறிய REST இடைமுகம். முதலில் நீங்கள் POST ஆவணத்தை உள்வாங்கவும் ஆவணத்தின் உரை மற்றும் பக்கம் பிரிவு (உரை, எல்லை பெட்டிகள், நம்பிக்கை) உடன் ஒரு வேலையை திரும்ப பெறவும். பின்னர் நீங்கள் POST அந்த வேலைக்கு எதிரான கேள்விகள் மற்றும் ஆவணத்தில் உள்ள பதில்களை பெறு, ஒவ்வொரு பக்கமும் அது வந்த பக்கத்தை குறிப்பிடுகிறது.5பக்கங்கள் அல்லது குறைவான பணிகள் உள்ளமைவில் திரும்பும்; பெரிய பணிகள் உடனடியாக ஒரு pending நீங்கள் வரை வாக்களிக்கும் நிலை done.

• அடிப்படை URL: https://pdf.chat
• ஆவணங்கள்: PDF, மேலும் Word, PowerPoint, உரை மற்றும் படங்கள் (PNG, JPG, WEBP, GIF, BMP, TIFF)
• Chat வெளியே: பக்கம் குறிப்புகளுடன் பதில்கள்; வரலாறு முடிவு புள்ளி மூலம் நகலெடுப்பு
• செயல்படுத்தப்பட்ட உரை வெளியே: txt, md, docx, pdf, csv, json
• படிக்கும் இயந்திரங்கள்: cpu (விரைவான, அச்சிடப்பட்ட ஆவணங்கள்) மற்றும் vlm (முக்கிய AI, கை எழுத்து, சிக்கலான உருவரை, கணித)

உரிமம்

உங்களின் அடையாளத்தை உறுதிசெய் API குறியீடு (உங்கள் அதை கண்டுபிடிக்க கணக்கு பக்கம்) ஒரு பைரர் தலைப்பாக:

Authorization: Bearer YOUR_API_TOKEN

நீங்கள் கூட கடந்து ?api_token=… கேள்வி அளவுருவாக. பயன்பாடு உங்கள் கணக்கின் பக்க சமநிலைக்கு எதிராக அளவிடப்படுகிறது.

ஆவணத்தை அனுப்பு

POST /api/v1/ocr/, பலபகுதி வடிவம் ஏற்றம்.

curl -X POST https://pdf.chat/api/v1/ocr/ \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "file=@invoice.pdf" \
  -F "tier=vlm" \
  -F "language=auto"

பணியை திரும்பும். ≤5- பக்க கோப்புகளுக்கு இது ஏற்கனவே உள்ளது done உரைகளுடன்; பெரிய கோப்புகள் திரும்ப வருகின்றன pending/processingநிலை முடிவு புள்ளியை கேட்கவும்.

{
  "uuid": "9f2c1b7e4a...",
  "status": "done",
  "tier": "vlm",
  "language": "auto",
  "page_count": 1,
  "mean_confidence": 0.98,
  "text": "INVOICE\nAcme Corp\nTotal: 215.00 USD",
  "markdown": "# INVOICE\n\n**Acme Corp** ...",
  "pages": [ { "index": 0, "text": "...", "blocks": [ { "text": "...", "bbox": [x0,y0,x1,y1], "confidence": 0.98 } ] } ]
}

ஒரு முடிவு பெறு

GET /api/v1/ocr/<uuid>/, வரை வினவவும் status உள்ளது done அல்லது failed.

curl https://pdf.chat/api/v1/ocr/9f2c1b7e4a.../ \
  -H "Authorization: Bearer YOUR_API_TOKEN"

வடிவத்தை இறக்கு

GET /api/v1/ocr/<uuid>/download/?format=md, முடிவுகளை ஏற்றுமதி செய் format ஒன்றாகும் txt, md, docx, pdf, csv, json.

curl -L "https://pdf.chat/api/v1/ocr/9f2c1b7e4a.../download/?format=docx" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o result.docx

ஆவணத்துடன் Chat

முடிந்த பணி பற்றி கேள்வி கேட்கவும். பதில்கள் மட்டும் உரை மற்றும் மூல பக்கத்தை குறிப்பிடும். தேவைப்படும் கணக்கு குறி, chat வசதி கணக்கு- வாயில்.

POST /api/v1/chat/<uuid>/, JSON உடல் {"message": "your question"}.

curl -X POST https://pdf.chat/api/v1/chat/9f2c1b7e4a.../ \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"message": "What is the invoice total and due date?"}'

உதவியாளர் செய்தி மற்றும் அதன் பதில் மற்றும் குறிப்பிட்ட பக்கங்களின் பட்டியலுடன் திரும்பும்:

{"conversation": "a1b2…", "message": {
   "role": "assistant",
   "content": "The total is $42, due on March 3 (p. 1).",
   "citations": [{"page": 1, "cited_text": "The invoice total is $42…", "document_id": "9f2c1b7e4a…"}]
}}

GET /api/v1/chat/<uuid>/history/, ஒரு பணிக்கான முழு உரையாடலின் நகலை பெறுக.

குறியீட்டு உதாரணங்கள்

• Python
• Node.js
• cURL

import requests, time

BASE = "https://pdf.chat/api/v1"
H = {"Authorization": "Bearer YOUR_API_TOKEN"}

# 1. Upload a PDF
with open("contract.pdf", "rb") as f:
    job = requests.post(BASE + "/ocr/", headers=H, files={"file": f}).json()

# 2. Wait until it's ready to chat
while job["status"] in ("pending", "processing"):
    time.sleep(2)
    job = requests.get(f"{BASE}/ocr/{job['uuid']}/", headers=H).json()

# 3. Ask questions — every answer is cited to the page
ans = requests.post(f"{BASE}/chat/{job['uuid']}/", headers=H,
    json={"message": "What is the termination notice period?"}).json()
print(ans["message"]["content"])
print(ans["message"]["citations"])

import fs from "fs";

const BASE = "https://pdf.chat/api/v1";
const H = { Authorization: "Bearer YOUR_API_TOKEN" };

// 1. Upload a PDF
const form = new FormData();
form.append("file", new Blob([fs.readFileSync("contract.pdf")]), "contract.pdf");
let job = await (await fetch(`${BASE}/ocr/`, { method: "POST", headers: H, body: form })).json();

// 2. Wait until it's ready to chat
while (["pending", "processing"].includes(job.status)) {
  await new Promise(r => setTimeout(r, 2000));
  job = await (await fetch(`${BASE}/ocr/${job.uuid}/`, { headers: H })).json();
}

// 3. Ask questions — every answer is cited to the page
const ans = await (await fetch(`${BASE}/chat/${job.uuid}/`, {
  method: "POST", headers: { ...H, "Content-Type": "application/json" },
  body: JSON.stringify({ message: "What is the termination notice period?" })
})).json();
console.log(ans.message.content, ans.message.citations);

# 1. Upload a PDF
curl -X POST https://pdf.chat/api/v1/ocr/ \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "file=@contract.pdf"

# 2. Ask questions (use the uuid from step 1) — answers cited to the page
curl -X POST https://pdf.chat/api/v1/chat/UUID/ \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"message": "What is the termination notice period?"}'

அளபுருக்கள்

பிழைகள் & வரம்புகள்

ஒவ்வொரு பக்கமும் செயலாக்க செலவுகள் (1/ பக்கம் வேகமான நிலையில், அதிகம் பிரீமியம்). செலுத்தப்பட்ட திட்டங்கள் கோப்பு பக்க அளவை உயர்த்தவும் முன்னுரிமை சேர்க்கவும். பார்க்கவும் விலை நிர்ணயம்.

அடிக்கடி கேட்கப்படும் கேள்விகள்