Model reference · open weights
msmarco-MiniLM-L12-en-de is an open-weight embedding model from cross-encoder. AxForge deploys and operates it for you on dedicated EU-owned hardware — with the licence handled where one is required.
Available as managed deployment — configured and operated for you on dedicated EU hardware, quoted per deployment.
What it is
| Maker | cross-encoder |
|---|---|
| Type | Embedding models |
| Task | Reranker |
| Parameters (lead) | 118M |
| Context | 512 tokens |
| Runs with | sentence-transformers |
| Based on | microsoft/Multilingual-MiniLM-L12-H384 |
| Released | 2022-03-02 |
| Popularity | 2k downloads / month |
| Licence | Open weights |
About
This is a cross-lingual Cross-Encoder model for EN-DE that can be used for passage re-ranking. It was trained on the MS Marco Passage Ranking task.
The model can be used for Information Retrieval: See SBERT.net Retrieve & Re-rank.
The training code is available in this repository, see train_script.py.
When you have SentenceTransformers installed, you can use the model like this:
from sentence_transformers import CrossEncoder
model = CrossEncoder('model_name', max_length=512)
query = 'How many people live in Berlin?'
docs = ['Berlin has a population of 3,520,031 registered inhabitants in an area of 891.82 square kilometers.', 'New York City is famous for the Metropolitan Museum of Art.']
pairs = [(query, doc) for doc in docs]
scores = model.predict(pairs)
With the transformers library, you can use the model like this:
from transformers import AutoTokenizer, AutoModelForSequenceClassification
import torch
model = AutoModelForSequenceClassification.from_pretrained('model_name')
tokenizer = AutoTokenizer.from_pretrained('model_name')
features = tokenizer(['How many people live in Berlin?', 'How many people live in Berlin?'], ['Berlin has a population of 3,520,031 registered inhabitants in an area of 891.82 square kilometers.', 'New York City is famous for the Metropolitan Museum of Art.'], padding=True, truncation=True, return_tensors="pt")
model.eval()
with torch.no_grad():
scores = model(**features).logits
print(scores)
The performance was evaluated on three datasets:
We also check the performance of bi-encoders using the same evaluation: The retrieved documents from BM25 lexical search are re-ranked using query & passage embeddings with cosine-similarity. Bi-Encoders can also be used for end-to-end semantic search.
| Model-Name | TREC-DL19 EN-EN | TREC-DL19 DE-EN | GermanDPR DE-DE | Docs / Sec |
|---|---|---|---|---|
| BM25 | 45.46 | - | 35.85 | - |
| Cross-Encoder Re-Rankers | ||||
| cross-encoder/msmarco-MiniLM-L6-en-de-v1 | 72.43 | 65.53 | 46.77 | 1600 |
| cross-encoder/msmarco-MiniLM-L12-en-de-v1 | 72.94 | 66.07 | 49.91 | 900 |
| svalabs/cross-electra-ms-marco-german-uncased (DE only) | - | - | 53.67 | 260 |
| deepset/gbert-base-germandpr-reranking (DE only) | - | - | 53.59 | 260 |
| Bi-Encoders (re-ranking) | ||||
| sentence-transformers/msmarco-distilbert-multilingual-en-de-v2-tmp-lng-aligned | 63.38 | 58.28 | 37.88 | 940 |
| sentence-transformers/msmarco-distilbert-multilingual-en-de-v2-tmp-trained-scratch | 65.51 | 58.69 | 38.32 | 940 |
| svalabs/bi-electra-ms-marco-german-uncased (DE only) | - | - | 34.31 | 450 |
| deepset/gbert-base-germandpr-question_encoder (DE only) | - | - | 42.55 | 450 |
Note: Docs / Sec gives the number of (query, document) pairs we can re-rank within a second on a V100 GPU.
From the published model card. Full card on the HuggingFace links in the sidebar.
Using it via the API
Once AxForge deploys msmarco-minilm-l12-en-de for you, it answers on the OpenAI-compatible API — the same base URL and keys as every other model. (msmarco-minilm-l12-en-de below is illustrative; you get the exact model name on deployment.)
$ curl -sS https://api.axforge.ai/v1/embeddings \
-H "Authorization: Bearer $AXFORGE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"msmarco-minilm-l12-en-de","input":"text to embed"}'
Create an account — your API key is available in the console. 5M tokens/month currently included with every new account at launch.