Tam model id'sini bulmak için GET /v1/models ile modelleri listeleyin

Kodunuz, başkasının örneğinde sorunsuz görünen bir model adı için 404 döndürüyor. API'nin kendisine sorun: https://api.cheaptokens.dev/v1/models adresine tek bir GET isteği, çağırabileceğiniz modelleri bağlam ve çıktı limitleriyle listeler. id'yi hafızanızdan değil, o yanıttan kopyalayın ve max_tokens değerini ayarlamadan önce limiti kontrol edin.

Doküman sayfası (CheapTokens docs, 28 Ekim 2026'da kontrol edildi) GET /v1/models'ü bağlam ve çıktı limitleriyle birlikte çağrılabilir modellerin listesi olarak tanımlar. Yanında tek bir model için GET /v1/models/{model} ve GET /v1/capabilities yer alır. Sohbetin kendisi POST /v1/chat/completions (OpenAI uyumlu) veya POST /v1/messages (Anthropic uyumlu) üzerinden gider.

Aynı modelin her yerde neden farklı bir id'si var#

Diyelim ki başka bir sağlayıcı için bir eğitim buldunuz. İçinde model: "deepseek-chat" kullanılıyor, siz de onu CheapTokens base URL'sinin yanına yapıştırıyorsunuz ve istek başarısız oluyor. Anahtarınızda bir sorun yok. Sağlayıcılar aynı modeli farklı adlandırır: deepseek-ai/ gibi bir önek, -0731 gibi bir sürüm soneki, farklı büyük/küçük harf kullanımı. API yalnızca listelediği tam dizeyi kabul eder ve fiyat etiketinden alınan kısa bir ad da işe yaramaz.

id'yi bir kez aramanızın tek nedeni bu. Yanlış bir id'nin ekranda nasıl göründüğünün tam hikayesini istiyorsanız, API 401 or 404 error: wrong key, base URL or model id bunu adım adım anlatır. Bu kılavuz ondan önceki adımdır: doğru id'yi bulun ki o hatayı hiç görmeyin.

API'ye sorun: tek istek#

Kullandığınız sekmeyi seçin. İkisi de aynı isteği gönderir. Her iki örnekte de anahtar CHEAPTOKENS_API_KEY ortam değişkeninden gelir (bakiyede para olduğunda anahtar dashboard içindedir).

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))

Python sürümü ham JSON'u bilerek yazdırır. Bir kez kendi gözlerinizle okuyun: model id'lerini ve yanlarında bağlam ile çıktı limitlerini arıyorsunuz. Her id'yi çıktıdan eksiksiz kopyalayın.

Üç id ve limitleri#

Dokümanlar bu çağrılabilir modelleri listeler (28 Ekim 2026'da kontrol edildi). Her satırın başındaki kod biçimlendirmesindeki dizeyi model olarak gönderin:

• zai-org/GLM-5.3-Flash — 390K bağlam, en fazla 8.192 çıktı token'ı.
• deepseek-ai/DeepSeek-V4-Flash-0731 — 380K bağlam, en fazla 32.768 çıktı token'ı.
• MiniMaxAI/MiniMax-M2.7 — 180K bağlam, en fazla 8.192 çıktı token'ı.

Çoğu karar için iki sayı önemlidir. Bağlam, modelin tek bir istekte tutabileceği miktardır; prompt'unuz ve yanıtı birlikte. Çıktı limiti, tek bir yanıtın en uzun halidir. Bu kelimeler yeni ise, how to read AI model names ve why an answer stops mid-sentence bunları sade bir dille açıklar.

Göreviniz için ilk modeli seçin#

Başlamak için uzun bir benchmark çalışmasına ihtiyacınız yok. İlk seçimlerin çoğunu iki soru belirler: girdiniz ne kadar büyük ve yanıt ne kadar uzun olmalı? Size en yakın duruma tıklayın.

Üçü de günün her saatinde tek bir bakiye ve tek bir fiyatı paylaşır, yoğun saat yoktur, bu yüzden sonradan geçiş yapmak size yalnızca değişen tek bir dizeye mal olur. OpenRouter ile karşılaştırıldığında, üçünün her biri girdi ve çıktı birlikte sayıldığında toplamda daha ucuzdur. Bir iş yükünün nasıl göründüğüne bir örnek: günde 1.000 kez 2.000 girdi token'ı gönderen ve 500 geri alan küçük bir asistan çalıştırdığınızı varsayalım. Aşağıdaki canlı tablo tam olarak bunu fiyatlandırır.

Her model için güncel token başına fiyatlar pricing page üzerindedir ve model pages her birine daha derinlemesine iner. Göreve göre yan yana bir karşılaştırma istiyorsanız, GLM vs DeepSeek vs MiniMax: which model to choose var.

max_tokens değerini limitten ayarlayın, sonra isteği gönderin#

Yaygın bir hata: limiti 8.192 olan bir modelden uzun bir rapor istersiniz ve yanıt yarıda kesilir. Listede gördüğünüz limit, max_tokens için üst sınırdır. Bu değerde veya altında kalın.

İşte listedeki tam id ile bir istek. İzin veren modelden uzun bir yanıt ister:

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
  }'

İlk çağrıda yeni misiniz? Your first API request with CheapTokens yanıt biçimini ve usage alanını kapsar.

Rutini oturtmak için adımları sıraya koyun:

İstek hâlâ başarısız oluyorsa#

Dizeyle başlayın. Tek karakter farklı bir model id'si 404'ün olağan nedenidir, bu yüzden yeniden yazmak yerine listeden tekrar yapıştırın. 402, bakiyenin tükendiği anlamına gelir ve hız limiti API anahtarı başına dakikada 120 istektir. Hatalar standart OpenAI/Anthropic JSON biçiminde döner, böylece SDK'lar bunları her zamanki gibi ayrıştırır. Tam anlatım için API 401 or 404 error sayfasına bakın.

API, https://api.cheaptokens.dev/v1 adresinde OpenAI ve Anthropic uyumludur; Anthropic SDK'ları ve Claude Code, /v1 olmadan kök URL https://api.cheaptokens.dev kullanır. Daha fazla kurulum ayrıntısı docs içinde yer alır.