ShareAI Platform Docs

จัดอันดับเอกสารใหม่

ระบุ query และเอกสารจำนวน 1–1000 ฉบับ.

ดูในรูปแบบ Markdown
ในหน้านี้
POST https://api.shareai.now/api/v1/rerank

จัดอันดับเอกสารใหม่

Base URL → URL พื้นฐาน
https://api.shareai.now
การตรวจสอบสิทธิ์
Bearer API key หรือโทเค็นการเข้าถึง OAuth ที่ได้รับการอนุมัติ
ขอบเขตที่จำเป็น
inference or monetization_gateway

ให้คำค้นหาและเอกสาร 1–1000 ฉบับ แต่ละเอกสารเป็นข้อความ {"text":"..."} วัตถุ หรือวัตถุที่รองรับโดยโมเดล {"image":"https://..."} วัตถุ. top_n ต้องมีอย่างน้อย 1 และไม่เกินจำนวนเอกสาร จับคู่ผลลัพธ์กับดัชนีเอกสารต้นฉบับ.

ก่อนเริ่มต้น#

ตั้งค่า SHAREAI_API_KEY บนเซิร์ฟเวอร์ของคุณและแทนที่ placeholder ของโมเดลด้วยโมเดลที่เปิดใช้งานในปัจจุบัน ห้ามเปิดเผย API key ในโค้ดเบราว์เซอร์ โมเดล บัญชี ข้อมูลรับรอง และผู้ให้บริการต้องอนุญาตการดำเนินการนี้ การตั้งค่าเพิ่มเติมด้านล่างต้องการการสนับสนุนจากโมเดล ขอบเขตความปลอดภัยของ API ไม่ใช่คำสัญญาว่าโมเดลทุกตัวจะรองรับค่าทุกค่า.

ส่งคำขอ#

cURL

curl --fail-with-body --request POST "https://api.shareai.now/api/v1/rerank" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_ENABLED_RERANK_MODEL",
  "query": "A cat",
  "documents": [
    {
      "text": "A cat on a windowsill."
    },
    {
      "text": "A map of Berlin."
    }
  ],
  "top_n": 1
}'

ฟิลด์คำขอ#

ฟิลด์ประเภทความหมายและข้อจำกัด
model จำเป็นสตริงตัวระบุโมเดลสาธารณะที่เปิดใช้งานอย่างแม่นยำ ต้องประกาศการดำเนินการนี้และได้รับอนุญาตจากข้อมูลรับรองของคุณ.
query จำเป็นสตริงคำค้นหาที่เกี่ยวข้องต้องไม่ว่างเปล่า.
documents จำเป็นarray → อาร์เรย์สตริงข้อความที่ไม่ว่างเปล่า 1–1000 หรือวัตถุข้อความ/ภาพที่มีคีย์เดียว ค่าภาพต้องเป็น HTTPS URLs หรือข้อมูล URL ภาพที่รองรับ โดยมีการรองรับการป้อนภาพของโมเดล.
top_nจำนวนเต็มจำนวนผลลัพธ์ที่เลือกได้ตั้งแต่ 1 ถึงจำนวนเอกสาร ดัชนีที่ส่งคืนจะอ้างถึงอาร์เรย์เอกสารต้นฉบับ.
return_documentsboolean → บูลีนการรวมเอกสารต้นฉบับในผลลัพธ์ที่รองรับโดยผู้ให้บริการเป็นตัวเลือก.
providerออบเจ็กต์การตั้งค่าการกำหนดเส้นทางผู้ให้บริการที่เลือกได้ ใช้ provider.only สำหรับแท็กผู้ให้บริการที่ยอมรับ ไม่ใช่คำนำหน้าใน ID โมเดล ข้อจำกัดบัญชีและข้อมูลรับรองยังคงมีผล.

อ่านผลลัพธ์#

การดำเนินการสำเร็จจะส่งคืน HTTP 200 พร้อม JSON ให้คำค้นหาและเอกสาร 1–1000 ฉบับ แต่ละเอกสารเป็นข้อความ {"text":"..."} วัตถุ หรือวัตถุที่รองรับโดยโมเดล {"image":"https://..."} วัตถุ. top_n ต้องมีอย่างน้อย 1 และไม่เกินจำนวนเอกสาร จับคู่ผลลัพธ์กับดัชนีเอกสารต้นฉบับ.

หน่วยการเรียกเก็บเงิน#

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

เลือกตัวระบุโมเดลที่เปิดใช้งานจาก Console ความสามารถในการดำเนินการและอินพุต/เอาต์พุตที่ประกาศไว้ต้องตรงกับ endpoint นี้ โมเดลแชทข้อความไม่สามารถแทนที่การดำเนินการอื่นได้ ข้อจำกัดข้อมูลรับรอง ผู้ให้บริการ และบัญชีของคุณยังคงมีผล.

การกำหนดราคาและการใช้งาน#

อัตราค่าบริการถูกเผยแพร่ในเครดิต AI สกุลเงิน EUR สำหรับโมเดล ผู้ให้บริการ หน่วย และตัวแปรที่เลือก เฉพาะมิติในอัตราภาษีที่ใช้งานอยู่เท่านั้นที่ถูกเรียกเก็บเงิน การประมาณการจะสำรองเครดิตก่อนการดำเนินการ ค่าใช้จ่ายสุดท้ายใช้การใช้งานที่วัดได้ ราคาอาจขึ้นอยู่กับความละเอียด รูปแบบเอาต์พุต หรือช่วงการใช้งาน ตรวจสอบ Console Usage สำหรับการหักเครดิต ShareAI สุดท้าย ฟิลด์ต้นทุนต้นน้ำและไบต์สื่อจะไม่ถูกแปลงเป็นจำนวน token ที่ถูกสร้างขึ้น.

การเข้าถึงและข้อผิดพลาด#

การใช้งาน inference สำหรับการอนุมานต้นทุนเครือข่ายที่ได้รับการอนุมัติหรือ monetization_gateway สำหรับการเพิ่มราคาของ Builder ที่ได้รับการอนุมัติและเงื่อนไขการเรียกเก็บเงินที่ยอมรับ การเข้าถึงเฉพาะตัวตนไม่อนุญาตให้ใช้จ่าย การตรวจสอบ การอนุญาตโมเดล เครดิตไม่เพียงพอ ขีดจำกัดอัตรา และความล้มเหลวในการดำเนินการจะส่งคืน error. หลังจากหมดเวลาหรือการส่งที่ไม่แน่นอน ให้ตรวจสอบ Usage หรือวิดีโอ job ก่อนสร้างคำขอที่อาจมีค่าใช้จ่ายอีกครั้ง.

อัปเดตล่าสุด พฤศจิกายน 3, 2026

เอกสารแพลตฟอร์ม ShareAI
เอกสารทั้งหมด

ค้นหาตามชื่อหรือเนื้อหา.

สอบถามเกี่ยวกับหน้านี้

เลือกผู้ช่วยเพื่อสำรวจหน้านี้ คุณยังสามารถคัดลอกหน้าและวางลงในบทสนทนาของคุณได้.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI