Qwen: Qwen3 Embedding 4B
Qwen3-Embedding-4B stellt Text als semantische Vektoren für mehrsprachige Suche, Codesuche, Klassifikation und Clustering dar. Dieses 4B-Modell unterstützt eine Sequenzlänge von 32K Token und anpassbare Vektordimensionen von 32 bis 2.560.
Ü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.
Qwen3-Embedding-4B ist die 4B-Ausgabe für Text-Embeddings in Qwens Embedding- und Reranking-Familie. Auf Grundlage des dichten Qwen3-Basismodells wandelt es einen Textabschnitt in eine numerische Darstellung seiner Bedeutung um. Qwen nennt Textsuche, Codesuche, Klassifikation, Clustering und Bitext-Mining als Anwendungsbereiche. Es ist nützlich, wenn eine Anwendung verwandte Passagen finden, ähnliche Datensätze gruppieren oder Texte sprachübergreifend vergleichen muss. Die Ausgabe des Modells ist ein Embedding-Vektor, keine Gesprächsantwort und kein umgeschriebenes Dokument.
Diese genaue Ausgabe hat eine Sequenzlänge von 32K Token und eine Embedding-Dimension von bis zu 2.560. Durch Matryoshka Representation Learning unterstützt sie anpassbare Ausgabedimensionen von 32 bis 2.560. Die gewählte Vektorlänge beeinflusst die Speicherung und den Vergleich der Darstellung. Verwenden Sie deshalb innerhalb einer Sammlung dieselbe Länge für Anfrage- und Dokumentvektoren. Qwen3-Embedding-8B hat eine andere Modellgröße und maximal 4.096 Dimensionen; weder diese Ausgabegröße noch die Identität des 8B-Modells übertragen sich auf diese 4B-Ausgabe. Ein bestehender Index sollte seine eigenen konsistenten Darstellungseinstellungen beibehalten.
Der Hersteller beschreibt die Unterstützung von mehr als 100 Sprachen, einschließlich Programmiersprachen, mit mehrsprachiger und sprachübergreifender Suche sowie Codesuche. Eine beispielhafte Suche in einem Hilfecenter kann die Frage eines Nutzers mit Passagen in mehreren Sprachen vergleichen und anschließend die thematisch passenden Originalpassagen zurückgeben. Eine Codesuche kann eine Beschreibung in natürlicher Sprache mit relevanten Funktionen und ihrer Dokumentation vergleichen. Erhalten Sie bei der Textvorbereitung aussagekräftige Überschriften, Fachbegriffe und Kennungen und halten Sie jede dargestellte Passage mit ihrer Quelle verknüpft, damit die Anwendung das passende Material anzeigen kann.
Qwen3-Embedding-4B berücksichtigt Anweisungen. Qwen empfiehlt, jeder Suchanfrage eine auf die gewünschte Suchbeziehung zugeschnittene Aufgabenbeschreibung in einem Satz hinzuzufügen, und empfiehlt für mehrsprachige Szenarien englische Anweisungen. Im direkten Beispiel steht Instruct: vor der Aufgabenbeschreibung und Query: vor dem Anfragetext. Die Suchdokumente werden ohne diese Anfrageanweisung codiert. Eine praktische eigene Anweisung kann festlegen, Dokumentationspassagen zu finden, die einen gemeldeten Fehler erklären, oder Quellcodeauszüge, die das beschriebene Verhalten implementieren. Dies richtet die Darstellung auf die Frage der Anwendung aus, statt das Modell um eine ausformulierte Antwort zu bitten.
Die offiziellen Beispiele codieren Anfrage- und Dokumenttexte, vergleichen ihre Embeddings anhand der Kosinusähnlichkeit und zeigen das Pooling des verborgenen Zustands des letzten Tokens mit anschließender Normalisierung. In diesem Beispiel auf niedrigerer Ebene wird die Eingabe bei einer gewählten Einstellung von 8.192 Token gekürzt; die dokumentierte Modellsequenzlänge bleibt 32K. Entscheiden Sie bei langem Material, welche Passagen dargestellt werden sollen, und stellen Sie sicher, dass die Kürzung nicht unbemerkt den Teil verwirft, den die Anfrage benötigt. Speichern Sie Vektoren mit stabilen Quellverweisen, vergleichen Sie die vorbereitete Anfrage mit der Sammlung und geben Sie die zugehörigen Passagen nach Ähnlichkeit geordnet zurück.
Qwens Embedding-Modell verwendet einen Dual-Encoder-Ansatz, während seine separaten Reranking-Modelle einen Cross-Encoder zur Bewertung von Anfrage-Dokument-Paaren einsetzen. Die Veröffentlichung beschreibt den gemeinsamen Einsatz dieser Module: Embeddings finden erste Kandidaten, und ein Reranker kann anschließend deren Reihenfolge verfeinern. Qwen3-Embedding-4B selbst liefert die Darstellung eines einzelnen Textes. Sein Vektor ist weder ein Reranker-Score noch eine überprüfte Aussage oder eine erzeugte Antwort. Wenn der abschließende Ablauf Fragen anhand abgerufenen Materials beantwortet, bleiben die ausgewählten Quellpassagen die Belege, die an diesen späteren Schritt übergeben werden.
Ailoot Ultra · Embeddings POST /v1/embeddings qwen/qwen3-embedding-4b
qwen/qwen3-embedding-4bEinstieg
Qwen3-Embedding-4B stellt Text als semantische Vektoren für mehrsprachige Suche, Codesuche, Klassifikation und Clustering dar. Dieses 4B-Modell unterstützt eine Sequenzlänge von 32K Token und anpassbare Vektordimensionen von 32 bis 2.560.
- Zulässige Eingaben
- Text · token_ids
- Ergebnisse
- embedding
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Embeddings POST /v1/embeddings
- Eingabe
text,token_ids- Ausgabe
embedding- Ausgabeformat
- json
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits qwen/qwen3-embedding-4b | 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: 32 768 · 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: Die Quelle lässt dieses JSON-Metadatenfeld zu; die genaue Semantik des vorgelagerten Systems ist modellspezifisch. | Standard— |
Feldsession_id | Typjson_value | AnforderungOptional | Werte und Limits Bedingungen: Die Quelle lässt dieses JSON-Metadatenfeld zu; die genaue Semantik des vorgelagerten Systems ist modellspezifisch. | Standard— |
Feldtrace | Typjson_value | AnforderungOptional | Werte und Limits Bedingungen: Die Quelle lässt dieses JSON-Metadatenfeld zu; die genaue Semantik des vorgelagerten Systems 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 | Vertrag32768 |
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.00004 / 1K Tokens Ausgabe · Ausgabetoken $0 / 1K Tokens Eingabe · Cache lesen — / 1K Tokens Eingabe · In Cache schreiben — / 1K Tokens Eingabe · In Cache schreiben, 1 Stunde — / 1K Tokens |
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": "qwen/qwen3-embedding-4b", "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='qwen/qwen3-embedding-4b',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 qwen/qwen3-embedding-4b
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
FAQ · Qwen: Qwen3 Embedding 4B
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/embeddings·qwen/qwen3-embedding-4b:text,token_ids→embedding- Welche Felder verwendet die Anfrage?
POST /v1/embeddings·qwen/qwen3-embedding-4b:model,input,encoding_format,provider- Welche Grenzen gelten?
POST /v1/embeddings·qwen/qwen3-embedding-4b:input.budget.maximum:32768(UTF8-Bytes);input.min_items:1