Skip to main content
NagaAI supports PDF file input for models with document understanding capabilities. You can send files in Chat Completions using the file content block. The file can be provided as a direct HTTPS URL (publicly accessible) or as base64-encoded data.

​
How to Send Files

​
Using File URLs

This is the most efficient way for publicly accessible files. 
{
  "model": "gpt-5-mini-2025-08-07",
  "messages": [
    {
      "role": "user",
      "content": [
        { "type": "text", "text": "Summarize this PDF briefly." },
        {
          "type": "file",
          "file": {
            "filename": "document.pdf",
            "file_data": "https://bitcoin.org/bitcoin.pdf"
          }
        }
      ]
    }
  ]
}

​
Using Base64-Encoded Files

For local or private files, encode the file as base64 and use a data URL: 
{
  "model": "gpt-5-mini-2025-08-07",
  "messages": [
    {
      "role": "user",
      "content": [
        { "type": "text", "text": "Summarize this PDF briefly." },
        {
          "type": "file",
          "file": {
            "filename": "document.pdf",
            "file_data": "data:application/pdf;base64,JVBERi0xLjQKJ..."
          }
        }
      ]
    }
  ]
}

​
Supported File Types

  • application/pdf (PDF only)

​
Notes

  • For URLs, files must be publicly accessible via HTTPS.
  • Large PDFs will count towards token usage after provider-side parsing.
  • For models without native file support, we may enable this via external tools in the future (e.g., OCR).

​
Discover Supported Models

You can see which models accept file (PDF) inputs on the NagaAI Models page (file filter).