Paano basahin ang mga pangalan ng AI model: alias vs naka-pin na bersyon

Buksan ang anumang pahina ng AI API at makikita mo ang mga pangalang tulad ng deepseek-flash, deepseek-v4-pro o DeepSeek-V4-Flash-0731. Mukha silang mga label, ngunit ang string na inilalagay mo sa model field ang nagpapasya kung aling modelo ang sasagot at kung magkano ang sisingilin sa iyo. Ipinapakita ng gabay na ito kung paano basahin ang mga pangalang ito, bakit ang parehong pangalan ay maaaring magbago sa ilalim mo, at ano ang dapat suriin bago mo i-paste ang isang id sa code.

Anatomiya ng pangalan ng modelo#

Kunin ang DeepSeek-V4-Flash-0731 at hatiin ito sa mga bahagi:

Dalawang paalala. Ang suffix ay isang kombensiyon, hindi batas: ang 1017 ay tumutugma sa petsa ng paglabas ng DeepSeek-V4.1-Flash-1017 (17 Oktubre 2026), ngunit palaging kumpirmahin ito sa pahina ng modelo sa halip na hulaan. At ang pangalang nakasulat sa isang pahina ng docs (DeepSeek-V4-Flash) ay hindi laging ang string na tinatanggap ng API (deepseek-v4-flash-0731): ang display name ay para sa mga tao, ang id ay para sa code.

Flash at Pro#

Karaniwang naglalabas ang mga developer ng ilang tier ng isang henerasyon. Ang Flash ay karaniwang ang mas mabilis, mas magaan na tier para sa high-volume na trabaho: chat, extraction, agent loops. Ang Pro ay karaniwang ang mas malaking tier para sa mas mahirap na gawain. Ang mga salita ay marketing ng developer mismo, kaya hindi sila maihahambing sa pagitan ng mga pamilya: ang Flash mula sa isang kumpanya ay hindi kapareho ng laki ng Flash mula sa iba. Ang mahalaga ay ang deepseek-flash at deepseek-v4-pro ay dalawang magkaibang pangalan ng modelo, kaya suriin ang price table ng alinman sa gagamitin mo. Kung magpapalit ka ng tier, suriin muli ang price table.

Alias vs naka-pin na bersyon#

May dalawang uri ng id, at ang pagkakaiba ang pinakamahalagang bagay sa artikulong ito.

• Alias — isang pangalan na itinuturo ng provider sa ilang modelo at maaaring muling ituro sa ibang pagkakataon. Ang deepseek-flash ay isang alias: noong 22 Oktubre 2026, sinasabi ng docs ng DeepSeek na ito ay ine-serve ng DeepSeek-V4.1-Flash-1017, at ang paraan ng pagtawag mo dito ay hindi nagbago. Bukas, ang parehong string ay maaaring tumuro sa mas bagong build.
• Naka-pin na bersyon — isang id na may kasamang build, tulad ng deepseek-v4-flash-0731. Pinangalanan nito ang isang partikular na build, kaya ang mga sagot na sinubukan mo kahapon ay dapat magmula sa parehong build ngayon.

Ang alias ay maginhawa: nakakakuha ka ng mga pagpapabuti nang hindi binabago ang code. Ang naka-pin na id ay predictable: mabuti para sa mga test, evaluation, report at anumang bagay kung saan ang pagbabago ng pag-uugali ay magugulat sa iyo. Walang "mas mabuti"; pumili nang sinasadya.

Ang parehong pangalan ay maaaring magbago sa ilalim mo#

Ang pagbabago ng DeepSeek mula Oktubre 2026 ay isang live na halimbawa. Ayon sa docs ng DeepSeek, na sinuri noong 22 Oktubre 2026:

• Ang deepseek-flash ay kasalukuyang ine-serve ng DeepSeek-V4.1-Flash-1017;
• Ang mga lumang pangalang deepseek-v4-flash at deepseek-v4-flash-vision-exp ay tinatanggap pa rin, ngunit ang mga modelong iyon ay retired na, kaya ang mga request ay napupunta sa DeepSeek-V4.1-Flash-1017 at sinisingil sa presyo ng Flash;
• Ang deepseek-v4-pro ay isang hiwalay, kasalukuyang pangalan ng modelo.

Kaya ang lumang code mo ay maaaring patuloy na gumana at tumakbo pa rin sa ibang modelo kaysa noong isinulat mo ito. Iyon ay ayos lang kung gusto mo ang pinakabago, at isang bitag kung inihambing mo ang mga resulta sa pagitan ng mga linggo. Ang pahina ng docs ay walang petsa ng publikasyon, kaya ituring na totoo ang mapping para sa petsa sa itaas at muling basahin ito kapag mahalaga. Ang nabago sa modelo mismo ay saklaw sa DeepSeek-V4.1-Flash-1017 is out.

Ano ang dapat suriin bago mo ilagay ang isang id sa code#

1. Kopyahin ang id mula sa docs ng provider na aktwal na tinatawagan mo. Iba-iba ang pangalan ng parehong pamilya sa iba't ibang provider, kaya kunin ang id mula sa docs ng CheapTokens kapag tumatawag ka sa CheapTokens, at mula sa docs ng DeepSeek kapag tumatawag ka sa DeepSeek. Huwag paghalo-haluin ang mga ito.
2. Magpasya: alias o naka-pin? Kung ang string ay walang petsa o build suffix, ipagpalagay na maaari itong gumalaw.
3. Suriin ang base URL at API style. Ang CheapTokens ay nagsasalita ng OpenAI Chat Completions at Anthropic Messages na format sa https://api.cheaptokens.dev/v1; ang sariling API ng DeepSeek ay gumagamit ng https://api.deepseek.com (OpenAI-style) at https://api.deepseek.com/anthropic (Anthropic-style). Ang tamang id sa maling base URL ay isang error.
4. Buksan ang price table para sa eksaktong id na iyon at tandaan ang petsa. Ang mga presyo ay nabibilang sa isang modelo, hindi sa isang pamilya.
5. Itago ang id sa isang lugar (isang config file o environment variable) sa halip na nakakalat sa code.
6. I-log ang modelong sumagot. Ang mga OpenAI-style na tugon ay may model field; i-save ito kasama ng iyong mga resulta.

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)

Ang dalawang nakalimbag na linya ay ang ugali na dapat buuin: ang hiniling mo at ang sumagot. Huwag kailanman i-hard-code ang key; tingnan ang What is an API key and how to store it safely. Kung ito ang iyong unang tawag, magsimula sa Your first API request with CheapTokens.

Ihambing ang mga presyo at resulta bersyon sa bersyon#

Karamihan ng kalituhan ay nagmumula sa paghahambing ng maling bagay. Bago mo ihambing ang dalawang presyo o dalawang sagot, isulat para sa magkabilang panig: ang eksaktong id, ang provider, at ang petsa. Dalawang id na parehong nagsasabing "Flash" ngunit may magkaibang henerasyon o build suffix ay magkaibang modelo na may magkaibang petsa ng paglabas. Ganoon din sa mga benchmark mula sa isang news post: nabibilang sila sa build na pinangalanan sa post at hindi sila pangako tungkol sa anumang ibang id.

Gumagana rin ito sa kabilang paraan. Kapag sinusubukan mo ang isang modelo sa sarili mong mga prompt, panatilihing fixed ang prompt set at baguhin ang isang bagay sa isang pagkakataon: ang id, o ang prompt, hindi pareho. Nagbibilang ng token para sa paghahambing? Ipinaliwanag ng What is a token kung paano sinusukat ang mga numero.

Mga halimbawang id na pwedeng pagpraktisan#

Ang CheapTokens ay may isang balanse para sa lahat ng modelo, kaya maaari kang magpalit ng id gamit ang parehong key:

• MiniMax-M2.7 (minimax-m2.7, gateway id MiniMaxAI/MiniMax-M2.7): 180K context, hanggang 8,192 output tokens, isang presyo sa anumang oras. Input $0.05 at output $0.15 bawat 1M tokens, parehong mas mababa sa reference ng OpenRouter.

Ang talahanayan sa ibaba ay muling nagkalkula nang live para sa isang maliit na trabaho na 100,000 input at 20,000 output tokens, na may column ng OpenRouter para sa reference:

Tandaan na ang bawat row ay isang partikular na id. Kung papalitan mo ang minimax-m2.7 ng ibang id, binabago mo ang parehong modelo at presyo.

Mabilis na recap#

• Ang model string ang nagpapasya kung aling modelo ang sasagot at magkano ito.
• Ang id na walang build suffix ay malamang alias at maaaring muling ituro; ang id na may build ay naka-pin.
• Ang mga lumang pangalan ay maaaring patuloy na gumana habang tahimik na tumatakbo ang mas bagong modelo, tulad ng deepseek-v4-flash sa docs ng DeepSeek noong 22 Oktubre 2026.
• Ang Flash at Pro ay mga tier sa loob ng isang pamilya, hindi unibersal na laki.
• Palaging kopyahin ang id mula sa docs ng provider na tinatawagan mo, at i-log kung aling modelo ang sumagot.

Handa nang subukan? Kumuha ng key, mag-top up ng balanse at ipadala ang snippet sa itaas na may model id mula sa docs ng CheapTokens.