Source: https://ailoot.ai/models/id/voyageai-rerank-2-5/ Canonical: https://ailoot.ai/models/id/voyageai-rerank-2-5/ Language: id # VoyageAI by MongoDB: rerank-2.5 [Markdown](https://ailoot.ai/models/id/voyageai-rerank-2-5/index.md) · [JSON](https://ailoot.ai/models/id/voyageai-rerank-2-5/facts.json) ## [VoyageAI by MongoDB: rerank-2.5](https://ailoot.ai/models/id/voyageai-rerank-2-5/) rerank-2.5 mengurutkan ulang kumpulan kandidat teks yang diberikan berdasarkan relevansi terhadap kueri dan instruksi bahasa alami opsional. Ini adalah reranker multibahasa yang berorientasi pada kualitas, dengan konteks kueri-dokumen 32.000 token dan skor berperingkat yang terkait dengan indeks kandidat asli. - [**Ailoot Ultra · Pemeringkatan ulang** `POST /v1/rerank` `voyageai/rerank-2.5`](https://ailoot.ai/models/id/voyageai-rerank-2-5/#method-0) Tentang model Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih. rerank-2.5 adalah reranker Voyage AI yang mengikuti instruksi, dirancang untuk menyempurnakan kumpulan kandidat pencarian. Model ini memeriksa kueri dan setiap dokumen secara bersamaan sebagai cross-encoder, lalu mengembalikan urutan relevansi. Rilis pembuat menekankan kendali bahasa alami atas hal yang dianggap relevan, pengambilan informasi multibahasa, dan konteks kueri-dokumen yang lebih panjang daripada edisi rerank-2 sebelumnya. #### Berikan kandidat yang perlu dibandingkan kepada model Masukannya adalah kueri dan daftar dokumen teks kandidat. Kandidat dapat berupa bagian teks yang dipilih pencarian embedding atau pencarian leksikal tahap pertama. Reranker mengevaluasi teks yang diberikan, bukan membuat embedding korpus, sehingga tugas praktisnya adalah menyempurnakan kandidat yang sudah ditemukan pencarian awal. Pertahankan urutan kandidat asli dan pengidentifikasi sumber saat menyiapkan daftar tersebut. Indeks yang dikembalikan merujuk pada posisi masukan itu. Untuk tugas RAG, berikan bagian teks yang mungkin benar-benar digunakan tahap jawaban, termasuk judul atau kondisi yang diperlukan untuk menafsirkannya. Dokumen relevan yang tidak ada dalam kumpulan kandidat yang dikirim tidak dapat muncul sebagai hasil yang baru ditemukan melalui pemeringkatan ulang. #### Tentukan pengertian relevansi yang dituju Instruksi dapat ditambahkan sesudah atau sebelum kueri. Rilis tersebut menjelaskan tiga peran yang berguna: menekankan bagian tertentu dari dokumen, mengutamakan jenis sumber, dan memperjelas kueri dengan konteks aplikasi. Ketiganya mengubah tugas relevansi yang disajikan kepada model. Untuk pencarian teknis, contoh instruksinya adalah “Prioritaskan bagian teks yang menjelaskan perilaku kegagalan dan pemulihan; gambaran pengantar bersifat sekunder.” Untuk kumpulan riset, tentukan apakah judul, metode, atau hasil yang paling penting. Untuk istilah yang ambigu, nyatakan bidang subjek pencarian. Jaga pertanyaan dan instruksi tetap selaras agar yang satu tidak meminta topik luas sementara yang lain diam-diam mengubah tugas. Preferensi ini memandu pemberian skor relevansi. Jika aplikasi memiliki persyaratan kelayakan ketat—seperti versi sumber, tanggal, atau cakupan akses—siapkan kumpulan kandidat yang memenuhi syarat secara terpisah. Instruksi relevansi model dan pembatasan koleksi deterministik melayani tujuan berbeda. #### Keluaran berperingkat dan penggunaan hasil berikutnya Hasil diurutkan berdasarkan relevansi menurun dan mencakup skor relevansi floating-point serta indeks masukan asli kandidat. Opsi top-k memilih jumlah hasil teratas yang dikembalikan; tanpa opsi tersebut, spesifikasi pembuat mengembalikan hasil untuk semua kandidat yang dikirim. Pengaturan return-documents opsional menyertakan teks sumber yang bersesuaian; jika tidak, respons memuat indeks dan skor. Gunakan urutan tersebut untuk memilih bagian teks yang akan ditampilkan atau digunakan pada tahap jawaban berikutnya, dengan menjaga identitas sumbernya tetap utuh. Periksa teks aktual ketika mengevaluasi peringkat: skor adalah ukuran relevansi terhadap kueri yang dikirim, bukan jawaban yang dihasilkan atau verifikasi bahwa klaim dokumen benar. Ini membuat model berguna untuk menyempurnakan materi pencarian teknis, hukum, keuangan, medis, percakapan, dan multibahasa tanpa mengubah pemeringkatan menjadi kesimpulan bidang tersebut. #### Konteks, anggaran total token, dan truncation Batas kueri yang didokumentasikan adalah 8.000 token, termasuk instruksi yang ditempatkan dalam kueri. Kueri ditambah satu dokumen kandidat mana pun harus muat dalam 32.000 token, dan daftar dokumen dapat memuat paling banyak 1.000 item. Alokasi total adalah 600.000 token, dihitung sebagai token kueri dikalikan jumlah dokumen, ditambah seluruh token dokumen. Karena itu, instruksi panjang dihitung berulang di seluruh pasangan kandidat. Jumlah top-k keluaran tidak mengubah jumlah kandidat dalam perhitungan token masukan tersebut. Truncation default memendekkan kueri atau dokumen yang terlalu panjang agar memenuhi batas konteks; menonaktifkannya membuat kueri atau pasangan yang terlalu panjang mengembalikan kesalahan. Siapkan bagian teks yang memuat jawaban secara sengaja dan jaga agar kondisi yang relevan tetap berada dalam teks yang akan dilihat model. Evaluasi urutan yang disempurnakan pada pertanyaan dan instruksi representatif, lalu teruskan bagian teks asli yang dipilih ke tahap berikutnya. **Ailoot Ultra · Pemeringkatan ulang** `POST /v1/rerank` `voyageai/rerank-2.5` [`voyageai/rerank-2.5`](https://ailoot.ai/models/id/#m=voyageai%2Frerank-2.5&route=Ultra&caller=voyageai%2Frerank-2.5&fmt=rerank) VoyageAI by MongoDB /`voyageai/rerank-2.5` ### Mulai rerank-2.5 mengurutkan ulang kumpulan kandidat teks yang diberikan berdasarkan relevansi terhadap kueri dan instruksi bahasa alami opsional. Ini adalah reranker multibahasa yang berorientasi pada kualitas, dengan konteks kueri-dokumen 32.000 token dan skor berperingkat yang terkait dengan indeks kandidat asli. Masukan yang diterima Teks Hasil Hasil berperingkat ### Tersedia di Ailoot · masukan & metode **Ailoot Ultra · Pemeringkatan ulang** `POST /v1/rerank` Masukan `text` Keluaran `rerank` Format keluaran json | Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan | | --- | --- | --- | --- | --- | | Kolom`documents` | Jenis`array` | PersyaratanWajib | Nilai & batasan | Bawaan— | | Kolom`model` | Jenis`string` | PersyaratanWajib | Nilai & batasan voyageai/rerank-2.5 | Bawaan— | | Kolom`provider` | Jenis`schema` | PersyaratanOpsional | Nilai & batasan | Bawaan— | | Kolom`query` | Jenis`string` | PersyaratanWajib | Nilai & batasan | Bawaan— | | Kolom`session_id` | Jenis`string` | PersyaratanOpsional | Nilai & batasan | Bawaan— | | Kolom`top_n` | Jenis`integer` | PersyaratanOpsional | Nilai & batasan Minimum: 1 | Bawaan— | | Kolom`trace` | Jenis`schema` | PersyaratanOpsional | Nilai & batasan | Bawaan— | | Kolom`user` | Jenis`string` | PersyaratanOpsional | Nilai & batasan | Bawaan— | | Kolom`documents[].text` | Jenis`string` | PersyaratanOpsional | Nilai & batasan | Bawaan— | | Kolom`documents[].image` | Jenis`string` | PersyaratanOpsional | Nilai & batasan | Bawaan— | Kombinasi bahan masukan **text\_rerank** · Wajib: query, documents array with minItems1 Parameter metode dan siklus hidup | Parameter | Kontrak | | --- | --- | | Parameter`content_type` | Kontrakapplication/json | | Parameter`required` | Kontrakmodel, query, documents | | Parameter`material_types` | Kontraktext | | Parameter`optional_controls` | Kontrakprovider, session\_id, top\_n, trace, user | | Parameter`multimodal_input_binding` | Kontraknull | Siklus hidup: `synchronous` Kirim ID model yang persis dan simpan respons native secara utuh. ### Paket Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih. Mode Fast Tidak ditentukan Saat mode fast dipilih Mode Flex Tidak ditentukan Saat mode flex dipilih Upaya penalaran maksimum Tidak ditentukan Saat upaya penalaran maksimum menggunakan penyesuaian default #### Tarif Ailoot #### Harga menurut konfigurasi Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif. | Konfigurasi | Jadwal tarif | Satuan penagihan | Biaya | | --- | --- | --- | --- | | KonfigurasiTarif dasar token | Jadwal tarifTarif dasar | Satuan penagihan— | Biaya Masukan · Token masukan **—** / 1K token Keluaran · Token keluaran **—** / 1K token Masukan · Pembacaan cache **—** / 1K token Masukan · Penulisan cache **—** / 1K token Masukan · Penulisan cache, 1 jam **—** / 1K token | | KonfigurasiUltra | Jadwal tarif— | Satuan penagihan/ 1K token | Biaya Masukan **$0.0001** / 1K token | Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. [Cara kerja cadangan dan penyelesaian tagihan →](https://ailoot.ai/docs/id/billing/reserve/) ### Contoh permintaan #### Ailoot Ultra · Pemeringkatan ulang Struktur permintaan resmi yang dipertahankan; contoh untuk dokumentasiGunakan bahan permintaan Anda yang sebenarnya dan simpan hasil secara lengkap ```json { "documents": [ "Paris is the capital of France.", "Berlin is the capital of Germany." ], "model": "voyageai/rerank-2.5", "query": "What is the capital of France?", "top_n": 3 } ``` ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" : "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}" export AILOOT_REQUEST_FILE python3 - <<'PY_REQUEST' import json,os from pathlib import Path p=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8')) if not isinstance(p,dict): raise SystemExit('Request must be a JSON object') p['model']='voyageai/rerank-2.5' Path('request.json').write_text(json.dumps(p,ensure_ascii=False),encoding='utf-8') PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/rerank \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json python3 - <<'PY_RESULT' import json from pathlib import Path print(json.dumps(json.loads(Path('result.json').read_text()),ensure_ascii=False,indent=2)) PY_RESULT ``` ### Terima dan simpan hasil #### Ailoot Ultra · Pemeringkatan ulang json ##### Simpan semua hasil yang selesai Simpan setiap respons lengkap, berkas, dan bagian konten yang dikembalikan. Setiap indeks hasil aktual, relevance\_score yang bernilai berhingga, dan objek dokumen asli dipertahankan. Indeks mengacu pada array dokumen asli. Seluruh JSON asli disimpan dan hanya dikembalikan setelah penyelesaian tagihan. ##### Jika respons asli perlu diperiksa Simpan operasi awal dan balasan lengkap/sebagian; jangan ulangi POST. Kolom respons | Kolom | Jenis | | --- | --- | | Kolom`model` | Jenisstring | | Kolom`id` | Jenisstring | | Kolom`provider` | Jenisstring | | Kolom`results[].index` | Jenisinteger | | Kolom`results[].relevance_score` | Jenisnumber | | Kolom`results[].document.text` | Jenisstring | | Kolom`results[].document.image` | Jenisstring | | Kolom`usage.search_units` | Jenisinteger | | Kolom`usage.total_tokens` | Jenisinteger | | Kolom`usage.cost` | Jenisnumber | Kesalahan dan langkah berikutnya | Respons | Kondisi | Langkah berikutnya | | --- | --- | --- | | Respons400 · `invalid_request_error` | KondisiBidang wajib, representasi, atau nilai tidak valid | Langkah berikutnyaPerbaiki bidang permintaan yang ditunjukkan. | ### Alias #### Alias model **Ailoot Ultra** [`voyageai/rerank-2.5`](https://ailoot.ai/models/id/#m=voyageai%2Frerank-2.5&route=Ultra&caller=voyageai%2Frerank-2.5&fmt=rerank) #### Alias jalur metode Gunakan jalur metode yang ditampilkan di atas. #### ID pemanggil terkait [`voyageai/rerank-2.5`](https://ailoot.ai/models/id/#m=voyageai%2Frerank-2.5&route=Ultra&caller=voyageai%2Frerank-2.5&fmt=rerank) FAQ · VoyageAI by MongoDB: rerank-2.5 Input dan hasil apa yang tersedia? `POST /v1/rerank` · `voyageai/rerank-2.5`: `text` → `rerank` Kolom apa yang digunakan permintaan? `POST /v1/rerank` · `voyageai/rerank-2.5`: `documents`, `model`, `provider`, `query`, `session_id`, `top_n`, `trace`, `user` Batasan apa yang berlaku? `POST /v1/rerank` · `voyageai/rerank-2.5`: `top_n.minimum`: `1` Hubungkan Ailoot ke Claude Code, OpenCode, Hermes, atau aplikasi Anda. ## Perusahaan dan portofolio proyeknya Perusahaan dan portofolio proyeknya: jutaan pelanggan; penjualan miliaran setiap bulan. ## Beli token dengan diskon. Diskon langganan untuk pekerjaan rutin. Kode promo — hingga 50% untuk pembelian token. Langganan Pilih paket dengan diskon untuk permintaan rutin Anda. Kode promo hingga 50% Masukkan kode saat membeli. Harga dihitung ulang sesuai promosi aktif. Biaya dalam riwayat Model, token, dan jumlah tagihan disimpan untuk setiap permintaan. [Pilih langganan](https://ailoot.ai/docs/id/billing/subscriptions/) · [Lihat harga model](https://ailoot.ai/models/id/) ## Hubungkan API ke produk yang Anda jual. SaaS, aplikasi, dan bot — sesuai penawaran dan perjanjian lisensi Ailoot. Untuk penjualan kembali, mintalah lisensi reseller. Aplikasi komersial Integrasikan pembuatan teks, gambar, video, dan suara dalam fitur berbayar layanan Anda. Lisensi reseller Kirim deskripsi proyek dan skema akses. Mintalah ketentuan penggunaan dan penjualan kembali secara tertulis. Dokumen di situs Penawaran, perjanjian lisensi, dan kebijakan pemrosesan data tersedia sebelum koneksi. [Minta lisensi reseller](mailto:support@ailoot.ai) · [Penawaran dan perjanjian lisensi](https://ailoot.ai/legal/offer?lang=id) ## Ailoot · Perusahaan dan portofolio proyeknya Ailoot bertumpu pada pengalaman operasional yang teruji, basis pelanggan yang besar, layanan yang stabil, dan pemantauan KPI berkelanjutan. Perusahaan dan portofolio proyeknya: jutaan pelanggan; penjualan miliaran setiap bulan. Ailoot memanfaatkan pengalaman operasional ini untuk akses API ke fitur AI dalam produk pelanggan, agen, aplikasi, dan otomatisasi.