Fitur pemahaman PDF memungkinkan model mengurai teks dan gambar dalam dokumen PDF, serta menganalisisnya melalui Chat Completions, Responses API, DashScope, atau API kompatibel Anthropic.
Model yang Didukung
qwen4-max, qwen3.8-max, qwen3.8-max-0902, qwen3.8-flash, qwen3.8-27b
qwen3.8-27b hanya mendukung pemahaman PDF di wilayah Beijing melalui Chat Completions atau DashScope.
Mulai Cepat
Jalankan kode berikut untuk mengirimkan file PDF ke model.
Anda harus telah mendapatkan dan mengonfigurasi Kunci API serta mengonfigurasi Kunci API sebagai variabel lingkungan.
- Kompatibel OpenAI
- DashScope
- Responses API
- Anthropic
- Python
- Node.js
- HTTP
Kode Contoh
Menggunakan Input Base64
Jika Anda tidak dapat menyediakan URL file, Anda juga dapat mengirimkan file PDF sebagai string yang diencode Base64. Saat menggunakan file_data, bidang filename wajib diisi.
Encoding Base64 meningkatkan ukuran data sekitar 1/3. Misalnya, file 150MB menjadi sekitar 200MB setelah diencode, yang melebihi batas ukuran body permintaan. Untuk file besar, gunakan metode URL sebagai gantinya.
- Chat Completions / DashScope
- Anthropic
Parameter Permintaan
Tabel parameter berikut berlaku untuk Chat Completions. Responses API menggunakan type: "input_file" dan file_url; API kompatibel Anthropic menggunakan type: "document" dan menetapkan type: "base64", media_type: "application/pdf", serta data (string Base64 tanpa prefiks Data URI) dalam source. DashScope mengirimkan file melalui elemen dalam array content yang berisi file_url atau file_data. Untuk input URL, type wajib diisi dan bernilai tetap document; source adalah objek wajib, dengan type berupa string wajib bernilai url, dan url berupa string wajib yang menentukan URL file PDF.
Dalam protokol, bagian URL hanya mendukung input string, bukan bentuk list (array).
Parameter | Tipe | Wajib atau Tidak | Deskripsi |
|---|---|---|---|
| file_url | string | Wajib (pilih salah satu dari keduanya) | Alamat unduhan file PDF. Parameter ini atau file_data wajib diisi salah satu. |
| file_data | string | Input file PDF dalam format Base64, dengan format data:application/pdf;base64,xxx. Parameter ini atau file_url wajib diisi salah satu. | |
| filename | string | Wajib bersyarat | Nama file. Wajib diisi saat file_data digunakan sebagai parameter input. |
| file_format | string | Tidak | Format file. Opsional. Saat ini hanya pdf yang didukung, dan nilai default-nya adalah pdf. |
Batasan
Item | Batas |
|---|---|
| Batas ukuran file tunggal | 150MB |
| Batas jumlah halaman per dokumen | 256 halaman |
Parsing PDF dapat memerlukan waktu lebih lama daripada permintaan teks biasa. Timeout token pertama dapat mencapai 300 detik. Kami merekomendasikan menggunakan keluaran streaming untuk mendapatkan hasil secara real-time dan menghindari penantian yang lama.
Rincian Penagihan
Penagihan mencakup aspek-aspek berikut:
- Biaya pemanggilan model: Teks dan gambar yang diurai dari file PDF dihitung sebagai token input model dan ditagih dengan harga input standar model.
- Biaya parsing dokumen: Ditagih berdasarkan jumlah halaman PDF yang diurai, dengan harga satuan yang bervariasi menurut wilayah: Tiongkok (Beijing) $0.003/halaman, Singapura $0.0033/halaman. Mode deployment global: $0.003/halaman.
Melihat jumlah halaman PDF yang diurai
Responses API dari qwen4-max menggunakan tool_usage tingkat teratas respons, dengan num_requests setiap alat sebagai jumlah panggilan yang ditagih, dan pdf_page_parser.num_requests sebagai jumlah halaman yang diurai. Contoh Responses untuk Qwen3.8 masih menggunakan usage.x_tools.
Chat Completions dan Responses API (Qwen3.8) dapat mengirimkan include_tool_usage: true pada tingkat teratas body permintaan dan melihat jumlah halaman yang diurai dari usage.x_tools.pdf_page_parser.count; untuk DashScope, lihat dari usage.plugins.pdf_page_parser.count. Jumlah halaman yang diurai yang dikembalikan oleh API kompatibel Anthropic berada pada tingkat teratas respons di x_tools.pdf_page_parser.count. Jika jumlah parsing tidak dikembalikan, itu tidak berarti tidak ada biaya parsing yang dikenakan untuk permintaan ini.