Modelle & Aliase

Nach Aufgabe wählen

Ein Alias sagt, wofür ein Modell gedacht ist — nicht, wie viele Parameter es hat. prima-70b wäre heute korrekt und nach dem nächsten Modellwechsel unseres Anbieters eine Lüge. Deshalb heissen sie so, wie sie heissen.

Embeddings sind keine vierte Stufe

prima-embed gehört nicht in die Reihe quick → core → deep. Es ist eine andere Modalität, wird über einen eigenen Endpunkt angesprochen und anders gezählt. Ein Chat-Alias an /embeddings ergibt 400, und umgekehrt genauso.

quick, core oder deep?

Die Unterscheidung zwischen prima-core und prima-deep ist gemessen, nicht behauptet. In einer Testreihe mit absichtlich mehrdeutigen Fällen hat das Modell hinter prima-deep die falsche Übereinstimmung in drei von drei Fällen erkannt, während das schnellere Modell eine plausible Begründung dafür erfunden hat. Umgekehrt war das schnellere Modell beim Entwerfen von Text rund 18-mal schneller.

Praktisch:

• Nehmen Sie prima-core, solange nichts dagegen spricht.
• Nehmen Sie prima-quick, wenn Sie sehr viele gleichartige Aufrufe machen und die Antwort kurz und eindeutig ist.
• Nehmen Sie prima-deep, wenn eine erfundene Begründung teurer wäre als ein paar Sekunden Wartezeit. Rechnen Sie mit zweistelligen Sekunden.

Festgeschriebene Varianten

Zu jedem Alias gibt es ein eingefrorenes Gegenstück mit Datum im Namen. Was prima-core heisst, zeigt immer auf das aktuell beste Modell für diese Aufgabe. Was prima-core-2026-08 heisst, zeigt für immer auf die Zuordnung von August 2026.

Wählen Sie die festgeschriebene Variante, wenn eines davon zutrifft:

• Sie müssen ein Ergebnis später reproduzieren können.
• Ihre Prompts sind auf ein Modellverhalten hin optimiert und ein stiller Wechsel würde Ihre Auswertung ungültig machen.
• Sie arbeiten in einem regulierten Umfeld und dokumentieren, was Sie einsetzen.

Und die gleitende, wenn Sie einfach das jeweils beste Modell wollen.

curl https://api.prima.li/api/prima/v1/chat/completions \
  -H "X-API-Key: $PRIMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "prima-core-2026-08",
    "messages": [{"role": "user", "content": "Sag nur: OK"}],
    "max_tokens": 30
  }'

Warum es Aliase überhaupt gibt

Unser Modellanbieter darf ein benanntes Modell mit 30 Tagen Vorlauf ersetzen, eine Kategorie mit 90, und ein Beta-Modell jederzeit ohne Haftung zurückziehen. Würden wir Ihnen den Herstellernamen direkt geben, wäre deren Fluktuation Ihr Ausfall. Der Alias fängt das ab: wir tauschen die Zuordnung, Sie merken nichts. Genau deshalb steht in der Antwort auch immer Ihr Alias im Feld model und nie ein Herstellername.

Aliase programmatisch lesen

GET /models beschreibt jeden Eintrag selbst. Nutzen Sie diese Felder, statt Namen in Ihren Code zu schreiben:

{
  "object": "list",
  "data": [
    {
      "id": "prima-core",
      "object": "model",
      "owned_by": "prima",
      "prima_kind": "chat",
      "prima_floating": true,
      "prima_pinned_variant": "prima-core-2026-08"
    },
    {
      "id": "prima-core-2026-08",
      "object": "model",
      "owned_by": "prima",
      "prima_kind": "chat",
      "prima_floating": false,
      "prima_pinned_date": "2026-08"
    }
    // … acht Einträge insgesamt
  ]
}

// Richtig: nach den Feldern gruppieren, die die API selbst mitschickt.
const res = await fetch(BASE + "/models", { headers: { "X-API-Key": key } });
const { data } = await res.json();

const chatAliases = data.filter((m) => m.prima_kind === "chat" && m.prima_floating);
const pinnedFor = (alias) => data.find((m) => m.id === alias.prima_pinned_variant);

// Falsch: eine Liste von Namen im eigenen Code.
// const ALIASES = ["prima-quick", "prima-core", "prima-deep"];  // veraltet beim nächsten Pin-Datum

Momentaufnahme vom 2026-08-03; Messwerte auf dieser Seite geprüft am 3. August 2026.