POST /api/single/process

POST /api/single/process

Authorization: Bearer <your_token>

multipart/form-data

{
  "pdf_file": "<binary data>",
  "config": "{\"api_key\":\"sk-or-v1-...\",\"model_name\":\"openai/gpt-4o-mini\",\"num_pages\":3,\"num_tags\":8,\"exclusion_words\":[\"government\",\"report\"]}"
}

{
  "success": true,
  "document_title": "Training Manual for Digital Governance",
  "tags": [
    "digital-governance",
    "e-learning",
    "skill-development",
    "capacity-building",
    "training-manual",
    "best-practices",
    "implementation-guide",
    "knowledge-sharing"
  ],
  "extracted_text_preview": "Chapter 1: Introduction to Digital Governance\n\nDigital governance encompasses the policies, procedures, and frameworks that guide the use of digital technologies in government operations. This manual provides comprehensive training on implementing digital governance initiatives at the state and local levels...",
  "processing_time": 4.23,
  "is_scanned": false,
  "extraction_method": "pypdf2",
  "ocr_confidence": null,
  "raw_ai_response": "digital-governance, e-learning, skill-development, capacity-building, training-manual, best-practices, implementation-guide, knowledge-sharing",
  "error": null
}

{
  "detail": "Please provide either a PDF file OR a URL, not both."
}

{
  "detail": "Please provide either a PDF file or a PDF URL."
}

{
  "detail": "Invalid file type. Please upload a PDF file."
}

{
  "detail": "Invalid URL. Must start with http:// or https://"
}

{
  "detail": "Invalid config JSON format"
}

{
  "detail": "Could not extract sufficient text from PDF. The document might be scanned or image-based without OCR support."
}

{
  "detail": "Not authenticated"
}

{
  "detail": "Tag generation failed: <error message>"
}

curl -X POST "http://localhost:8000/api/single/process" \
  -H "Authorization: Bearer <your_token>" \
  -F "pdf_file=@/path/to/document.pdf" \
  -F 'config={"api_key":"sk-or-v1-...","model_name":"openai/gpt-4o-mini","num_pages":3,"num_tags":8}'

curl -X POST "http://localhost:8000/api/single/process" \
  -H "Authorization: Bearer <your_token>" \
  -F "pdf_url=https://example.com/document.pdf" \
  -F 'config={"api_key":"sk-or-v1-...","model_name":"openai/gpt-4o-mini","num_pages":3,"num_tags":8}'

curl -X POST "http://localhost:8000/api/single/process" \
  -H "Authorization: Bearer <your_token>" \
  -F "pdf_file=@/path/to/document.pdf" \
  -F 'config={"api_key":"sk-or-v1-...","model_name":"openai/gpt-4o-mini","num_pages":3,"num_tags":8}' \
  -F "exclusion_file=@/path/to/exclusion-list.txt"

const formData = new FormData();
formData.append('pdf_file', pdfFile); // File object

const config = {
  api_key: 'sk-or-v1-...',
  model_name: 'openai/gpt-4o-mini',
  num_pages: 3,
  num_tags: 8,
  exclusion_words: ['government', 'report']
};
formData.append('config', JSON.stringify(config));

const response = await fetch('http://localhost:8000/api/single/process', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`
  },
  body: formData
});

const result = await response.json();
console.log('Generated tags:', result.tags);