Poziomy modelu

Niektóre modele są dostępne na więcej niż jednym poziomie. Poziom to ten sam model sprzedawany w innej cenie, na przykład tańszy poziom obok poziomu Domyślny. Jeden klucz API uzyskuje dostęp do każdego poziomu; poziom wybierasz po nazwie modelu, nie po osobnym kluczu ani ustawieniu.

Poziom Domyślny

Prosta nazwa modelu zawsze używa poziomu Domyślny. Istniejące żądania pozostają niezmienione, gdy model zyskuje inny poziom.

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

Wybierz poziom

Dodaj dwukropek i ID poziomu do nazwy modelu:

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

Działa to dla modeli tekstowych, obrazowych, wideo i audio, wszędzie tam, gdzie żądanie wymienia model: pole model treści JSON, pole formularza model podczas uploadu audio oraz segment modelu w natywnej ścieżce Gemini. W ścieżce Gemini akcja pozostaje ostatnia:

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

Znajdź poziomy modelu

• Na każdej stronie modelu przełącznik poziomu znajduje się powyżej tabeli cen i pokazuje ceny każdego poziomu oraz ID modelu do wywołania. Strony z jedną ceną pokazują poziomy w tabeli Poziomy cenowe zamiast tego. Oba elementy pojawiają się tylko wtedy, gdy model ma więcej niż jeden poziom.
• Przewodnik Markdown /models/<page>/llms.txt każdego modelu zawiera pełne ceny wszystkich poziomów.
• GET /v1/models wyświetla listę <model>:<tier> obok <model> dla każdego modelu, który twój klucz może wywołać na więcej niż jednym poziomie.

W Playground modeli tekstowych selektor poziomu przełącza się między tymi samymi poziomami. Playground modeli obrazu, wideo i audio używa poziomu Domyślny; inne poziomy wywołuj przez API.

Rozliczenia i zachowanie

• Żądanie poziomu uruchamia się tylko na tym poziomie i jest rozliczane po cenie tego poziomu.
• Jeśli poziom nie może obsłużyć żądania, żądanie nie powiedzie się. Nigdy nie przełącza się na inny poziom, więc nigdy nie jest rozliczane w innej cenie.
• Odpowiedzi i wyniki zadań zgłaszają zwykłą nazwę modelu.
• Klucz, który został utworzony tylko dla jednego poziomu, może wywoływać tylko ten poziom i żaden inny.

Błędy

Postać odpowiedzi opisano w sekcji Błędy.