bge-reranker-v2-m3
Ο πολυγλωσσικός cross-encoder της BAAI για κατάταξη υποψήφιων αποσπασμάτων ως προς ένα ερώτημα. Διαβάζει μαζί κάθε ζεύγος ερωτήματος–αποσπάσματος και επιστρέφει βαθμολογία συνάφειας, βελτιώνοντας μια σύντομη λίστα αναζήτησης χωρίς να παράγει απάντηση ή διανυσματικές αναπαραστάσεις εγγράφων.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το BGE Reranker v2 M3 είναι πολυγλωσσικό μοντέλο συνάφειας βασισμένο στο BGE-M3. Λαμβάνει μαζί ένα ερώτημα και ένα υποψήφιο απόσπασμα και επιστρέφει βαθμολογία για τη μεταξύ τους σχέση. Η BAAI προορίζει αυτή την έκδοση ως αποδοτικό πολυγλωσσικό ανακατατάκτη, μεταξύ άλλων για ανάκτηση στα κινεζικά και αγγλικά, όπου μια εφαρμογή αναζήτησης χρειάζεται να βελτιώσει υπάρχουσα λίστα υποψηφίων.
Συνάφεια από ζεύγος ερωτήματος–αποσπάσματος
Ένας cross-encoder επεξεργάζεται από κοινού και τα δύο κείμενα, επιτρέποντας στο περιεχόμενό τους να αλληλεπιδρά πριν παραχθεί η βαθμολογία συνάφειας. Αυτό διαφέρει από ένα μοντέλο διανυσματικών αναπαραστάσεων, που κωδικοποιεί τα κείμενα ανεξάρτητα για επαναχρησιμοποιήσιμη διανυσματική σύγκριση. Η έξοδος του ανακατατάκτη είναι μια βαθμωτή βαθμολογία για συγκεκριμένο ζεύγος αντί για διάνυσμα εγγράφου ή γραπτή απάντηση.
Χρησιμοποιήστε το μοντέλο αφού μια αρχική αναζήτηση έχει επιλέξει πιθανά αποσπάσματα. Συνδυάστε το ερώτημα με κάθε υποψήφιο και ταξινομήστε τους υποψηφίους με βάση τις βαθμολογίες που προκύπτουν. Έτσι η λεπτομερέστερη σύγκριση εστιάζει σε διαχειρίσιμη σύντομη λίστα αντί να ζητείται από έναν cross-encoder να εξετάζει κάθε απόσπασμα μιας μεγάλης συλλογής.
Η έκδοση v2 M3
Ο δημιουργός προσδιορίζει το BGE-M3 ως βασικό μοντέλο και αναφέρει την πολυγλωσσική υποστήριξη ως κύριο χαρακτηριστικό. Μέσα στην οικογένεια ανακατατακτών v2, το M3 είναι η αποδοτική πολυγλωσσική επιλογή· οι παραλλαγές που βασίζονται στο Gemma και εκείνες με επιλογή επιπέδων είναι ξεχωριστά μοντέλα με διαφορετικές επιλογές υλοποίησης. Το όνομα M3 εδώ δεν σημαίνει ότι ο ανακατατάκτης επιστρέφει τις πυκνές, αραιές και πολυδιανυσματικές αναπαραστάσεις του αρχικού μοντέλου διανυσματικών αναπαραστάσεων.
Αυτή η διάκριση έχει σημασία κατά την επιλογή του αποτελέσματος που απαιτεί η εφαρμογή σας. Επιλέξτε μοντέλο διανυσματικών αναπαραστάσεων για να αναπαραστήσετε και να αναζητήσετε μια συλλογή εγγράφων. Επιλέξτε αυτόν τον ανακατατάκτη όταν έχετε ήδη υποψήφιο κείμενο και πρέπει να αποφασίσετε ποιο απόσπασμα είναι πιο σχετικό με το τρέχον ερώτημα.
Προετοιμασία υποψηφίων για χρήσιμη κατάταξη
Δώστε το πραγματικό ερώτημα και το πλήρες υποψήφιο κείμενο που χρειάζεται για την ερμηνεία του. Διατηρήστε επικεφαλίδες ή κοντινούς ορισμούς όταν καθορίζουν το νόημα ενός αποσπάσματος. Στο δημοσιευμένο παράδειγμα Transformers, το ερώτημα και το απόσπασμα μετατρέπονται μαζί σε token με περικοπή και max_length=512. Πρόκειται για ρύθμιση παραδείγματος αντί για όριο που ισχύει για όλο το μοντέλο. Κρατήστε το ερώτημα και τα απαιτούμενα στοιχεία εντός του επιλεγμένου ορίου ζεύγους και ελέγξτε τι αφαιρεί η περικοπή. Ένα αποτέλεσμα που αναφέρει το ίδιο προϊόν με το ερώτημα μπορεί και πάλι να είναι άσχετο αν αφορά λάθος λειτουργία ή συνθήκη· προετοιμάστε παραδείγματα που διακρίνουν αυτές τις περιπτώσεις όταν αξιολογείτε την ποιότητα ανάκτησης.
Για βοηθό εγγράφων, κρατήστε τα αναγνωριστικά υποψηφίων μαζί με το κείμενό τους, βαθμολογήστε τα ζεύγη ερωτήματος–αποσπάσματος και περάστε τα επιλεγμένα αρχικά αποσπάσματα στο βήμα απάντησης. Το μοντέλο απάντησης λαμβάνει τότε τα στοιχεία αντί για βαθμολογία συνάφειας χωρίς την πηγή της. Πρόκειται για ενδεικτική ροή ανάκτησης· ο ίδιος ο ανακατατάκτης ούτε αναζητά εξωτερική συλλογή ούτε γράφει την απάντηση.
Ανάγνωση και κανονικοποίηση βαθμολογιών
Ο κατασκευαστής επιστρέφει ακατέργαστες βαθμολογίες συνάφειας, με υψηλότερη τιμή να υποδηλώνει στενότερη αντιστοιχία. Η τεκμηριωμένη προαιρετική κανονικοποίηση εφαρμόζει σιγμοειδή συνάρτηση για να τοποθετήσει τη βαθμολογία μεταξύ 0 και 1. Μια κανονικοποιημένη βαθμολογία έχει εύχρηστο εύρος, αλλά αυτή η μετατροπή από μόνη της δεν τεκμηριώνει βαθμονομημένη πιθανότητα ότι ο υποψήφιος είναι σωστός.
Επιλέξτε κατώφλια κατάταξης ή φιλτραρίσματος χρησιμοποιώντας αντιπροσωπευτικά ζεύγη ερωτήματος–αποσπάσματος από τον φόρτο εργασίας σας. Συμπεριλάβετε αποσπάσματα που μοιράζονται λέξεις-κλειδιά αλλά απαντούν διαφορετικό ερώτημα, καθώς και σχετικά αποσπάσματα με διαφορετική διατύπωση. Έτσι το επιλεγμένο κατώφλι αποκτά νόημα για τη συλλογή που αναζητείται.
Για έργο Ailoot API, ορίστε τι πρέπει να περιέχει το τελικό πλαίσιο και πόσοι υποψήφιοι μπορούν να εξεταστούν αποδοτικά. Το χρήσιμο αποτέλεσμα είναι ένα καλύτερα ταξινομημένο σύνολο στοιχείων για το επόμενο βήμα εφαρμογής. Κρατήστε την έξοδο συνάφειας αυτής της έκδοσης χωριστά από διανυσματικές αναπαραστάσεις εγγράφων, παραγόμενο πεζό λόγο και ρυθμίσεις επιλογής επιπέδων που τεκμηριώνονται για άλλους ανακατατάκτες.
Ailoot Ultra · Επανακατάταξη POST /v1/rerank bge-reranker-v2-m3
bge-reranker-v2-m3Εισαγωγή
Ο πολυγλωσσικός cross-encoder της BAAI για κατάταξη υποψήφιων αποσπασμάτων ως προς ένα ερώτημα. Διαβάζει μαζί κάθε ζεύγος ερωτήματος–αποσπάσματος και επιστρέφει βαθμολογία συνάφειας, βελτιώνοντας μια σύντομη λίστα αναζήτησης χωρίς να παράγει απάντηση ή διανυσματικές αναπαραστάσεις εγγράφων.
- Αποδεκτές είσοδοι
- Κείμενο
- Αποτελέσματα
- Αποτελέσματα κατά σειρά συνάφειας
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Επανακατάταξη POST /v1/rerank
- Είσοδος
text- Έξοδος
rerank
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια bge-reranker-v2-m3 | Προεπιλογή— |
Πεδίοquery | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοdocuments | Τύποςarray | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια | Προεπιλογή— |
Παράμετροι και κύκλος ζωής μεθόδου
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςcontent_type | Σύμβασηapplication/json |
Παράμετροςrequired | Σύμβασηmodel, documents |
Παράμετροςmaterial_types | Σύμβασηtext |
Παράμετροςmaterial_conditions | ΣύμβασηΟρίστε το πραγματικό σας ερώτημα και έναν μη κενό πίνακα αρχικών εγγράφων κειμένου. Οι δείκτες αποτελεσμάτων αναφέρονται σε αυτόν τον αρχικό πίνακα. |
Κύκλος ζωής: synchronous_result_then_owned_library
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Τιμολόγηση
Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο.
- Γρήγορη λειτουργία
- Δεν έχει οριστεί Όταν επιλέγεται η γρήγορη λειτουργία
- Λειτουργία flex
- Δεν έχει οριστεί Όταν επιλέγεται η λειτουργία flex
- Μέγιστη προσπάθεια συλλογισμού
- Δεν έχει οριστεί Όταν η μέγιστη προσπάθεια συλλογισμού χρησιμοποιεί την προσαρμογή default
Χρεώσεις Ailoot
Τιμές ανά διαμόρφωση
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Πίνακας χρεώσεων | Μονάδα τιμολόγησης | Χρέωση |
|---|---|---|---|
| ΔιαμόρφωσηΒασικές χρεώσεις token | Πίνακας χρεώσεωνΒασική χρέωση | Μονάδα τιμολόγησης— | Χρέωση Είσοδος · Token εισόδου — / 1K token Έξοδος · Token εξόδου — / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα — / 1K token |
| Διαμόρφωσησυνολικό token | Πίνακας χρεώσεων— | Μονάδα τιμολόγησης/ 1K token | Χρέωση Είσοδος · συνολικό token $0.00004 / 1K token |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Παραδείγματα αιτημάτων
Ailoot Ultra · Επανακατάταξη
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.
Λήψη και αποθήκευση αποτελεσμάτων
Ailoot Ultra · Επανακατάταξη
Ολόκληρο το αρχικό εγγενές αποτέλεσμα JSON με το ρυθμισμένο μοντέλο απόκρισης, τους αρχικούς δείκτες εγγράφων, τις βαθμολογίες συνάφειας, τις συμβολοσειρές εγγράφων και την εγγενή χρήση token. Διατηρήστε κάθε πραγματικό πεδίο αποτελέσματος και χρήσης.
GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα
Διατηρήστε κάθε πλήρη απάντηση, αρχείο και τμήμα περιεχομένου που επιστρέφεται.
Διατηρήστε ολόκληρη την απόκριση και τις κεφαλίδες, κάθε πραγματικό αποτέλεσμα εξόδου, τα αρχικά αναγνωριστικά που επιστράφηκαν και όλα τα πεδία χρήσης. Ανακτήστε την αρχική λειτουργία χωρίς να υποβάλετε ξανά αίτημα δημιουργίας.
Αν χρειάζεται έλεγχος της αρχικής απάντησης
Διατηρήστε το πραγματικό X-Client-Request-ID και ολόκληρη την απόκριση. Διαβάστε τα αρχικά αρχεία πολυμέσων που σας ανήκουν και τα ακριβή υπογεγραμμένα URL περιεχομένου τους· μην επανυποβάλετε ποτέ αίτημα δημιουργίας με αβέβαιο αποτέλεσμα.
Πεδία απάντησης
| Πεδίο | Τύπος | Σημασία |
|---|---|---|
Πεδίοmodel | Τύποςstring | ΣημασίαΑκριβές μοντέλο απόκρισης που απαιτείται από τον ρυθμισμένο καταναλωτή του πηγαίου κώδικα. |
Πεδίοresults[].index | Τύποςinteger | ΣημασίαΜοναδικός δείκτης αρχικού εγγράφου εισόδου. |
Πεδίοresults[].relevance_score | Τύποςnumber | ΣημασίαΠεπερασμένη βαθμολογία συνάφειας. |
Πεδίοresults[].document | Τύποςstring | ΣημασίαΑρχικό έγγραφο κειμένου που απαιτείται από αυτόν τον ρυθμισμένο καταναλωτή απόκρισης. |
Πεδίοusage.total_tokens | Τύποςinteger | ΣημασίαΠεπερασμένο, μη αρνητικό εγγενές πλήθος token που απαιτείται από το ισχύον αποδεκτό τιμολόγιο. |
Σφάλματα και επόμενα βήματα
| Απάντηση | Συνθήκη | Επόμενο βήμα |
|---|---|---|
Απάντηση400 · invalid_request_error | ΣυνθήκηΤο σώμα JSON ή το ρητό κανονικό ID μοντέλου δεν είναι έγκυρο. | Επόμενο βήμαΔιατηρήστε την απόκριση και διορθώστε το υποδεικνυόμενο πεδίο του αιτήματος. |
Απάντηση401 · authentication_error | ΣυνθήκηΤο κλειδί API του Ailoot δεν είναι έγκυρο. | Επόμενο βήμαΧρησιμοποιήστε το εξουσιοδοτημένο κλειδί API του Ailoot σας. |
Απάντηση403 · permission_error | ΣυνθήκηΗ ομάδα του κλειδιού δεν επιτρέπει πρόσβαση σε αυτή τη μέθοδο. | Επόμενο βήμαΔιατηρήστε τις λεπτομέρειες σφάλματος που επιστρέφονται. |
Απάντηση404 · not_found_error | ΣυνθήκηΗ επιλεγμένη μέθοδος δεν έχει διαδρομή με άδεια πρόσβασης. | Επόμενο βήμαΔιατηρήστε τις λεπτομέρειες σφάλματος που επιστρέφονται. |
Απάντηση422 · price_unavailable | ΣυνθήκηΤο αποδεκτό τιμολόγιο δεν μπορεί να λάβει την απαιτούμενη ποσότητα εισόδου ή το όριό της. | Επόμενο βήμαΔιατηρήστε την απόκριση· χρησιμοποιήστε την αναπαράσταση εισόδου που απαιτεί το αποδεκτό τιμολόγιο. |
Απάντηση503 · | ΣυνθήκηΟ απαιτούμενος χώρος αποθήκευσης, η διαδρομή, η τιμή μεθόδου ή η δέσμευση ποσού δεν είναι διαθέσιμα. | Επόμενο βήμαΔιατηρήστε ολόκληρη την αρχική απόκριση. Μια αβέβαιη δέσμευση ποσού δεν αποτελεί άδεια επανυποβολής. |
Απάντηση502 · billing_requires_check | ΣυνθήκηΤο αρχικό αποτέλεσμα, η χρήση ή η εκκαθάριση απαιτεί έλεγχο. | Επόμενο βήμαΔιατηρήστε το πραγματικό ID αιτήματος και την αρχική απόκριση. Διαβάστε την υπάρχουσα εγγραφή που σας ανήκει· μην επανυποβάλετε αίτημα δημιουργίας. |
Εναλλακτικά ονόματα
Εναλλακτικά ονόματα μοντέλου
Ailoot Ultra bge-reranker-v2-m3
Εναλλακτικές διαδρομές μεθόδων
Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.
Σχετικά ID μοντέλων
FAQ · bge-reranker-v2-m3
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/rerank·bge-reranker-v2-m3:text→rerank- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/rerank·bge-reranker-v2-m3:model,query,documents