bge-reranker-v2-m3
Pengekod silang berbilang bahasa BAAI untuk menyusun kedudukan petikan calon berdasarkan pertanyaan. Ia membaca setiap pasangan pertanyaan–petikan bersama dan memulangkan skor kerelevanan, menambah baik senarai pendek carian tanpa menjana jawapan atau mencipta pembenaman dokumen.
Tentang model
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
BGE Reranker v2 M3 ialah model kerelevanan berbilang bahasa yang dibina atas BGE-M3. Ia menerima pertanyaan dan petikan calon bersama serta memulangkan skor hubungannya. BAAI memposisikan edisi ini sebagai penyusun semula kedudukan berbilang bahasa yang cekap, termasuk untuk perolehan bahasa Cina dan Inggeris, apabila aplikasi carian perlu menambah baik senarai calon sedia ada.
Kerelevanan daripada pasangan pertanyaan–petikan
Pengekod silang memproses kedua-dua teks bersama, membolehkan kandungannya berinteraksi sebelum skor kerelevanan dihasilkan. Ini berbeza daripada model pembenaman yang mengekod teks secara bebas untuk perbandingan vektor boleh guna semula. Output penyusun semula kedudukan ialah skor skalar bagi pasangan tertentu, bukannya vektor dokumen atau jawapan bertulis.
Gunakan model selepas carian awal memilih petikan munasabah. Pasangkan soalan dengan setiap calon dan susun calon mengikut skor hasil. Ini memfokuskan perbandingan lebih terperinci pada senarai pendek yang terkawal, bukannya meminta pengekod silang memeriksa setiap petikan dalam koleksi besar.
Edisi v2 M3
Pembuat mengenal pasti BGE-M3 sebagai model asas dan menyenaraikan sokongan berbilang bahasa sebagai ciri utama. Dalam keluarga penyusun semula kedudukan v2, M3 ialah pilihan berbilang bahasa cekap; varian berasaskan Gemma dan pemilihan lapisan ialah model berbeza dengan pilihan pelaksanaan berlainan. Nama M3 di sini tidak bermakna penyusun semula kedudukan memulangkan pembenaman padat, jarang dan berbilang vektor model pembenaman asal.
Perbezaan ini penting apabila memilih hasil yang diperlukan aplikasi. Pilih model pembenaman untuk mewakili dan mencari koleksi dokumen. Pilih penyusun semula kedudukan ini apabila teks calon sudah tersedia dan anda perlu menentukan petikan paling relevan kepada pertanyaan semasa.
Menyediakan calon yang boleh diberi kedudukan berguna
Berikan soalan sebenar dan teks calon lengkap yang diperlukan untuk mentafsirkannya. Pelihara tajuk atau takrif berhampiran apabila menentukan makna petikan. Dalam contoh Transformers yang diterbitkan, pertanyaan dan petikan ditokenkan bersama dengan pemangkasan dan max_length=512. Itu tetapan contoh, bukannya had seluruh model. Pastikan soalan serta bukti diperlukan dalam bajet pasangan terpilih dan semak perkara yang dibuang oleh pemangkasan. Hasil yang menyebut produk sama seperti pertanyaan masih boleh tidak relevan jika membincangkan operasi atau syarat salah; sediakan contoh yang membezakan kes itu apabila menilai kualiti perolehan.
Untuk pembantu dokumen, simpan pengecam calon bersama teksnya, berikan skor kepada pasangan soalan–petikan dan hantarkan petikan asal terpilih ke langkah menjawab. Model penjawab kemudian menerima bukti, bukannya skor kerelevanan tanpa sumbernya. Ini contoh aliran kerja perolehan; penyusun semula kedudukan sendiri tidak mencari koleksi luaran atau menulis jawapan.
Membaca dan menormalkan skor
Pengeluar memulangkan skor kerelevanan mentah, dengan nilai lebih tinggi menunjukkan padanan lebih rapat. Penormalan pilihan yang didokumenkan menerapkan fungsi sigmoid untuk meletakkan skor antara 0 dan 1. Skor ternormal mempunyai julat mudah digunakan, tetapi transformasi itu sahaja tidak membuktikan kebarangkalian tertentukur bahawa calon betul.
Pilih ambang kedudukan atau penapisan menggunakan pasangan pertanyaan–petikan yang mewakili beban kerja. Sertakan petikan yang berkongsi kata kunci tetapi menjawab soalan berbeza, serta petikan relevan dengan kata-kata berlainan. Ini menjadikan ambang terpilih bermakna untuk koleksi yang dicari.
Untuk projek Ailoot API, tentukan kandungan konteks akhir dan bilangan calon yang boleh diperiksa dengan cekap. Hasil berguna ialah set bukti dengan susunan lebih baik untuk langkah aplikasi seterusnya. Bezakan output kerelevanan edisi ini daripada pembenaman dokumen, prosa terjana dan kawalan pemilihan lapisan yang didokumenkan untuk penyusun semula kedudukan lain.
Ailoot Ultra · Pemeringkatan semula POST /v1/rerank bge-reranker-v2-m3
bge-reranker-v2-m3Pengenalan
Pengekod silang berbilang bahasa BAAI untuk menyusun kedudukan petikan calon berdasarkan pertanyaan. Ia membaca setiap pasangan pertanyaan–petikan bersama dan memulangkan skor kerelevanan, menambah baik senarai pendek carian tanpa menjana jawapan atau mencipta pembenaman dokumen.
- Input yang diterima
- Teks
- Hasil
- Hasil mengikut kedudukan
Tersedia di Ailoot · input & kaedah
Ailoot Ultra · Pemeringkatan semula POST /v1/rerank
- Input
text- Output
rerank
| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had bge-reranker-v2-m3 | Lalai— |
Medanquery | Jenisstring | KeperluanPilihan | Nilai & had | Lalai— |
Medandocuments | Jenisarray | KeperluanDiperlukan | Nilai & had | Lalai— |
Parameter kaedah dan kitar hayat
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, documents |
Parametermaterial_types | Kontraktext |
Parametermaterial_conditions | KontrakTetapkan pertanyaan sebenar anda dan tatasusunan dokumen teks asal yang tidak kosong. Indeks hasil merujuk kepada tatasusunan asal tersebut. |
Kitar hayat: synchronous_result_then_owned_library
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Pelan harga
Rujukan tarif tidak menambah pilihan permintaan. Parameter yang disokong disenaraikan untuk kaedah yang dipilih.
- Mod pantas
- Tidak dinyatakan Apabila mod pantas dipilih
- Mod flex
- Tidak dinyatakan Apabila mod flex dipilih
- Usaha penaakulan maksimum
- Tidak dinyatakan Apabila usaha penaakulan maksimum menggunakan pelarasan default
Kadar Ailoot
Harga mengikut konfigurasi
Padankan setiap caj dengan syarat yang dipaparkan. Gunakan satu kadar bagi setiap set konfigurasi alternatif.
| Konfigurasi | Jadual kadar | Unit pengebilan | Caj |
|---|---|---|---|
| KonfigurasiKadar asas token | Jadual kadarKadar asas | Unit pengebilan— | Caj Input · Token input — / 1K token Output · Token output — / 1K token Input · Bacaan cache — / 1K token Input · Penulisan cache — / 1K token Input · Penulisan cache, 1 jam — / 1K token |
| Konfigurasijumlah token | Jadual kadar— | Unit pengebilan/ 1K token | Caj Input · jumlah token $0.00004 / 1K token |
Ailoot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. Cara rizab dan penyelesaian caj berfungsi →
Contoh permintaan
Ailoot Ultra · Pemeringkatan semula
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_QUERY:?Set the actual documented input value}"
export AILOOT_QUERY
: "${AILOOT_DOCUMENTS_JSON:?Set the actual documented input value}"
export AILOOT_DOCUMENTS_JSON
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'bge-reranker-v2-m3', 'query': '${ACTUAL_QUERY}', 'documents': '${ACTUAL_DOCUMENTS}'}
request['query']=os.environ['AILOOT_QUERY']
request['documents']=json.loads(os.environ['AILOOT_DOCUMENTS_JSON'])
Path('request.json').write_text(json.dumps(request,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 response.bin
# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.
Terima dan simpan hasil
Ailoot Ultra · Pemeringkatan semula
Hasil JSON natif asal yang lengkap dengan model respons yang dikonfigurasi, indeks dokumen asal, skor kerelevanan, rentetan dokumen dan penggunaan token natif. Kekalkan setiap medan hasil dan penggunaan sebenar.
GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Simpan semua hasil yang selesai
Simpan setiap respons lengkap, fail dan bahagian kandungan yang dikembalikan.
Simpan respons dan pengepala yang lengkap, setiap output sebenar, pengecam asal yang dikembalikan serta semua medan penggunaan. Pulihkan operasi asal tanpa menghantar permintaan penciptaan sekali lagi.
Jika respons asal perlu disemak
Simpan X-Client-Request-ID sebenar dan respons lengkap. Baca aset asal milik anda serta pautan kandungan bertandatangan yang tepat; jangan sekali-kali hantar semula penciptaan yang tidak pasti.
Medan respons
| Medan | Jenis | Maksud |
|---|---|---|
Medanmodel | Jenisstring | MaksudModel respons tepat yang diperlukan oleh komponen penerima Source yang dikonfigurasi. |
Medanresults[].index | Jenisinteger | MaksudIndeks unik dokumen input asal. |
Medanresults[].relevance_score | Jenisnumber | MaksudSkor kerelevanan terhingga. |
Medanresults[].document | Jenisstring | MaksudDokumen teks asal yang diperlukan oleh komponen penerima respons yang dikonfigurasi ini. |
Medanusage.total_tokens | Jenisinteger | MaksudKiraan token natif terhingga yang tidak negatif, seperti yang diperlukan oleh tarif semasa yang diterima. |
Ralat dan langkah seterusnya
| Respons | Syarat | Langkah seterusnya |
|---|---|---|
Respons400 · invalid_request_error | SyaratBadan JSON atau ID model kanonik yang dinyatakan secara jelas tidak sah. | Langkah seterusnyaSimpan respons dan betulkan medan permintaan yang dinyatakan. |
Respons401 · authentication_error | SyaratKunci API Ailoot tidak sah. | Langkah seterusnyaGunakan kunci API Ailoot anda yang dibenarkan. |
Respons403 · permission_error | SyaratKumpulan kunci tidak membenarkan kaedah ini. | Langkah seterusnyaSimpan butiran ralat yang dikembalikan. |
Respons404 · not_found_error | SyaratKaedah yang dipilih tidak mempunyai laluan yang dibenarkan. | Langkah seterusnyaSimpan butiran ralat yang dikembalikan. |
Respons422 · price_unavailable | SyaratTarif yang diterima tidak dapat memperoleh kuantiti input atau batas yang diperlukan. | Langkah seterusnyaSimpan respons; gunakan bentuk perwakilan input yang diperlukan oleh tarif yang diterima. |
Respons503 · | SyaratStoran, laluan, harga kaedah atau penahanan dana yang diperlukan tidak tersedia. | Langkah seterusnyaSimpan respons asal yang lengkap. Penahanan dana yang tidak pasti bukan kebenaran untuk menghantar semula. |
Respons502 · billing_requires_check | SyaratHasil asal, penggunaan atau penyelesaian caj memerlukan semakan. | Langkah seterusnyaSimpan ID permintaan sebenar dan respons asal. Baca rekod sedia ada milik anda; jangan hantar semula permintaan penciptaan. |
Alias
Alias model
Ailoot Ultra bge-reranker-v2-m3
Alias laluan kaedah
Gunakan laluan kaedah yang dipaparkan di atas.
ID pemanggil berkaitan
FAQ · bge-reranker-v2-m3
- Apakah input dan hasil yang tersedia?
POST /v1/rerank·bge-reranker-v2-m3:text→rerank- Apakah medan yang digunakan oleh permintaan?
POST /v1/rerank·bge-reranker-v2-m3:model,query,documents