Sentence Transformers: all-MiniLM-L12-v2
Sentence Transformers all-MiniLM-L12-v2 kodiert Sätze und kurze Absätze in 384-dimensionale Vektoren für Suche, Ähnlichkeitsvergleiche und Clustering. Das Referenzrezept nutzt Mean-Pooling und Normalisierung; standardmäßig wird bei 256 Wortteilen abgeschnitten.
Über das Modell
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
all-MiniLM-L12-v2 ist ein Sentence-Transformers-Encoder für Sätze und kurze Absätze. Er erzeugt pro Text einen 384-dimensionalen dichten Vektor für semantische Suche, Informationsabruf, Clustering und Satzähnlichkeit. Das Modell nutzt das Basismodell MiniLM-L12-H384-uncased und wurde mit kontrastivem Lernen auf einer Satzsammlung mit einer Milliarde Paaren feinabgestimmt.
Die abzurufende Einheit kodieren
Verwenden Sie einen Satz oder kurzen Absatz, der eine nützliche Aussage ausdrückt. Behalten Sie bei einer Sammlung von Produktbeschreibungen das Merkmal und die Bedingung bei, die den Artikel unterscheiden: „Der Adapter verbindet ein kabelgebundenes Headset mit einem USB-C-Anschluss“ ist aussagekräftiger als „Audiozubehör“. Speichern Sie die Datensatzkennung und die Originalbeschreibung neben dem Vektor.
Eine Suchanfrage lässt sich dann mit den kodierten Beschreibungen vergleichen. Prüfen Sie die zurückgegebenen Kandidaten auf genaue Anforderungen wie Anschlusstyp oder Gerätekompatibilität, bevor Sie eine endgültige Auswahl präsentieren. Der Vektor repräsentiert die Bedeutung des Textes; die umgebende Suchanwendung ruft die zugehörigen Datensätze ab.
Mean-Pooling und normalisierte Vektoren
Das veröffentlichte Kodierungsbeispiel mittelt die Token-Repräsentationen mithilfe der Attention-Maske, sodass Padding-Positionen nicht zum Mittelwert beitragen. Anschließend wird eine L2-Normalisierung angewendet. Diese Schritte gehören zum Referenzrezept für den Satzvektor und sind keine Anweisung, ein beliebiges Token aus dem zugrunde liegenden Transformer zu verwenden.
Halten Sie Modell, Pooling und Normalisierungskonfiguration zwischen indexierten Texten und neuen Anfragen einheitlich. Die resultierenden Repräsentationen mit 384 Komponenten lassen sich per Kosinus-Ähnlichkeit vergleichen. Dokumentieren Sie diese Konfiguration zusammen mit der Sammlung; ein anderer 384-dimensionaler Encoder wird nicht schon dadurch kompatibel, dass seine Vektoren dieselbe Länge haben.
Standard-Eingabelänge und Trainingsumfang
Der Hersteller legt ein standardmäßiges Abschneiden nach 256 Wortteilen fest. Das ist eine Tokenizer-Grenze, keine Anzahl gewöhnlicher Wörter oder Zeichen. Wählen Sie bei einem längeren Datensatz zusammenhängende kurze Abschnitte und bewahren Sie die Überschrift oder das kennzeichnende Detail, das zur Einordnung jedes Abschnitts nötig ist.
Das Trainingsverfahren des Modells verwendete Sequenzen mit bis zu 128 Token. Diese Trainingseinstellung ist unabhängig vom veröffentlichten Standardwert von 256 Wortteilen bei der Kodierung. Eine Passage, die in den Standardwert passt, kann sich dennoch erheblich vom kurzen Satzmaterial des Trainings unterscheiden; bewerten Sie lange oder fachspezifische Beschreibungen daher mit repräsentativen Beispielen.
Workflows für Ähnlichkeit und Clustering
Bei einer Menge von Support-Nachrichten können Embeddings numerische Eingaben für eine Gruppierungsstufe liefern. Prüfen Sie mehrere Nachrichten aus jeder vorgeschlagenen Gruppe sowie solche nahe ihrer Grenze, bevor Sie eine allgemein verständliche Bezeichnung vergeben. Rufen Sie bei der Prüfung auf doppelte Inhalte ähnliche Datensätze ab und vergleichen Sie ihren tatsächlichen Wortlaut; zwei Passagen können dasselbe Thema behandeln und dabei unterschiedliche Anweisungen geben.
Die genaue Edition L12-v2 ist ein englischsprachiges Satz-Embedding-Profil. Sie unterscheidet sich von all-MiniLM-L6-v2 und den paraphrase-MiniLM-Checkpoints. Gemeinsame Familiennamen übertragen weder deren Sequenzkonfiguration noch deren Pooling-Rezept. Nutzen Sie die kompakten dichten Vektoren zusammen mit Quelldatensätzen und aufgabenspezifischer Evaluierung, statt einen Ähnlichkeitswert als verifizierte Antwort oder endgültige redaktionelle Entscheidung zu behandeln.
Ailoot Ultra · Embeddings POST /v1/embeddings sentence-transformers/all-minilm-l12-v2
sentence-transformers/all-minilm-l12-v2
sentence-transformers/all-minilm-l12-v2Start
Sentence Transformers all-MiniLM-L12-v2 kodiert Sätze und kurze Absätze in 384-dimensionale Vektoren für Suche, Ähnlichkeitsvergleiche und Clustering. Das Referenzrezept nutzt Mean-Pooling und Normalisierung; standardmäßig wird bei 256 Wortteilen abgeschnitten.
- Zulässige Eingaben
- Text · token_ids
- Ergebnisse
- embedding
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Embeddings POST /v1/embeddings
- Eingabetypen
text,token_ids- Ausgabetypen
embedding- Ausgabeformat
- json
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits sentence-transformers/all-minilm-l12-v2 | Standard— |
Feldinput | Typstring|string[]|integer[]|integer[][] | AnforderungErforderlich | Werte und Limits Mindestanzahl Elemente: 1 Bedingungen: Nicht leerer, homogener Batch. Token-IDs sind nichtnegative Ganzzahlen. Eingabebudget: Maximum: 512 · Texteinheit: UTF8-Bytes · Tokeneinheit: Elemente des Token-Arrays | Standard— |
Feldencoding_format | Typstring | AnforderungOptional | Werte und Limits float | Standardfloat |
Felddimensions | Typinteger | AnforderungNicht unterstützt | Werte und Limits Minimum: 1 | Standard— |
Felduser | Typjson_value | AnforderungOptional | Werte und Limits Bedingungen: Der Quellcode erlaubt dieses JSON-Metadatenfeld; die genaue Semantik beim vorgelagerten Anbieter ist modellspezifisch. | Standard— |
Feldsession_id | Typjson_value | AnforderungOptional | Werte und Limits Bedingungen: Der Quellcode erlaubt dieses JSON-Metadatenfeld; die genaue Semantik beim vorgelagerten Anbieter ist modellspezifisch. | Standard— |
Feldtrace | Typjson_value | AnforderungOptional | Werte und Limits Bedingungen: Der Quellcode erlaubt dieses JSON-Metadatenfeld; die genaue Semantik beim vorgelagerten Anbieter ist modellspezifisch. | Standard— |
Feldprovider | Typobject | AnforderungOptional | Werte und Limits Bedingungen: provider.options abgelehnt | Standard— |
Kombinationen von Eingabematerialien
text_to_embedding
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, input |
Parameterinput_shapes | Vertragstring, string[], nonnegative_integer_token_array, nonnegative_integer_token_array[] |
Parameterencoding_format | Vertragfloat |
Parameterdimensions_override | Vertragfalse |
Parametermax_input_budget_units | Vertrag512 |
Parametermultimodal_objects | Vertragfalse |
Parametermaterial_types | Vertragtext, token_ids |
Lebenszyklus: synchronous_json
Jeden Vektorindex und jede Dimension beibehalten.
Ein multimodaler Modellname erlaubt auf genau diesem Pfad keine Bildobjekte.
Tarife
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
- Schnellmodus
- Nicht angegeben Wenn der Schnellmodus ausgewählt ist
- Flex-Modus
- Nicht angegeben Wenn der Modus flex ausgewählt ist
- Maximaler Denkaufwand
- Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird
Ailoot-Tarife
Preise nach Konfiguration
| Konfiguration | Tarifstaffel | Gebühr |
|---|---|---|
| KonfigurationBasistarife für Token | TarifstaffelGrundtarif | Gebühr Eingabe · Eingabetoken $0.00001 / 1K Token Ausgabe · Ausgabetoken $0 / 1K Token Eingabe · Cache-Lesen — / 1K Token Eingabe · Cache-Schreiben — / 1K Token Eingabe · Cache-Schreiben, 1 Stunde — / 1K Token |
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschließenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Beispielanfragen
Ailoot Ultra · Embeddings
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "sentence-transformers/all-minilm-l12-v2", "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='sentence-transformers/all-minilm-l12-v2',input=["First document","Second document"])
print(result)
for item in result.data:print(item.index,item.embedding)
Ergebnisse abrufen und speichern
Ailoot Ultra · Embeddings
json
Alle fertiggestellten Ergebnisse aufbewahren
Bewahren Sie jede vollständig zurückgegebene Antwort, Datei und jeden Inhaltsteil auf.
Jeden Vektor mit seinem Index beibehalten. Die Anzahl der Vektoren muss der Anzahl der Eingaben entsprechen; die Dimensionen müssen konsistent sein.
Wenn die ursprüngliche Antwort geprüft werden muss
Es wird kein Endpunkt für Embedding-Aufträge eingeführt.
Antwortfelder
| Feld | Typ |
|---|---|
Feldobject | Typstring |
Feldmodel | Typstring |
Felddata[].index | Typinteger |
Felddata[].embedding | Typfinite float[] |
Feldusage | Typobject |
Fehler und nächste Schritte
| Antwort | Bedingung | Nächster Schritt |
|---|---|---|
Antwort400 · invalid_request_error | BedingungPflichtfelder, Darstellung des Eingabematerials oder Parameterwert ungültig | Nächster SchrittDie angegebenen Felder vor einer neuen Erstellungsanfrage korrigieren. |
Aliasnamen
Modellaliasnamen
Ailoot Ultra sentence-transformers/all-minilm-l12-v2
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
FAQ · Sentence Transformers: all-MiniLM-L12-v2
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/embeddings·sentence-transformers/all-minilm-l12-v2:text,token_ids→embedding- Welche Felder verwendet die Anfrage?
POST /v1/embeddings·sentence-transformers/all-minilm-l12-v2:model,input,encoding_format,provider- Welche Grenzen gelten?
POST /v1/embeddings·sentence-transformers/all-minilm-l12-v2:input.budget.maximum:512(UTF8-Bytes);input.min_items:1