Modell-Stufen

Manche Modelle sind in mehreren Stufen erhältlich. Eine Stufe ist das gleiche Modell zu einem anderen Preis – zum Beispiel eine günstigere Stufe neben der Standard-Stufe. Mit einem API-Schlüssel erreichst du alle Stufen; du wählst eine Stufe anhand des Modellnamens, nicht über einen separaten Schlüssel oder eine Einstellung.

Standard-Stufe

Der einfache Modellname verwendet immer die Standard-Stufe. Bestehende Anfragen funktionieren unverändert weiter, wenn ein Modell eine weitere Stufe erhält.

{ "model": "gpt-image-2" }

Stufe auswählen

Hänge einen Doppelpunkt und die Stufen-ID an den Modellnamen an:

{ "model": "gpt-image-2:<tier>" }

Das funktioniert für Text-, Bild-, Video- und Audiomodelle überall dort, wo die Anfrage ein Modell nennt: das Feld model im JSON-Body, das Formularfeld model beim Audio-Upload und das Modellsegment in einem nativen Gemini-Pfad. Bei einem Gemini-Pfad bleibt die Aktion am Ende:

POST /v1beta/models/<model>:<tier>:generateContent

Stufen eines Modells finden

• Auf jeder Modellseite befindet sich oberhalb der Preistabelle eine Stufenauswahl, die die Preise jeder Stufe und die aufzurufende Modell-ID anzeigt. Auf Seiten mit nur einem Preis werden die Stufen stattdessen in der Tabelle Preisstufen aufgelistet. Beide werden nur angezeigt, wenn das Modell mehr als eine Stufe hat.
• Das Markdown-Handbuch /models/<page>/llms.txt jedes Modells listet die vollständigen Preise für alle Stufen auf.
• GET /v1/models listet <model>:<tier> neben <model> für jedes Modell auf, das dein Schlüssel in mehreren Stufen aufrufen kann.

Im Playground für Textmodelle wechselt die Stufenauswahl zwischen den gleichen Stufen. Der Playground für Bild-, Video- und Audiomodelle verwendet die Stufe Standard; andere Stufen rufen Sie über die API auf.

Abrechnung und Verhalten

• Eine Stufenabfrage wird nur in dieser Stufe ausgeführt und wird zum Preis dieser Stufe abgerechnet.
• Wenn die Stufe die Anfrage nicht bedienen kann, schlägt die Anfrage fehl. Sie wechselt nie zu einer anderen Stufe, daher wird sie nie zu einem anderen Preis abgerechnet.
• Antworten und Aufgabenergebnisse geben den einfachen Modellnamen an.
• Ein Schlüssel, der nur für eine Stufe erstellt wurde, kann diese Stufe und keine andere aufrufen.

Fehler

Die Struktur der Antwort findest du unter Fehler.