Modell-IDs & Varianten

Modell-IDs bei api14 haben die Form provider/model, zum Beispiel openai/gpt-5-mini. Übergeben Sie die ID im Feld model jeder Anfrage.

{ "model": "anthropic/claude-sonnet-4.5" }

Modell-IDs finden

• Stöbern Sie auf der Modellseite, jedes Modell mit ID, Preisen, Kontextlänge und Fähigkeiten.
• Rufen Sie GET /models aus dem Code auf; nach Kategorie filtern Sie mit ?category=image. Siehe Modelle.

Einige Beispiele:

IDs unterscheiden Groß- und Kleinschreibung. Eine unbekannte oder deaktivierte ID liefert 404 model_not_found.

Varianten

Eine Variante ist ein Suffix nach einem Doppelpunkt, das ändert, wie die Anfrage bedient wird. Varianten funktionieren mit demselben Basismodell; es gelten die Verfügbarkeits- und Allowlist-Regeln des Basismodells.

{ "model": "openai/gpt-5-mini:online" }

:nitro und :floor sind Kurzformen für die Anbietersortierung, gleichbedeutend mit provider: { sort: "throughput" } und provider: { sort: "price" }. Siehe Provider-Routing & Fallbacks.

Modell-Fallbacks

Senden Sie ein models-Array, um andere Modelle zu versuchen, wenn das erste fehlschlägt oder nicht verfügbar ist:

{
  "model": "anthropic/claude-sonnet-4.5",
  "models": ["openai/gpt-5-mini", "google/gemini-2.5-flash"],
  "messages": [{ "role": "user", "content": "Hello" }]
}

Jedes Modell in der Liste muss verfügbar und für Ihren Schlüssel und Plan erlaubt sein, sonst wird die Anfrage abgelehnt, bevor sie gesendet wird. Das Feld model der Antwort zeigt, welches Modell geantwortet hat, und Sie zahlen den Preis dieses Modells.

Allowlists und Pläne

• Ein Schlüssel mit Modell-Allowlist kann nur die aufgeführten IDs nutzen; andere IDs liefern 403 model_not_allowed.
• Jeder Plan, auch Free, umfasst alle Modellkategorien, darunter Video und Musik/Audio. Ein auf bestimmte Kategorien beschränkter Plan liefert für die übrigen 403 plan_required. Siehe Preise & Abrechnung.

Modelländerungen

Der Katalog wird automatisch aktualisiert. Neue Modelle erscheinen von selbst; entfernte Modelle liefern 404 model_not_found. Legen Sie in der Produktion exakte IDs fest und nutzen Sie models-Fallbacks für Ausfallsicherheit.