Dukungan PDF

Anda dapat bertanya kepada Claude tentang teks, gambar, grafik, dan tabel apa pun dalam PDF yang Anda berikan. Beberapa contoh kasus penggunaan:

• Menganalisis laporan keuangan dan memahami grafik/tabel
• Mengekstrak informasi penting dari dokumen hukum
• Bantuan penerjemahan untuk dokumen
• Mengonversi informasi dokumen ke dalam format terstruktur

Sebelum Anda mulai

Periksa persyaratan PDF

Claude dapat bekerja dengan PDF standar apa pun. Pastikan ukuran permintaan Anda memenuhi persyaratan berikut:

Kedua batas tersebut berlaku untuk seluruh payload permintaan, termasuk konten lain yang dikirim bersama PDF. Untuk PDF berukuran besar, pertimbangkan untuk mengunggah dengan Files API dan mereferensikannya melalui file_id agar payload permintaan tetap kecil.

Karena dukungan PDF bergantung pada kemampuan visi Claude, dukungan ini tunduk pada batasan dan pertimbangan yang sama seperti tugas visi lainnya.

Platform dan model yang didukung

Dukungan PDF tersedia di Claude API, Claude Platform on AWS, Amazon Bedrock (lihat Dukungan PDF Amazon Bedrock), Vertex AI, dan Microsoft Foundry. Semua model aktif mendukung pemrosesan PDF.

Dukungan PDF Amazon Bedrock

Saat menggunakan dukungan PDF melalui Converse API dari Bedrock, terdapat dua mode pemrosesan dokumen yang berbeda:

Mode pemrosesan dokumen

1. Converse Document Chat (Mode asli - Hanya ekstraksi teks)

   • Menyediakan ekstraksi teks dasar dari PDF
   • Tidak dapat menganalisis gambar, grafik, atau tata letak visual dalam PDF
   • Menggunakan sekitar 1.000 token untuk PDF 3 halaman
   • Digunakan secara otomatis ketika sitasi tidak diaktifkan

2. Claude PDF Chat (Mode baru - Pemahaman visual penuh)

   • Menyediakan analisis visual lengkap terhadap PDF
   • Dapat memahami dan menganalisis grafik, diagram, gambar, dan tata letak visual
   • Memproses setiap halaman sebagai teks dan gambar untuk pemahaman yang komprehensif
   • Menggunakan sekitar 7.000 token untuk PDF 3 halaman
   • Memerlukan sitasi diaktifkan di Converse API

Batasan utama

• Converse API: Analisis PDF visual memerlukan sitasi diaktifkan. Saat ini tidak ada opsi untuk menggunakan analisis visual tanpa sitasi (tidak seperti InvokeModel API).
• InvokeModel API: Menyediakan kontrol penuh atas pemrosesan PDF tanpa sitasi yang dipaksakan.

Masalah umum

Jika Claude tidak melihat gambar atau grafik dalam PDF Anda saat menggunakan Converse API, kemungkinan Anda perlu mengaktifkan flag sitasi. Tanpa itu, Converse akan kembali ke ekstraksi teks dasar saja.

Memproses PDF dengan Claude

Kirim permintaan PDF pertama Anda

Mari kita mulai dengan contoh sederhana menggunakan Messages API. Anda dapat memberikan PDF kepada Claude dengan tiga cara:

1. Sebagai referensi URL ke PDF yang dihosting secara online
2. Sebagai PDF yang dienkode base64 dalam blok konten document
3. Melalui file_id dari Files API

Opsi 1: Dokumen PDF berbasis URL

Pendekatan paling sederhana adalah mereferensikan PDF langsung dari URL:

client = anthropic.Anthropic()
message = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "document",
                    "source": {
                        "type": "url",
                        "url": "https://assets.anthropic.com/m/1cd9d098ac3e6467/original/Claude-3-Model-Card-October-Addendum.pdf",
                    },
                },
                {"type": "text", "text": "What are the key findings in this document?"},
            ],
        }
    ],
)

print(message.content)

Opsi 2: Dokumen PDF yang dienkode base64

Jika Anda perlu mengirim PDF dari sistem lokal Anda atau ketika URL tidak tersedia:

import base64
import httpx

# Pertama, muat dan enkode PDF
pdf_url = "https://assets.anthropic.com/m/1cd9d098ac3e6467/original/Claude-3-Model-Card-October-Addendum.pdf"
pdf_data = base64.standard_b64encode(httpx.get(pdf_url).content).decode("utf-8")

# Alternatif: Muat dari file lokal
# with open("document.pdf", "rb") as f:
#     pdf_data = base64.standard_b64encode(f.read()).decode("utf-8")

# Kirim ke Claude menggunakan enkode base64
client = anthropic.Anthropic()
message = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "document",
                    "source": {
                        "type": "base64",
                        "media_type": "application/pdf",
                        "data": pdf_data,
                    },
                },
                {"type": "text", "text": "What are the key findings in this document?"},
            ],
        }
    ],
)

print(message.content)

Opsi 3: Files API

Untuk PDF yang akan Anda gunakan berulang kali, atau ketika Anda ingin menghindari overhead encoding, gunakan Files API:

client = anthropic.Anthropic()

# Unggah file PDF
with open("document.pdf", "rb") as f:
    file_upload = client.beta.files.upload(file=("document.pdf", f, "application/pdf"))

# Gunakan file yang diunggah dalam pesan
message = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    betas=["files-api-2025-04-14"],
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "document",
                    "source": {"type": "file", "file_id": file_upload.id},
                },
                {"type": "text", "text": "What are the key findings in this document?"},
            ],
        }
    ],
)

print(message.content)

Cara kerja dukungan PDF

Ketika Anda mengirim PDF ke Claude, langkah-langkah berikut terjadi:

Perkirakan biaya Anda

Jumlah token dari file PDF bergantung pada total teks yang diekstrak dari dokumen serta jumlah halaman:

• Biaya token teks: Setiap halaman biasanya menggunakan 1.500-3.000 token per halaman tergantung pada kepadatan konten. Harga API standar berlaku tanpa biaya PDF tambahan.
• Biaya token gambar: Karena setiap halaman dikonversi menjadi gambar, perhitungan biaya berbasis gambar yang sama diterapkan.

Anda dapat menggunakan penghitungan token untuk memperkirakan biaya untuk PDF spesifik Anda.

Optimalkan pemrosesan PDF

Tingkatkan kinerja

Ikuti praktik terbaik berikut untuk hasil yang optimal:

• Tempatkan PDF sebelum teks dalam permintaan Anda
• Gunakan font standar
• Pastikan teks jelas dan mudah dibaca
• Putar halaman ke orientasi tegak yang benar
• Gunakan nomor halaman logis (dari penampil PDF) dalam prompt
• Bagi PDF besar menjadi beberapa bagian jika diperlukan
• Aktifkan caching prompt untuk analisis berulang

Skalakan implementasi Anda

Untuk pemrosesan bervolume tinggi, pertimbangkan pendekatan berikut:

Gunakan caching prompt

Cache PDF untuk meningkatkan kinerja pada kueri berulang:

client = anthropic.Anthropic()
# ...
message = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "document",
                    "source": {
                        "type": "base64",
                        "media_type": "application/pdf",
                        "data": pdf_data,
                    },
                    "cache_control": {"type": "ephemeral"},
                },
                {"type": "text", "text": "Analyze this document."},
            ],
        }
    ],
)

Proses batch dokumen

Gunakan Message Batches API untuk alur kerja bervolume tinggi:

client = anthropic.Anthropic()
# ...
message_batch = client.messages.batches.create(
    requests=[
        {
            "custom_id": "doc1",
            "params": {
                "model": "claude-opus-4-8",
                "max_tokens": 1024,
                "messages": [
                    {
                        "role": "user",
                        "content": [
                            {
                                "type": "document",
                                "source": {
                                    "type": "base64",
                                    "media_type": "application/pdf",
                                    "data": pdf_data,
                                },
                            },
                            {"type": "text", "text": "Summarize this document."},
                        ],
                    }
                ],
            },
        }
    ]
)

Langkah selanjutnya