model

VoyageAI by MongoDB: rerank-3

Markdown · JSON

VoyageAI by MongoDB: rerank-3

Voyage rerank-3 adalah edisi Rerank 3 yang berfokus pada kualitas untuk memberi skor relevansi kueri-dokumen. Model ini mengurutkan ulang kandidat teks hasil pengambilan, mendukung instruksi relevansi bahasa alami, dan menangani pasangan 32.000 token untuk pencarian dokumen panjang, kode, serta basis pengetahuan.

Tentang model

Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.

Voyage rerank-3 adalah reranker teks yang dirancang untuk meningkatkan kualitas bukti hasil pengambilan informasi. Dengan kueri dan daftar dokumen kandidat, model ini memeriksa setiap pasangan secara bersamaan dan mengembalikan kandidat yang diurutkan berdasarkan relevansi. Embedding dan pencarian kata kunci dapat terlebih dahulu mempersempit koleksi besar menjadi daftar pendek yang dapat dikelola; rerank-3 kemudian menerapkan penilaian relevansi lebih terperinci pada daftar pendek tersebut. Keluarannya berupa bukti pencarian yang diberi skor untuk ditampilkan aplikasi atau diteruskan ke langkah pembuatan jawaban yang terpisah.

Rerank 3 yang berfokus pada kualitas Pembuatnya menempatkan rerank-3 sebagai edisi yang berfokus pada akurasi dan rerank-3-lite sebagai edisi untuk pencarian yang sensitif terhadap latensi. Generasi ketiga memperbarui arsitektur inti dan campuran pelatihan, dengan peningkatan khusus pada pengambilan dokumen panjang dan kode sumber dibandingkan pendahulu 2.5 yang bersesuaian. Pembuat mengevaluasinya pada dokumentasi teknis, kode, materi multibahasa, dan bidang dokumen lainnya. Hasil tersebut mendukung perannya dalam pengambilan informasi; pilih edisi menggunakan pertanyaan dan dokumen kandidat yang penting bagi koleksi Anda sendiri.

Dokumen panjang dengan konteks yang cukup Kandidat panjang dapat memuat konteks berguna jauh melampaui paragraf pembukanya. Berikan bagian atau dokumen yang koheren dengan judul dan materi sekitar yang relevan agar model dapat menilai hubungan pertanyaan aktual dengan konten. Untuk pencarian kebijakan produk, pertahankan judul dan pengecualian di sekitar bagian yang diminati. Jika beberapa bagian hasil pengambilan berasal dari sumber yang sama, pertahankan pengidentifikasi dokumen dan bagiannya; aplikasi kemudian dapat menunjukkan asal bukti yang dipilih.

Jendela konteks digunakan bersama oleh kueri dan setiap kandidat. Panduan pembuat saat ini menetapkan 32.000 token untuk pasangan tersebut, termasuk kueri yang maksimum 8.000 token. Karena itu, kueri 3.000 token menyisakan paling banyak 29.000 token untuk setiap dokumen. Siapkan masukan agar konten esensialnya muat, terutama ketika pengantar panjang atau teks standar berulang akan menghabiskan jendela. Opsi truncation yang didokumentasikan aktif secara default dan dapat memendekkan teks kueri atau dokumen yang terlalu panjang sebelum diberi skor. Periksa bagian yang dipertahankan ketika penempatan bagian teks berpengaruh.

Pengambilan kode dan informasi teknis Untuk tahap pengambilan informasi asisten pemrograman, kandidat dapat memuat implementasi fungsi, dokumentasi API, atau penjelasan teknis sebagai teks. Sertakan simbol, signature, dan konteks yang diperlukan untuk membedakan kandidat serupa. Kueri seperti “Temukan fungsi yang menormalisasi path sambil mempertahankan pemisah di bagian akhir” memberikan perilaku konkret untuk dicocokkan. Sertakan batasan bahasa, platform, atau versi yang relevan. Setelah pemeringkatan, periksa kode terpilih dan dependensinya sebelum menggunakannya sebagai konteks; skor relevansi tidak membuktikan bahwa implementasi memenuhi setiap persyaratan yang dinyatakan.

Instruksi menentukan relevansi Model ini mempertahankan kemampuan pemeringkatan ulang yang mengikuti instruksi, yang diperkenalkan dalam Rerank 2.5. Tambahkan instruksi ringkas sebelum atau sesudah kueri ketika maksud pengguna memerlukan klarifikasi. Untuk pencarian dokumen riset, jelaskan apakah fokusnya pada judul, metode tertentu, atau bidang aplikasi. Untuk katalog internal, tentukan apakah permintaan menyangkut instalasi, pemecahan masalah, atau kompatibilitas. Jaga instruksi tersebut selaras dengan pertanyaan; preferensi tambahan yang bertentangan dengan permintaan utama dapat mengubah hal yang berusaha dioptimalkan pemeringkatan.

Siapkan dokumen kandidat dan anggaran Masukannya adalah daftar string teks. Ekstrak teks yang dapat digunakan dari dokumen sumber, pertahankan batas bagian yang bermakna, dan simpan peta catatan berurutan bersama daftar tersebut. Pembuat mengizinkan hingga 1.000 dokumen dalam satu permintaan. Pembuat juga menetapkan batas masukan agregat 600.000 token: token kueri dikalikan jumlah dokumen, ditambah jumlah seluruh token dokumen. Ini berbeda dari batas konteks per pasangan. Mengurangi teks kueri yang berlebihan dapat mempertahankan kapasitas pasangan sekaligus anggaran total permintaan.

Hitung token untuk model yang relevan, alih-alih menganggap jumlah kata atau karakter sebagai jumlah token. Untuk kandidat besar, pilih bagian teks yang koheren atau bagi materi menurut judul yang berguna sambil mempertahankan informasi sumber induk. Pemeringkatan ulang paling berguna setelah pencarian pertama sudah menemukan kandidat yang masuk akal: tahap ini tidak dapat memeringkat sumber yang belum tersedia karena tidak pernah masuk daftar.

Hasil berperingkat dan penggunaan hilir Hasil memuat skor relevansi dan indeks yang merujuk pada dokumen masukan asli, diurutkan berdasarkan relevansi menurun. Opsi top_k membatasi jumlah hasil berperingkat yang dikembalikan; jika tidak ditentukan, semua kandidat masukan dikembalikan. Antarmuka REST pembuat juga memungkinkan penyertaan teks dokumen. Gunakan setiap indeks asli untuk memperoleh kembali judul, pengidentifikasi sumber, dan metadata yang dibutuhkan aplikasi, lalu tampilkan item yang dipilih atau masukkan teks relevan ke konteks bukti jawaban.

Periksa hasil teratas terhadap pertanyaan dan jaga identitas sumber tetap terlihat. Peringkat relatif tinggi tidak memverifikasi akurasi faktual dokumen, dan daftar pendek yang hanya memuat kandidat buruk tetap memiliki item pertama. Pisahkan pemilihan relevansi dari keputusan apakah bukti terpilih cukup untuk menjawab pengguna.

Migrasi edisi Pembuatnya mendeskripsikan rerank-3 sebagai penerus langsung rerank-2.5 yang dapat menggantikannya, dengan semantik API yang sama dan skor yang dikalibrasi terhadap distribusi pendahulunya yang bersesuaian. Kompatibilitas tersebut mendukung pemeliharaan tahap pengambilan informasi dan pemetaan catatan yang ada. Bandingkan urutan hasil yang bermakna dan ambang skor apa pun pada korpus saat ini sebelum mengandalkan migrasi. Pertahankan rerank-3 dan rerank-3-lite sebagai pilihan berbeda: batas bersama dan kepatuhan terhadap instruksi tidak membuat prioritas kualitas dan latensinya identik.

Ailoot Ultra · Pemeringkatan ulang POST /v1/rerank voyageai/rerank-3

voyageai/rerank-3

VoyageAI by MongoDB /voyageai/rerank-3

Mulai

Voyage rerank-3 adalah edisi Rerank 3 yang berfokus pada kualitas untuk memberi skor relevansi kueri-dokumen. Model ini mengurutkan ulang kandidat teks hasil pengambilan, mendukung instruksi relevansi bahasa alami, dan menangani pasangan 32.000 token untuk pencarian dokumen panjang, kode, serta basis pengetahuan.

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
KolomJenisPersyaratanNilai & batasanBawaan
KolomdocumentsJenisarrayPersyaratanWajibNilai & batasanBawaan—
KolommodelJenisstringPersyaratanWajibNilai & batasan
voyageai/rerank-3
Bawaan—
KolomproviderJenisschemaPersyaratanOpsionalNilai & batasanBawaan—
KolomqueryJenisstringPersyaratanWajibNilai & batasanBawaan—
Kolomsession_idJenisstringPersyaratanOpsionalNilai & batasanBawaan—
Kolomtop_nJenisintegerPersyaratanOpsionalNilai & batasan
Minimum: 1
Bawaan—
KolomtraceJenisschemaPersyaratanOpsionalNilai & batasanBawaan—
KolomuserJenisstringPersyaratanOpsionalNilai & batasanBawaan—
Kolomdocuments[].textJenisstringPersyaratanOpsionalNilai & batasanBawaan—
Kolomdocuments[].imageJenisstringPersyaratanOpsionalNilai & batasanBawaan—
Kombinasi bahan masukan

text_rerank · Wajib: query, documents array with minItems1

Parameter metode dan siklus hidup
ParameterKontrak
Parametercontent_typeKontrakapplication/json
ParameterrequiredKontrakmodel, query, documents
Parametermaterial_typesKontraktext
Parameteroptional_controlsKontrakprovider, session_id, top_n, trace, user
Parametermultimodal_input_bindingKontraknull

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.

KonfigurasiJadwal tarifSatuan penagihanBiaya
KonfigurasiTarif dasar tokenJadwal tarifTarif dasarSatuan 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
KonfigurasiUltraJadwal tarif—Satuan penagihan/ 1K tokenBiaya
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 →

Contoh permintaan

Ailoot Ultra · Pemeringkatan ulang

Struktur permintaan resmi yang dipertahankan; contoh untuk dokumentasiGunakan bahan permintaan Anda yang sebenarnya dan simpan hasil secara lengkap
{
  "documents": [
    "Paris is the capital of France.",
    "Berlin is the capital of Germany."
  ],
  "model": "voyageai/rerank-3",
  "query": "What is the capital of France?",
  "top_n": 3
}
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-3'
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
KolomJenis
KolommodelJenisstring
KolomidJenisstring
KolomproviderJenisstring
Kolomresults[].indexJenisinteger
Kolomresults[].relevance_scoreJenisnumber
Kolomresults[].document.textJenisstring
Kolomresults[].document.imageJenisstring
Kolomusage.search_unitsJenisinteger
Kolomusage.total_tokensJenisinteger
Kolomusage.costJenisnumber
Kesalahan dan langkah berikutnya
ResponsKondisiLangkah berikutnya
Respons400 · invalid_request_errorKondisiBidang wajib, representasi, atau nilai tidak validLangkah berikutnyaPerbaiki bidang permintaan yang ditunjukkan.

Alias

Alias model

Ailoot Ultra voyageai/rerank-3

Alias jalur metode

Gunakan jalur metode yang ditampilkan di atas.

ID pemanggil terkait

voyageai/rerank-3

FAQ · VoyageAI by MongoDB: rerank-3
Input dan hasil apa yang tersedia?

POST /v1/rerank · voyageai/rerank-3: text → rerank

Kolom apa yang digunakan permintaan?

POST /v1/rerank · voyageai/rerank-3: documents, model, provider, query, session_id, top_n, trace, user

Batasan apa yang berlaku?

POST /v1/rerank · voyageai/rerank-3: top_n.minimum: 1

Rincian selengkapnya

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 · Lihat harga model

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 · Penawaran dan perjanjian lisensi