BAAI: bge-base-en-v1.5
BAAI bge-base-en-v1.5 ממיר טקסט באנגלית לווקטורים בעלי 768 ממדים למשימות חיפוש סמנטי ודמיון. חלון הקלט בן 512 הטוקנים והוראת האחזור לשאילתה בלבד מתאימים לקטעים ממוקדים באינדקס חיפוש מסמכים או ידע.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
bge-base-en-v1.5 הוא מודל של BAAI בגודל Base להטמעות צפופות באנגלית. הוא ממיר כל טקסט לייצוג מספרי בן 768 ממדים לאחזור ולהשוואה סמנטית. המודל שייך לקו BGE v1.5, שמטפל בהתפלגות ציוני הדמיון של המשפחה הקודמת ומשפר אחזור כאשר לא מסופקת הוראה. הפלט שלו הוא וקטור המשמש להשוואת טקסטים או למציאת קטעים רלוונטיים.
הכינו שאילתות וקטעים
לשאילתה קצרה המחפשת קטעים ארוכים יותר, BAAI ממליצה להקדים לשאילתה את “Represent this sentence for searching relevant passages:”. קטעי הקורפוס אינם מקבלים את ההוראה הזאת. במשימות אחרות אפשר להטמיע ישירות את הטקסט המקורי. היצרן מציין ש־v1.5 פועל גם ללא הוראה, ולכן יש לבחור את ההכנה לפי המשימה במקום לראות בקידומת את הקלט התקף היחיד.
אוסף חיפוש מעשי יכול להכיל מאמרי עזרה, הסברי מוצר או הוראות טכניות. שאילתה כגון “How do I change the export format?” צריכה לאחזר את הקטע שמתאר את הפעולה הזאת. שמרו יחד את כותרת המקטע, התנאים הרלוונטיים וטקסט המקור בפועל. אחסנו את מזהה הקטע ואת מיקומו לצד הווקטור שלו, כדי שתוצאת חיפוש תוכל להחזיר משהו שהמשתמש יכול לקרוא או ששלב תשובה מאוחר יותר יכול לצטט.
פורמט הווקטור והשוואה
הייצוג המתועד משתמש במצב החבוי האחרון של הטוקן הראשון, או טוקן CLS, כהטמעת המשפט. דוגמאות היצרן מנרמלות את הווקטור ומשוות הטמעות מנורמלות באמצעות מכפלה סקלרית, השקולה לדמיון קוסינוס. 768 הממדים הם גודל ייצוג הפלט של המודל הזה; הם אינם אורך הקשר לבחירה או הקצאה ליצירת טקסט.
השתמשו באותו מודל ובאותה מוסכמת הכנה עבור וקטורי השאילתה והקורפוס שמושווים. בדיקה מעשית היא לאחזר קטעים שידוע שהם מכילים תשובות לקבוצה קטנה של שאלות משתמש בפועל, ואז לבדוק את הטקסט שהוחזר. צורת וקטור תואמת מאפשרת לאינדקס לאחסן את הייצוג, ואילו קטע המקור קובע מה התוצאה אומרת בפועל.
אורך קלט והכנת מסמכים
אורך הרצף המתועד של המודל הוא 512 טוקנים. לכן יש לחלק מקור ארוך לקטעים קוהרנטיים המכילים תשובות לפני ההטמעה. שמרו הגדרות וחריגים עם האמירה שהם מסייגים, ושמרו על הקשר בין קטע למסמך האב שלו. הטקסט שיוטמע כולל כל הוראה או כותרת שתוסיפו, ולכן הכנה תמציתית משאירה יותר מקום לתוכן מקור שימושי.
בדוח או במדריך, בחרו גבולות סביב מקטע או קבוצה קטנה של פסקאות קשורות. קטע שמכיל רק כותרת או שבר בלי הנושא שלו עשוי להיות קשה לפירוש כאשר הוא מאוחזר. שמרו את הטקסט המקורי ואת גרסת המקור, כדי שעדכון האינדקס יוכל להחליף את החומר המתאים כשהמסמך משתנה.
ציונים ופלט שימושי
BAAI מזהירה שערכי דמיון מוחלטים אינם ספים אוניברסליים להחלטה ששני טקסטים אומרים אותו דבר. הדירוג היחסי חשוב, ויש לבחור סף סינון באמצעות ההתפלגות על הנתונים של המשימה עצמה. דמיון וקטורים גבוה הוא אות לאחזור ולא אימות של התוכן העובדתי בקטע.
התוצר השימושי הוא אינדקס קטעים באנגלית, קבוצת וקטורי שאילתות או תכונות מספריות להשוואה סמנטית. מדרג מחדש נפרד יכול לחדד מועמדים שאוחזרו, ושלב יצירה נפרד יכול לכתוב תשובה מהטקסט שלהם. מודל Base המדויק הזה באנגלית, בגרסת v1.5, נשאר נבדל מ־BGE Large, מהמהדורות הסיניות ומפרופילי האחזור הרב־לשוניים וההיברידיים של BGE-M3.
Ailoot Ultra · ייצוגים וקטוריים POST /v1/embeddings baai/bge-base-en-v1.5
baai/bge-base-en-v1.5התחלה
BAAI bge-base-en-v1.5 ממיר טקסט באנגלית לווקטורים בעלי 768 ממדים למשימות חיפוש סמנטי ודמיון. חלון הקלט בן 512 הטוקנים והוראת האחזור לשאילתה בלבד מתאימים לקטעים ממוקדים באינדקס חיפוש מסמכים או ידע.
- סוגי קלט נתמכים
- טקסט · token_ids
- תוצאות
- embedding
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · ייצוגים וקטוריים POST /v1/embeddings
- סוגי קלט
text,token_ids- סוגי פלט
embedding- פורמט פלט
- json
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות baai/bge-base-en-v1.5 | ברירת מחדל— |
שדהinput | סוגstring|string[]|integer[]|integer[][] | דרישהחובה | ערכים ומגבלות מספר פריטים מזערי: 1 תנאים: אצווה אחידה שאינה ריקה. מזהי הטוקנים הם מספרים שלמים אי־שליליים. תקציב קלט: מקסימום: 512 · יחידת טקסט: בתים בקידוד UTF8 · יחידת טוקנים: רכיבים במערך טוקנים | ברירת מחדל— |
שדהencoding_format | סוגstring | דרישהרשות | ערכים ומגבלות float | ברירת מחדלfloat |
שדהdimensions | סוגinteger | דרישהלא נתמך | ערכים ומגבלות מינימום: 1 | ברירת מחדל— |
שדהuser | סוגjson_value | דרישהרשות | ערכים ומגבלות תנאים: המקור מאפשר שדה מטא־נתונים זה ב־JSON; המשמעות המדויקת אצל הספק תלויה במודל. | ברירת מחדל— |
שדהsession_id | סוגjson_value | דרישהרשות | ערכים ומגבלות תנאים: המקור מאפשר שדה מטא־נתונים זה ב־JSON; המשמעות המדויקת אצל הספק תלויה במודל. | ברירת מחדל— |
שדהtrace | סוגjson_value | דרישהרשות | ערכים ומגבלות תנאים: המקור מאפשר שדה מטא־נתונים זה ב־JSON; המשמעות המדויקת אצל הספק תלויה במודל. | ברירת מחדל— |
שדהprovider | סוגobject | דרישהרשות | ערכים ומגבלות תנאים: provider.options נדחה | ברירת מחדל— |
שילובים של חומרי קלט
text_to_embedding
פרמטרים ומחזור חיים של השיטה
| פרמטר | מפרט |
|---|---|
פרמטרcontent_type | מפרטapplication/json |
פרמטרrequired | מפרטmodel, input |
פרמטרinput_shapes | מפרטstring, string[], nonnegative_integer_token_array, nonnegative_integer_token_array[] |
פרמטרencoding_format | מפרטfloat |
פרמטרdimensions_override | מפרטfalse |
פרמטרmax_input_budget_units | מפרט512 |
פרמטרmultimodal_objects | מפרטfalse |
פרמטרmaterial_types | מפרטtext, token_ids |
מחזור חיים: synchronous_json
שמרו כל אינדקס וקטור וממד.
שם מודל רב־מודאלי אינו מאפשר אובייקטי תמונה בנתיב המדויק הזה.
תעריפים
מידע תעריפים אינו מוסיף אפשרויות לבקשה. הפרמטרים הנתמכים מפורטים בשיטה שנבחרה.
- מצב מהיר
- לא צוין כאשר נבחר מצב מהיר
- מצב Flex
- לא צוין כאשר נבחר מצב flex
- מאמץ חשיבה מרבי
- לא צוין כאשר מאמץ החשיבה המרבי משתמש בהתאמת ברירת המחדל (default)
תעריפי Ailoot
מחירים לפי תצורה
| תצורה | טבלת תעריפים | חיוב |
|---|---|---|
| תצורהתעריפי הבסיס לטוקנים | טבלת תעריפיםתעריף בסיס | חיוב קלט · טוקני קלט $0.00001 / 1K טוקנים פלט · טוקני פלט $0 / 1K טוקנים קלט · קריאה מהמטמון — / 1K טוקנים קלט · כתיבה למטמון — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה — / 1K טוקנים |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
דוגמאות לבקשות
Ailoot Ultra · ייצוגים וקטוריים
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "baai/bge-base-en-v1.5", "input": ["First document", "Second document"]}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/embeddings \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path("result.json").read_text())
for x in r.get("data",[]): print(json.dumps({"index":x.get("index"),"embedding":x.get("embedding")}))
PY_RESULT
from openai import OpenAI
import os
client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.embeddings.create(model='baai/bge-base-en-v1.5',input=["First document","Second document"])
print(result)
for item in result.data:print(item.index,item.embedding)
קבלה ושמירה של תוצאות
Ailoot Ultra · ייצוגים וקטוריים
json
שמירת כל התוצאות שהושלמו
שמרו כל תגובה מלאה, קובץ ומקטע תוכן שהוחזרו.
שמרו כל וקטור עם האינדקס שלו. מספר הווקטורים חייב להיות שווה למספר פריטי הקלט; מספר הממדים חייב להיות עקבי.
כשצריך לבדוק את התגובה המקורית
לא מתווספת נקודת קצה למשימות הטמעה.
שדות התגובה
| שדה | סוג |
|---|---|
שדהobject | סוגstring |
שדהmodel | סוגstring |
שדהdata[].index | סוגinteger |
שדהdata[].embedding | סוגfinite float[] |
שדהusage | סוגobject |
שגיאות והשלבים הבאים
| תגובה | תנאי | השלב הבא |
|---|---|---|
תגובה400 · invalid_request_error | תנאישדות נדרשים, ייצוג חומר או ערך פרמטר שאינם תקינים | השלב הבאתקנו את השדות שצוינו לפני בקשת יצירה חדשה. |
כינויים
כינויים למודל
Ailoot Ultra baai/bge-base-en-v1.5
כינויים לנתיבי שיטות
השתמשו בנתיבי השיטות המוצגים למעלה.
מזהי מודלים קשורים IDs
FAQ · BAAI: bge-base-en-v1.5
- אילו קלטים ותוצאות זמינים?
POST /v1/embeddings·baai/bge-base-en-v1.5:text,token_ids→embedding- באילו שדות הבקשה משתמשת?
POST /v1/embeddings·baai/bge-base-en-v1.5:model,input,encoding_format,provider- אילו מגבלות חלות?
POST /v1/embeddings·baai/bge-base-en-v1.5:input.budget.maximum:512(בתים בקידוד UTF8);input.min_items:1