Cara membaca nama model AI: alias vs versi yang dipin

Buka halaman API AI mana pun dan Anda akan menemukan nama seperti deepseek-flash, deepseek-v4-pro, atau DeepSeek-V4-Flash-0731. Nama-nama itu terlihat seperti label, tetapi string yang Anda masukkan ke field model menentukan model mana yang menjawab dan apa yang ditagihkan kepada Anda. Panduan ini menunjukkan cara membaca nama-nama tersebut, mengapa nama yang sama bisa berubah di bawah Anda, dan apa yang perlu diperiksa sebelum Anda menempelkan id ke dalam kode.

Anatomi nama model#

Ambil DeepSeek-V4-Flash-0731 dan pecah menjadi bagian-bagian:

Dua peringatan. Sufiks adalah konvensi, bukan hukum: 1017 cocok dengan tanggal rilis DeepSeek-V4.1-Flash-1017 (17 Oktober 2026), tetapi selalu konfirmasi di halaman model alih-alih menebak. Dan nama yang ditulis di halaman dokumentasi (DeepSeek-V4-Flash) tidak selalu merupakan string yang diterima API (deepseek-v4-flash-0731): nama tampilan untuk manusia, id untuk kode.

Flash dan Pro#

Pengembang biasanya merilis beberapa tingkat dari satu generasi. Flash biasanya tingkat yang lebih cepat dan ringan untuk pekerjaan bervolume tinggi: chat, ekstraksi, loop agen. Pro biasanya tingkat yang lebih besar untuk tugas yang lebih sulit. Kata-kata itu adalah pemasaran milik pengembang sendiri, jadi tidak dapat dibandingkan antar keluarga: Flash dari satu perusahaan tidak sama ukurannya dengan Flash dari perusahaan lain. Yang penting adalah deepseek-flash dan deepseek-v4-pro adalah dua nama model yang berbeda, jadi periksa tabel harga dari yang Anda gunakan. Jika Anda mengganti tingkat, periksa ulang tabel harga.

Alias vs versi yang dipin#

Ada dua jenis id, dan perbedaannya adalah hal terpenting dalam artikel ini.

• Alias — nama yang ditunjuk penyedia ke suatu model dan mungkin diarahkan ulang nanti. deepseek-flash adalah alias: per 22 Oktober 2026, dokumentasi DeepSeek menyatakan bahwa ia dilayani oleh DeepSeek-V4.1-Flash-1017, dan cara Anda memanggilnya tidak berubah. Besok string yang sama bisa mengarah ke build yang lebih baru.
• Versi yang dipin — id yang menyertakan build, seperti deepseek-v4-flash-0731. Ia menamai satu build tertentu, jadi jawaban yang Anda uji kemarin seharusnya berasal dari build yang sama hari ini.

Alias itu praktis: Anda mendapatkan peningkatan tanpa mengedit kode. Id yang dipin itu dapat diprediksi: bagus untuk pengujian, evaluasi, laporan, dan apa pun yang perubahan perilakunya akan mengejutkan Anda. Tidak ada yang "lebih baik"; pilih dengan sengaja.

Nama yang sama bisa berubah di bawah Anda#

Perubahan DeepSeek pada Oktober 2026 adalah contoh nyata. Menurut dokumentasi DeepSeek, yang diperiksa pada 22 Oktober 2026:

• deepseek-flash saat ini dilayani oleh DeepSeek-V4.1-Flash-1017;
• nama lama deepseek-v4-flash dan deepseek-v4-flash-vision-exp masih diterima, tetapi model tersebut sudah dihentikan, jadi permintaan diarahkan ke DeepSeek-V4.1-Flash-1017 dan ditagih dengan harga Flash;
• deepseek-v4-pro adalah nama model terpisah yang masih berlaku.

Jadi kode lama Anda mungkin tetap berjalan tetapi menjalankan model yang berbeda dari saat Anda menulisnya. Itu tidak masalah jika Anda menginginkan yang terbaru, dan jebakan jika Anda membandingkan hasil lintas minggu. Halaman dokumentasi tidak memiliki tanggal publikasi, jadi anggap pemetaan itu benar untuk tanggal di atas dan baca ulang saat penting. Apa yang berubah pada model itu sendiri dibahas di DeepSeek-V4.1-Flash-1017 is out.

Apa yang perlu diperiksa sebelum memasukkan id ke dalam kode#

1. Salin id dari dokumentasi penyedia yang benar-benar Anda panggil. Penyedia berbeda menamai keluarga yang sama secara berbeda, jadi ambil id dari dokumentasi CheapTokens saat Anda memanggil CheapTokens, dan dari dokumentasi DeepSeek saat Anda memanggil DeepSeek. Jangan campur.
2. Putuskan: alias atau dipin? Jika string tidak memiliki tanggal atau sufiks build, anggap ia bisa berpindah.
3. Periksa base URL dan gaya API. CheapTokens berbicara dalam format OpenAI Chat Completions dan Anthropic Messages di https://api.cheaptokens.dev/v1; API DeepSeek sendiri menggunakan https://api.deepseek.com (gaya OpenAI) dan https://api.deepseek.com/anthropic (gaya Anthropic). Id yang benar pada base URL yang salah adalah kesalahan.
4. Buka tabel harga untuk id tersebut secara tepat dan catat tanggalnya. Harga milik model, bukan milik keluarga.
5. Simpan id di satu tempat (file konfigurasi atau variabel lingkungan) alih-alih tersebar di seluruh kode.
6. Catat model yang menjawab. Respons bergaya OpenAI membawa field model; simpan di samping hasil Anda.

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)

Dua baris yang dicetak adalah kebiasaan yang layak dibangun: apa yang Anda minta dan apa yang menjawab. Jangan pernah hard-code kuncinya; lihat What is an API key and how to store it safely. Jika ini panggilan pertama Anda, mulailah dengan Your first API request with CheapTokens.

Bandingkan harga dan hasil antar versi#

Sebagian besar kebingungan berasal dari membandingkan hal yang salah. Sebelum membandingkan dua harga atau dua jawaban, catat untuk kedua sisi: id persis, penyedia, dan tanggal. Dua id yang sama-sama bertuliskan "Flash" tetapi membawa generasi atau sufiks build yang berbeda adalah model berbeda dengan tanggal rilis berbeda. Hal yang sama berlaku untuk benchmark dari postingan berita: itu milik build yang disebutkan dalam postingan dan bukan janji tentang id lain mana pun.

Berlaku juga sebaliknya. Saat Anda menguji model dengan prompt Anda sendiri, pertahankan set prompt tetap dan ubah satu hal pada satu waktu: id, atau prompt, jangan keduanya. Menghitung token untuk perbandingan? What is a token menjelaskan bagaimana angka-angka itu diukur.

Contoh id untuk latihan#

CheapTokens menyimpan satu saldo untuk semua model, jadi Anda dapat mengganti id dengan kunci yang sama:

• MiniMax-M2.7 (minimax-m2.7, id gateway MiniMaxAI/MiniMax-M2.7): konteks 180K, hingga 8.192 token keluaran, satu harga di jam berapa pun. Input $0.05 dan output $0.15 per 1M token, keduanya di bawah referensi OpenRouter.

Tabel di bawah ini menghitung ulang secara langsung untuk pekerjaan kecil 100.000 token input dan 20.000 token output, dengan kolom OpenRouter sebagai referensi:

Perhatikan bahwa setiap baris adalah satu id tertentu. Jika Anda menukar minimax-m2.7 dengan id lain, Anda mengubah model sekaligus harganya.

Ringkasan singkat#

• String model menentukan model mana yang menjawab dan berapa biayanya.
• Id tanpa sufiks build kemungkinan adalah alias dan mungkin diarahkan ulang; id dengan build bersifat dipin.
• Nama lama bisa tetap berjalan sambil diam-diam menjalankan model yang lebih baru, seperti deepseek-v4-flash dalam dokumentasi DeepSeek pada 22 Oktober 2026.
• Flash dan Pro adalah tingkat di dalam satu keluarga, bukan ukuran universal.
• Selalu salin id dari dokumentasi penyedia yang Anda panggil, dan catat model mana yang menjawab.

Siap mencobanya? Dapatkan kunci, isi saldo, dan kirim cuplikan di atas dengan id model dari dokumentasi CheapTokens.