Wylistuj modele za pomocą GET /v1/models, aby znaleźć dokładne id modelu

Twój kod zwraca 404 dla nazwy modelu, która wyglądała dobrze w przykładzie kogoś innego. Zapytaj samo API: jedno żądanie GET do https://api.cheaptokens.dev/v1/models zwraca listę modeli, które możesz wywołać, wraz z ich limitami kontekstu i wyjścia. Skopiuj id z tej odpowiedzi, a nie z pamięci, i sprawdź limit, zanim ustawisz max_tokens.

Strona dokumentacji (dokumentacja CheapTokens, sprawdzona 28 października 2026) opisuje GET /v1/models jako listę wywoływalnych modeli z limitami kontekstu i wyjścia. Obok niej znajdują się GET /v1/models/{model} dla jednego modelu oraz GET /v1/capabilities. Sam czat przechodzi przez POST /v1/chat/completions (zgodny z OpenAI) lub POST /v1/messages (zgodny z Anthropic).

Dlaczego ten sam model ma wszędzie inne id#

Załóżmy, że znalazłeś poradnik dla innego dostawcy. Używa on model: "deepseek-chat", wklejasz to obok bazowego URL-a CheapTokens i żądanie kończy się niepowodzeniem. Z twoim kluczem nie ma nic nie tak. Dostawcy nazywają ten sam model różnie: prefiks taki jak deepseek-ai/, sufiks wersji taki jak -0731, inna wielkość liter. API akceptuje tylko dokładny ciąg, który wymienia, a krótka nazwa wzięta z etykiety ceny też nie zadziała.

Właśnie dlatego warto raz sprawdzić id. Jeśli chcesz poznać całą historię tego, jak błędne id wygląda na ekranie, błąd API 401 lub 404: zły klucz, bazowy URL lub id modelu przeprowadza przez to. Ten poradnik to krok wcześniej: znajdź właściwe id, żeby nigdy nie zobaczyć tego błędu.

Zapytaj API: jedno żądanie#

Wybierz kartę, której używasz. Obie wysyłają to samo żądanie. W obu przykładach klucz pochodzi ze zmiennej środowiskowej CHEAPTOKENS_API_KEY (klucz jest w panelu, gdy na saldzie są środki).

export CHEAPTOKENS_API_KEY="sk-your-key"

curl https://api.cheaptokens.dev/v1/models \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY"

import json
import os

import requests

resp = requests.get(
    "https://api.cheaptokens.dev/v1/models",
    headers={"Authorization": f"Bearer {os.environ['CHEAPTOKENS_API_KEY']}"},
    timeout=30,
)
resp.raise_for_status()
print(json.dumps(resp.json(), indent=2))

Wersja w Pythonie celowo wypisuje surowy JSON. Przeczytaj go raz własnymi oczami: szukasz identyfikatorów modeli, a obok nich limitów kontekstu i wyjścia. Skopiuj każdy identyfikator z wydruku w całości.

Trzy identyfikatory i ich limity#

Dokumentacja wymienia te wywoływalne modele (sprawdzone 28 października 2026). Wyślij ciąg w formacie kodu na początku każdej linii jako model:

• zai-org/GLM-5.3-Flash — kontekst 390K, do 8 192 tokenów wyjścia.
• deepseek-ai/DeepSeek-V4-Flash-0731 — kontekst 380K, do 32 768 tokenów wyjścia.
• MiniMaxAI/MiniMax-M2.7 — kontekst 180K, do 8 192 tokenów wyjścia.

Dwie liczby mają znaczenie przy większości decyzji. Kontekst to ilość, którą model może pomieścić w jednym żądaniu, razem z twoim promptem i jego odpowiedzią. Limit wyjścia to najdłuższa pojedyncza odpowiedź. Jeśli te słowa są nowe, jak czytać nazwy modeli AI i dlaczego odpowiedź urywa się w połowie zdania wyjaśniają je prostym językiem.

Wybierz pierwszy model do swojego zadania#

Nie potrzebujesz długiego badania benchmarków, żeby zacząć. Dwa pytania rozstrzygają większość pierwszych wyborów: jak duże jest twoje wejście i jak długa musi być odpowiedź? Kliknij przypadek najbliższy twojemu.

Wszystkie trzy dzielą jedno saldo i jedną cenę o każdej porze dnia, bez godzin szczytu, więc późniejsza zmiana kosztuje cię tylko jeden zmieniony ciąg. W porównaniu z OpenRouter każdy z trzech jest tańszy łącznie, licząc wejście i wyjście razem. Oto jak wygląda obciążenie: powiedzmy, że uruchamiasz małego asystenta, który wysyła 2 000 tokenów wejścia i dostaje 500 z powrotem, 1 000 razy dziennie. Poniższa tabela na żywo wycenia dokładnie to.

Aktualne ceny za token dla każdego modelu są na stronie cen, a strony modeli omawiają każdy z nich głębiej. Jeśli chcesz porównania według zadania, jest GLM vs DeepSeek vs MiniMax: który model wybrać.

Ustaw max_tokens na podstawie limitu, potem wyślij żądanie#

Częsta pomyłka: prosisz o długi raport od modelu, którego limit to 8 192, i odpowiedź urywa się w połowie. Limit, który widziałeś na liście, to pułap dla max_tokens. Trzymaj się na nim lub poniżej.

Oto żądanie z pełnym id z listy. Prosi o długą odpowiedź od modelu, który na to pozwala:

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "messages": [{"role": "user", "content": "Write a 1,500-word guide to API keys."}],
    "max_tokens": 4000
  }'

Nowy w pierwszym wywołaniu? Twoje pierwsze żądanie API z CheapTokens omawia format odpowiedzi i pole usage.

Aby utrwalić rutynę, ułóż kroki w kolejności:

Jeśli żądanie nadal kończy się niepowodzeniem#

Zacznij od ciągu. Id modelu różniące się o jeden znak to zwykła przyczyna 404, więc wklej je ponownie z listy, zamiast wpisywać od nowa. 402 oznacza wyczerpane saldo, a limit szybkości to 120 żądań na minutę na klucz API. Błędy wracają w standardowym kształcie JSON OpenAI/Anthropic, więc SDK parsują je jak zwykle. Pełny przewodnik znajdziesz w błąd API 401 lub 404.

API jest zgodne z OpenAI i Anthropic pod https://api.cheaptokens.dev/v1; SDK Anthropic i Claude Code używają głównego URL-a https://api.cheaptokens.dev bez /v1. Więcej szczegółów konfiguracji jest w dokumentacji.