bge-reranker-v2-m3

Сұрауға қатысты ықтимал үзінділерді реттеуге арналған BAAI көптілді кросс-энкодері. Ол әр сұрау–үзінді жұбын бірге оқып, сәйкестік ұпайын қайтарады; іздеуден алынған қысқа тізімді нақтылайды, бірақ жауап жазбайды және құжат эмбеддингтерін жасамайды.

Ailoot Ultra · Қайта реттеу POST /v1/rerank bge-reranker-v2-m3

Модель туралы

Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.

BGE Reranker v2 M3 — BGE-M3 негізінде жасалған көптілді сәйкестік моделі. Ол сұрауды және ықтимал үзіндіні бірге қабылдап, олардың байланысына ұпай береді. BAAI бұл нұсқаны тиімді көптілді қайта реттеу моделі ретінде ұсынады, соның ішінде іздеу қолданбасы бар үміткерлер тізімін нақтылауы қажет қытай және ағылшын тілдеріндегі іздеу үшін.

Сұрау–үзінді жұбының сәйкестігі

Кросс-энкодер екі мәтінді бірге өңдейді, сондықтан сәйкестік ұпайы жасалғанға дейін олардың мазмұны өзара әрекеттесе алады. Бұл мәтіндерді кейін қайта пайдаланылатын векторлық салыстыру үшін бөлек кодтайтын эмбеддинг моделінен өзгеше. Қайта реттеу моделінің нәтижесі — құжат векторы немесе жазбаша жауап емес, нақты жұпқа арналған скаляр ұпай.

Модельді бастапқы іздеу ықтимал үзінділерді таңдағаннан кейін қолданыңыз. Сұрақты әр үміткермен жұптастырып, үміткерлерді алынған ұпай бойынша реттеңіз. Осылай егжей-тегжейлі салыстыру кросс-энкодерге үлкен жинақтағы әр үзіндіні қарауды тапсырудың орнына, басқаруға болатын қысқа тізімге шоғырланады.

v2 M3 нұсқасы

Өндіруші BGE-M3 моделін негіз ретінде атап, көптілді қолдауды басты мүмкіндіктерінің бірі ретінде көрсетеді. Оның v2 қайта реттеу тобында M3 — тиімді көптілді нұсқа; Gemma негізіндегі және қабат таңдайтын нұсқалар іске асыру тәсілдері бөлек жеке модельдер. Мұндағы M3 атауы қайта реттеу моделі бастапқы эмбеддинг моделінің тығыз, сирек және көпвекторлы эмбеддингтерін қайтарады дегенді білдірмейді.

Бұл айырмашылық қолданбаға қажет нәтиже түрін таңдағанда маңызды. Құжат жинағын вектормен көрсету және іздеу үшін эмбеддинг моделін таңдаңыз. Қолыңызда ықтимал мәтіндер бар болып, ағымдағы сұрауға қай үзінді ең сәйкес екенін анықтау қажет болса, осы қайта реттеу моделін таңдаңыз.

Пайдалы реттеуге жарайтын үміткерлерді дайындау

Нақты сұрақты және оны түсіндіруге қажет толық үміткер мәтінді беріңіз. Үзінді мағынасын анықтайтын тақырыптарды немесе жанындағы анықтамаларды сақтаңыз. Жарияланған Transformers мысалында сұрау мен үзінді бірге токенделеді, қысқарту және max_length=512 қолданылады. Бұл — мысал баптауы, бүкіл модельге ортақ шек емес. Сұрақ пен қажетті дәлелді таңдалған жұп көлемінің шегінде ұстап, қысқарту нені алып тастайтынын тексеріңіз. Сұраудағы өнім аталған нәтиже басқа операцияға немесе шартқа қатысты болса, бәрібір сәйкес болмауы мүмкін; іздеу сапасын бағалағанда осы жағдайларды ажырататын мысалдар дайындаңыз.

Құжат ассистентінде үміткер идентификаторларын мәтінімен бірге сақтап, сұрақ–үзінді жұптарын бағалаңыз және таңдалған бастапқы үзінділерді жауап беру қадамына өткізіңіз. Сонда жауап беретін модель дереккөзсіз сәйкестік ұпайын емес, дәлелдің өзін алады. Бұл — іздеу үдерісінің мысалы; қайта реттеу моделі өзі сыртқы жинақтан іздемейді де, жауап жазбайды да.

Ұпайларды оқу және қалыпқа келтіру

Өндіруші өңделмеген сәйкестік ұпайларын қайтарады; жоғары мән жақынырақ сәйкестікті көрсетеді. Құжатталған қосымша қалыпқа келтіру сигмоид функциясын қолданып, ұпайды 0 мен 1 аралығына орналастырады. Қалыпқа келтірілген ұпайдың ауқымы қолайлы, бірақ бұл түрлендірудің өзі үміткердің дұрыс екенінің калибрленген ықтималдығын білдірмейді.

Реттеу немесе сүзу шектерін өз жұмыс жүктемеңізді көрсететін сұрау–үзінді жұптары арқылы таңдаңыз. Кілт сөздері ортақ, бірақ басқа сұраққа жауап беретін үзінділерді де, тұжырымы басқа сәйкес үзінділерді де қосыңыз. Бұл таңдалған шекті ізделетін жинақ үшін мағыналы етеді.

Ailoot API жобасында соңғы контекст нені қамтуы тиіс екенін және қанша үміткерді тиімді қарастыруға болатынын анықтаңыз. Пайдалы нәтиже — қолданбаның келесі қадамына арналған жақсырақ реттелген дәлелдер жиыны. Осы нұсқаның сәйкестік нәтижесін құжат эмбеддингтерінен, жасалған мәтіннен және басқа қайта реттеу модельдеріне құжатталған қабат таңдау параметрлерінен бөлек ұстаңыз.

Ailoot Ultra · Қайта реттеу POST /v1/rerank bge-reranker-v2-m3

bge-reranker-v2-m3

BAAI /bge-reranker-v2-m3

Бастау

Қабылданатын кіріс деректері: Мәтін
Нәтижелер: Реттелген нәтижелер

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 режимі таңдалғанда
Ой қорытудың ең жоғары деңгейі: Көрсетілмеген Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда

Ailoot мөлшерлемелері

Баптаулар бойынша бағалар

Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.

Баптау	Мөлшерлемелер кестесі	Есептеу бірлігі	Төлем
БаптауТокендердің базалық тарифтері	Мөлшерлемелер кестесіНегізгі мөлшерлеме	Есептеу бірлігі—	Төлем Кіріс · Кіріс токендері — / 1K токен Шығыс · Шығыс токендері — / 1K токен Кіріс · Кэшті оқу — / 1K токен Кіріс · Кэшке жазу — / 1K токен Кіріс · Кэшке жазу, 1 сағ — / 1K токен
Баптаужиынтық токен	Мөлшерлемелер кестесі—	Есептеу бірлігі/ 1K токен	Төлем Кіріс · жиынтық токен $0.00004 / 1K токен

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 нәтижесі толық беріледі. Әрбір нақты нәтиже мен пайдалану өрісін сақтаңыз.

GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /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	МағынасыҚолданыстағы қабылданған тариф талап ететін ақырлы, теріс емес төл токен саны.

Қателер және келесі қадамдар

Жауап	Шарт	Келесі қадам
Жауап400 · `invalid_request_error`	ШартJSON денесі немесе нақты канондық модель ID мәні жарамсыз.	Келесі қадамЖауапты сақтап, сұраудың көрсетілген өрісін түзетіңіз.
Жауап401 · `authentication_error`	ШартAiloot API кілті жарамсыз.	Келесі қадамПайдалануға рұқсат етілген Ailoot API кілтіңізді қолданыңыз.
Жауап403 · `permission_error`	ШартКілттің тобына бұл әдісті пайдалануға рұқсат берілмеген.	Келесі қадамҚайтарылған қатенің толық мәліметін сақтаңыз.
Жауап404 · `not_found_error`	ШартТаңдалған әдісте пайдалануға рұқсат етілген маршрут жоқ.	Келесі қадамҚайтарылған қатенің толық мәліметін сақтаңыз.
Жауап422 · `price_unavailable`	ШартҚабылданған тариф өзіне қажетті кіріс мөлшерін немесе шегін ала алмайды.	Келесі қадамЖауапты сақтаңыз; қабылданған тариф талап ететін кіріс пішімін пайдаланыңыз.
Жауап503 ·	ШартҚажетті қойма, маршрут, әдіс бағасы немесе қаражат резерві қолжетімді емес.	Келесі қадамБастапқы жауапты толық сақтаңыз. Нәтижесі белгісіз қаражат резерві сұрауды қайта жіберуге рұқсат бермейді.
Жауап502 · `billing_requires_check`	ШартБастапқы нәтижені, пайдалану деректерін немесе есеп айырысуды тексеру қажет.	Келесі қадамНақты сұрау ID мәнін және бастапқы жауапты сақтаңыз. Иелігіңіздегі бар жазбаны оқыңыз; жасау сұрауын қайта жібермеңіз.

Балама атаулар

Модельдердің балама атаулары

Ailoot Ultra bge-reranker-v2-m3

Әдіс жолдарының балама атаулары

Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз.

Шақыруға арналған байланысты ID

bge-reranker-v2-m3

FAQ · bge-reranker-v2-m3

Қандай кіріс деректері мен нәтижелер қолжетімді?: POST /v1/rerank · bge-reranker-v2-m3: text → rerank
Сұрау қандай өрістерді пайдаланады?: POST /v1/rerank · bge-reranker-v2-m3: model, query, documents

bge-reranker-v2-m3