Jak czytać nazwy modeli AI: alias a przypięta wersja

Otwórz dowolną stronę API AI, a natkniesz się na nazwy takie jak deepseek-flash, deepseek-v4-pro czy DeepSeek-V4-Flash-0731. Wyglądają jak etykiety, ale ciąg znaków, który wstawiasz w pole model, decyduje o tym, który model odpowiada i za co płacisz. Ten przewodnik pokazuje, jak czytać te nazwy, dlaczego ta sama nazwa może się zmienić pod tobą i co sprawdzić, zanim wkleisz id do kodu.

Anatomia nazwy modelu#

Weź DeepSeek-V4-Flash-0731 i podziel go na części:

Dwie uwagi. Sufiks to konwencja, nie prawo: 1017 pasuje do daty wydania DeepSeek-V4.1-Flash-1017 (17 października 2026), ale zawsze potwierdzaj to na stronie modelu, zamiast zgadywać. A nazwa zapisana na stronie dokumentacji (DeepSeek-V4-Flash) nie zawsze jest ciągiem, który akceptuje API (deepseek-v4-flash-0731): nazwa wyświetlana jest dla ludzi, id jest dla kodu.

Flash i Pro#

Deweloperzy zwykle wydają kilka poziomów jednej generacji. Flash to zazwyczaj szybszy, lżejszy poziom przeznaczony do pracy o dużej skali: czat, ekstrakcja, pętle agentów. Pro to zazwyczaj większy poziom do trudniejszych zadań. Te słowa to marketing samego dewelopera, więc nie są porównywalne między rodzinami: Flash jednej firmy nie ma tego samego rozmiaru co Flash innej. Liczy się to, że deepseek-flash i deepseek-v4-pro to dwie różne nazwy modeli, więc sprawdź tabelę cen tego, którego używasz. Jeśli zmienisz poziom, ponownie sprawdź tabelę cen.

Alias a przypięta wersja#

Istnieją dwa rodzaje id, a różnica między nimi jest najważniejszą rzeczą w tym artykule.

• Alias — nazwa, którą dostawca wskazuje na jakiś model i może później wskazać na inny. deepseek-flash to alias: według dokumentacji DeepSeek z 22 października 2026 obsługuje go DeepSeek-V4.1-Flash-1017, a sposób jego wywoływania się nie zmienił. Jutro ten sam ciąg może prowadzić do nowszej kompilacji.
• Przypięta wersja — id, który zawiera kompilację, taki jak deepseek-v4-flash-0731. Wskazuje jedną konkretną kompilację, więc odpowiedzi, które testowałeś wczoraj, powinny dziś pochodzić z tej samej kompilacji.

Alias jest wygodny: dostajesz ulepszenia bez edytowania kodu. Przypięte id jest przewidywalne: dobre do testów, ewaluacji, raportów i wszystkiego, gdzie zmiana zachowania by cię zaskoczyła. Żadne nie jest „lepsze”; wybieraj świadomie.

Ta sama nazwa może się zmienić pod tobą#

Zmiana w DeepSeek z października 2026 to żywy przykład. Według dokumentacji DeepSeek, sprawdzonej 22 października 2026:

• deepseek-flash jest obecnie obsługiwany przez DeepSeek-V4.1-Flash-1017;
• starsze nazwy deepseek-v4-flash i deepseek-v4-flash-vision-exp są nadal akceptowane, ale te modele są wycofane, więc żądania trafiają do DeepSeek-V4.1-Flash-1017 i są rozliczane według ceny Flash;
• deepseek-v4-pro to osobna, aktualna nazwa modelu.

Więc twój stary kod może nadal działać i wciąż uruchamiać inny model niż wtedy, gdy go pisałeś. To w porządku, jeśli chciałeś najnowszego, i pułapka, jeśli porównywałeś wyniki na przestrzeni tygodni. Strona dokumentacji nie ma daty publikacji, więc traktuj to mapowanie jako prawdziwe na powyższą datę i przeczytaj je ponownie, gdy będzie to miało znaczenie. Co zmieniło się w samym modelu, opisano w DeepSeek-V4.1-Flash-1017 is out.

Co sprawdzić, zanim wstawisz id do kodu#

1. Skopiuj id z dokumentacji dostawcy, którego faktycznie wywołujesz. Różni dostawcy nazywają tę samą rodzinę inaczej, więc bierz id z dokumentacji CheapTokens, gdy wywołujesz CheapTokens, a z dokumentacji DeepSeek, gdy wywołujesz DeepSeek. Nie mieszaj ich.
2. Zdecyduj: alias czy przypięta wersja? Jeśli ciąg nie ma daty ani sufiksu kompilacji, zakładaj, że może się zmienić.
3. Sprawdź bazowy URL i styl API. CheapTokens obsługuje formaty OpenAI Chat Completions i Anthropic Messages pod https://api.cheaptokens.dev/v1; własne API DeepSeek używa https://api.deepseek.com (styl OpenAI) i https://api.deepseek.com/anthropic (styl Anthropic). Poprawne id pod złym bazowym URL to błąd.
4. Otwórz tabelę cen dokładnie dla tego id i zanotuj datę. Ceny należą do modelu, nie do rodziny.
5. Trzymaj id w jednym miejscu (pliku konfiguracyjnym lub zmiennej środowiskowej), a nie rozproszone po kodzie.
6. Loguj model, który odpowiedział. Odpowiedzi w stylu OpenAI zawierają pole model; zapisz je obok swoich wyników.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",
    api_key=os.environ["CHEAPTOKENS_API_KEY"],
)

# Take the exact id from the CheapTokens docs; this one is an example.
MODEL_ID = os.environ.get("MODEL_ID", "minimax-m2.7")

response = client.chat.completions.create(
    model=MODEL_ID,
    messages=[{"role": "user", "content": "Say hello in five words."}],
    max_tokens=50,
)

print("asked for:", MODEL_ID)
print("answered by:", response.model)
print(response.choices[0].message.content)

Dwie wydrukowane linie to nawyk wart wyrobienia: o co prosiłeś i co odpowiedziało. Nigdy nie zakodowuj klucza na stałe; zobacz What is an API key and how to store it safely. Jeśli to twoje pierwsze wywołanie, zacznij od Your first API request with CheapTokens.

Porównuj ceny i wyniki wersja po wersji#

Większość zamieszania wynika z porównywania niewłaściwych rzeczy. Zanim porównasz dwie ceny lub dwie odpowiedzi, zapisz dla obu stron: dokładne id, dostawcę i datę. Dwa id, które oba mówią „Flash”, ale mają inną generację lub sufiks kompilacji, to różne modele o różnych datach wydania. To samo dotyczy benchmarków z posta informacyjnego: należą do kompilacji wymienionej w poście i nie są obietnicą dotyczącą żadnego innego id.

Działa to też w drugą stronę. Gdy testujesz model na własnych promptach, utrzymuj stały zestaw promptów i zmieniaj jedną rzecz naraz: id albo prompt, nie oba. Liczysz tokeny do porównania? What is a token wyjaśnia, jak mierzone są liczby.

Przykładowe id do ćwiczeń#

CheapTokens utrzymuje jedno saldo dla wszystkich modeli, więc możesz przełączać id z tym samym kluczem:

• MiniMax-M2.7 (minimax-m2.7, id bramy MiniMaxAI/MiniMax-M2.7): kontekst 180K, do 8 192 tokenów wyjściowych, jedna cena o każdej porze. Wejście $0.05 i wyjście $0.15 za 1M tokenów, oba poniżej referencji OpenRouter.

Poniższa tabela przelicza na żywo dla małego zadania o 100 000 tokenów wejściowych i 20 000 tokenów wyjściowych, z kolumną OpenRouter dla porównania:

Zauważ, że każdy wiersz to jedno konkretne id. Jeśli zamienisz minimax-m2.7 na inne id, zmienisz zarówno model, jak i cenę.

Szybkie podsumowanie#

• Ciąg model decyduje o tym, który model odpowiada i ile to kosztuje.
• Id bez sufiksu kompilacji to prawdopodobnie alias i może zostać przekierowany; id z kompilacją jest przypięte.
• Stare nazwy mogą nadal działać, po cichu uruchamiając nowszy model, jak w przypadku deepseek-v4-flash w dokumentacji DeepSeek z 22 października 2026.
• Flash i Pro to poziomy w obrębie jednej rodziny, a nie uniwersalne rozmiary.
• Zawsze kopiuj id z dokumentacji dostawcy, którego wywołujesz, i loguj, który model odpowiedział.

Gotowy, by spróbować? Zdobądź klucz, doładuj saldo i wyślij powyższy fragment z id modelu z dokumentacji CheapTokens.