Chat dengan API PDF
Jawab pertanyaan PDF dengan bukti terikat revisi dan berlabel halaman menggunakan model AI yang disetujui dan penerimaan kutipan wajib.
Menjawab pertanyaan berdasarkan PDF sumber#
Gunakan operasi pdfhq.ai.chat dengan pertanyaan hingga 2.000 karakter, unggahan terverifikasi, dan penawaran HQTools yang cocok. Obrolan PDF tunggal memerlukan kuantitas 1. Obrolan multi-dokumen opsional mendukung hingga empat PDF saat diaktifkan setelah sertifikasi tarif HQTools. Segel setiap PDF terlebih dahulu; kuantitas penawaran harus sama dengan jumlah dokumen. Semua unggahan milik akun dan proyek API yang sama; bersama-sama mereka harus berjumlah paling banyak 12 MiB. Pekerja mengurutkan kutipan yang tidak dapat diubah di seluruh sumber dan menolak ID kutipan yang tidak didukung atau dibuat-buat.
POST https://api.pdfhq.io/v1/ai/jobs
x-api-key: PROJECT_API_KEY
Idempotency-Key: stable-idempotency-key
Content-Type: application/json
{"operation":"pdfhq.ai.chat","upload_id":"UPLOAD_UUID","quote_id":"QUOTE_ID","question":"Which invoices are overdue?","allow_external_ai":true,"allow_ocr":false}Obrolan multi-dokumen (saat tersedia)#
GET /v1/ai/billing/prices menampilkan multi_document_available, yang dinonaktifkan secara bawaan. Untuk tiga PDF yang diunggah, minta penawaran tarif obrolan aktif dengan kuantitas 3. Unggahan asli adalah Dokumen 1 dan additional_upload_ids adalah Dokumen 2 serta 3.
POST https://api.pdfhq.io/v1/ai/billing/quotes
x-api-key: PROJECT_API_KEY
Content-Type: application/json
{"price_id":"ACTIVE_CHAT_PRICE_ID","quantity":"3"}
POST https://api.pdfhq.io/v1/ai/jobs
x-api-key: PROJECT_API_KEY
Idempotency-Key: stable-multi-source-key
Content-Type: application/json
{"operation":"pdfhq.ai.chat","upload_id":"PDF_1_UUID","additional_upload_ids":["PDF_2_UUID","PDF_3_UUID"],"quote_id":"QUOTE_WITH_QUANTITY_3","question":"Which invoices are overdue?","allow_external_ai":true,"allow_ocr":false}Menggunakan kembali kunci idempotency dengan set sumber yang berbeda mengembalikan 409. Revisi sumber yang hilang atau berubah, unggahan lintas akun, atau kutipan yang tidak cukup ditolak sebelum inferensi penyedia. Kutipan mengidentifikasi dokumen sumber dan halaman PDF asli.
Percakapan multi-putaran pribadi (hingga empat putaran)#
Lanjutkan obrolan yang berhasil tanpa mengunggah PDF lagi. Setiap tindak lanjut memerlukan penawaran segar, persetujuan dan kunci idempotency baru. Lewati previous_job_id tetapi abaikan upload_id dan additional_upload_ids: backend mewarisi sumber PDF yang diverifikasi SHA-256 milik akun dan proyek yang sama persis. Tindak lanjut multi-dokumen memerlukan penawaran yang cocok dengan jumlah untuk semua PDF yang diwarisi. Menggunakan kembali penawaran lama atau mengubah dokumen bukan jalan pintas yang diizinkan.
# Review cited results, then quote the NEXT turn
GET https://api.pdfhq.io/v1/ai/jobs/FIRST_CHAT_JOB_UUID/conversation
x-api-key: PROJECT_API_KEY
POST https://api.pdfhq.io/v1/ai/billing/quotes
x-api-key: PROJECT_API_KEY
Content-Type: application/json
{"price_id":"ACTIVE_CHAT_PRICE_ID","quantity":"1"}
POST https://api.pdfhq.io/v1/ai/jobs
x-api-key: PROJECT_API_KEY
Idempotency-Key: unique-follow-up-request-key
Content-Type: application/json
{"operation":"pdfhq.ai.chat","previous_job_id":"FIRST_CHAT_JOB_UUID","quote_id":"NEW_QUOTE_ID","question":"What happens if that payment is late?","allow_external_ai":true,"allow_ocr":false}Hanya hingga tiga putaran sebelumnya yang dapat disertakan. Jawaban sebelumnya adalah konteks percakapan yang tidak terpercaya, bukan bukti dokumenter: kutipan segar harus menunjuk ke kutipan PDF yang diverifikasi saat ini. Hasil yang dihapus atau kedaluwarsa dan proyek API asing tidak dapat digunakan kembali. Mulai obrolan baru untuk mengubah dokumen sumber.
Jawaban respons dihasilkan model dan harus diperiksa. Sistem memverifikasi ID kutipan, bukan kebenaran inferensi. Teks yang hilang, pemindaian yang buruk, dan konteks pengambilan terbatas dapat membuat jawaban yang benar menjadi tidak mungkin.
