bge-reranker-v2-m3

Cross-encoder หลายภาษาของ BAAI สำหรับจัดอันดับข้อความตัวเลือกเทียบกับคำค้น อ่านคู่คำค้น–ข้อความร่วมกันแล้วส่งคะแนนความเกี่ยวข้อง เพื่อปรับรายการค้นหาที่คัดมา โดยไม่สร้างคำตอบหรือสร้างเวกเตอร์ embedding ของเอกสาร

Ailoot Ultra · จัดอันดับใหม่ POST /v1/rerank bge-reranker-v2-m3

เกี่ยวกับโมเดล

คำอธิบายนี้ครอบคลุมความสามารถของโมเดล อินพุต เอาต์พุต และตัวเลือกที่ใช้ได้ใน Ailoot แสดงด้านล่างตามเมธอดที่เลือก

BGE Reranker v2 M3 เป็นโมเดลความเกี่ยวข้องหลายภาษาที่สร้างบน BGE-M3 รับคำค้นและข้อความตัวเลือกพร้อมกัน แล้วส่งคะแนนความสัมพันธ์ BAAI วางรุ่นนี้เป็น reranker หลายภาษาที่มีประสิทธิภาพ รวมถึงการค้นคืนภาษาจีนและอังกฤษ เมื่องานค้นหาต้องปรับรายการตัวเลือกที่มีอยู่แล้ว

ความเกี่ยวข้องจากคู่คำค้น–ข้อความ

Cross-encoder ประมวลผลทั้งสองข้อความร่วมกัน ทำให้เนื้อหามีปฏิสัมพันธ์กันก่อนสร้างคะแนนความเกี่ยวข้อง ต่างจากโมเดล embedding ที่เข้ารหัสข้อความแยกเพื่อเปรียบเทียบเวกเตอร์ซ้ำได้ ผลของ reranker เป็นคะแนนสเกลาร์สำหรับคู่เฉพาะ ไม่ใช่เวกเตอร์เอกสารหรือคำตอบที่เขียนขึ้น

ใช้โมเดลหลังการค้นหาเบื้องต้นเลือกข้อความที่มีแนวโน้มเกี่ยวข้อง จับคู่คำถามกับแต่ละตัวเลือกและเรียงตัวเลือกตามคะแนนที่ได้ วิธีนี้เน้นการเปรียบเทียบละเอียดกับรายการสั้นที่จัดการได้ แทนการขอให้ cross-encoder ตรวจทุกข้อความในคอลเลกชันใหญ่

รุ่น v2 M3

ผู้สร้างระบุ BGE-M3 เป็นโมเดลฐานและให้การรองรับหลายภาษาเป็นคุณสมบัติหลัก ในตระกูล reranker v2 ของตน M3 เป็นตัวเลือกหลายภาษาที่มีประสิทธิภาพ ส่วนรุ่นฐาน Gemma และรุ่นเลือกชั้นเป็นโมเดลแยกที่มีวิธีพัฒนาต่างกัน ชื่อ M3 ในที่นี้ไม่ได้หมายความว่า reranker ส่งคืน embedding แบบ dense, sparse และ multi-vector ของโมเดล embedding ดั้งเดิม

ความแตกต่างนี้สำคัญเมื่อเลือกผลที่แอปพลิเคชันต้องการ เลือกโมเดล embedding เพื่อแทนและค้นหาคอลเลกชันเอกสาร เลือก reranker นี้เมื่อมีข้อความตัวเลือกแล้วและต้องตัดสินว่าข้อความใดเกี่ยวข้องกับคำค้นปัจจุบันมากที่สุด

เตรียมตัวเลือกให้จัดอันดับได้อย่างมีประโยชน์

ส่งคำถามจริงและข้อความตัวเลือกครบเท่าที่จำเป็นต่อการตีความ รักษาหัวข้อหรือนิยามใกล้เคียงเมื่อกำหนดความหมายของข้อความ ในตัวอย่าง Transformers ที่เผยแพร่ คำค้นและข้อความถูกแปลงเป็นโทเค็นร่วมกันพร้อมการตัดทอนและ max_length=512 นี่เป็นค่าตัวอย่าง ไม่ใช่ขีดจำกัดโมเดลโดยรวม คงคำถามและหลักฐานที่ต้องใช้ไว้ในงบคู่ที่เลือก และตรวจว่าการตัดทอนลบอะไร ผลที่กล่าวถึงสินค้าเดียวกับคำค้นยังอาจไม่เกี่ยวข้องหากตอบการดำเนินการหรือเงื่อนไขผิด ให้เตรียมตัวอย่างที่แยกกรณีเหล่านี้เมื่อประเมินคุณภาพการค้นคืน

สำหรับผู้ช่วยเอกสาร ให้เก็บตัวระบุตัวเลือกไว้กับข้อความ ให้คะแนนคู่คำถาม–ข้อความ แล้วส่งข้อความต้นฉบับที่เลือกไปขั้นตอนตอบ โมเดลตอบจึงได้รับหลักฐาน แทนคะแนนความเกี่ยวข้องที่ไม่มีต้นฉบับ นี่เป็นตัวอย่างเวิร์กโฟลว์ค้นคืน ตัว reranker เองไม่ได้ค้นคอลเลกชันภายนอกหรือเขียนคำตอบ

อ่านและปรับคะแนนให้เป็นมาตรฐาน

ผู้ผลิตส่งคะแนนความเกี่ยวข้องดิบ โดยค่าสูงกว่าหมายถึงตรงกันมากกว่า การปรับมาตรฐานที่เลือกใช้ตามเอกสารใช้ฟังก์ชัน sigmoid เพื่อให้คะแนนอยู่ระหว่าง 0 กับ 1 คะแนนที่ปรับแล้วมีช่วงที่ใช้ง่าย แต่การแปลงนั้นเพียงอย่างเดียวไม่ได้ยืนยันความน่าจะเป็นที่ปรับเทียบแล้วว่าตัวเลือกถูกต้อง

เลือกเกณฑ์จัดอันดับหรือกรองด้วยคู่คำค้น–ข้อความที่เป็นตัวแทนของงาน รวมทั้งข้อความที่มีคำสำคัญร่วมแต่ตอบคนละคำถาม และข้อความที่เกี่ยวข้องแต่ใช้ถ้อยคำต่างกัน ทำให้เกณฑ์ที่เลือกมีความหมายกับคอลเลกชันที่ค้นหา

สำหรับโครงการ Ailoot API ให้กำหนดว่าบริบทสุดท้ายควรมีอะไรและตรวจตัวเลือกได้กี่รายการอย่างมีประสิทธิภาพ ผลที่ใช้ได้คือชุดหลักฐานที่เรียงดีขึ้นสำหรับขั้นตอนแอปพลิเคชันถัดไป แยกผลความเกี่ยวข้องของรุ่นนี้จาก embedding เอกสาร ร้อยแก้วที่สร้าง และตัวควบคุมเลือกชั้นตามเอกสารของ reranker อื่น

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`	เงื่อนไขคีย์ 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 ที่เกี่ยวข้องสำหรับเรียกใช้โมเดล

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