Token milioni 1 kwenye Claude hugharimu kiasi gani?

Token 1M ni kiasi gani kwenye Claude?

Token 1M inamaanisha token milioni moja. Hiki ndicho kipimo kinachotumiwa kutaja bei za modeli za Claude API (application programming interface). Hakuna bei moja ya kipimo hiki, kwa sababu token za ingizo na token za towe hutozwa kwa viwango tofauti, na kila modeli ina viwango vyake viwili. Claude Haiku 5.5 ina jozi mbili za viwango: jozi moja kwa prompt zenye hadi token 100,000, na jozi ya juu zaidi kwa prompt zenye zaidi ya hapo. Kufikia Oktoba 2026, token milioni moja za ingizo hugharimu $1 kwenye Claude Haiku 4.5, $2 kwenye Claude Sonnet 5, na $5 kwenye Claude Opus 5.

Towe ndilo sehemu ghali zaidi. Kwenye kila modeli ya sasa, kiwango cha towe ni mara tano ya kiwango cha ingizo. Kwa hiyo, mgawanyo kati ya viwili hivyo huamua bili yako zaidi kuliko bei kuu iliyoonyeshwa. App inayotuma nyaraka ndefu na kurudisha majibu mafupi hutofautiana sana na app inayoandika majibu marefu kutoka kwenye prompt fupi.

Ukurasa huu unaeleza uchumi wa vitengo: token inagharimu kiasi gani, na jinsi ya kukadiria bili kabla ya kuunda programu. Ili kujua token huenda wapi unapofanya kazi, soma token huenda wapi ndani ya session ya Claude Code.

Muonekano wa token 1M

Token ni kipande cha maandishi ambacho modeli husoma au kuandika. Kamusi ya Anthropic inaeleza kuwa token moja ni takriban herufi 3.5 za Kiingereza kwenye modeli za kabla ya Claude 4.7. Muhtasari wa modeli za Anthropic unasema kuwa token milioni moja hushikilia takriban maneno 750,000 kwenye modeli hizo, na kwa herufi 3.5 kwa kila token, hiyo ni takriban herufi milioni 3.5, au takriban 3.5 MB ya maandishi ya kawaida ya Kiingereza. Kwenye tokenizer mpya iliyoanzishwa na Claude Opus 4.7, token milioni moja hiyo hiyo hushikilia takriban maneno 555,000, au takriban herufi milioni 2.5.

Makadirio yaliyochapishwa kwa maingizo ya kawaida yanatoa picha bora ya ukubwa huu.

[
  {
    "label": "Average web page (10 kB)",
    "tokens": "2,500"
  },
  {
    "label": "Documentation page (100 kB)",
    "tokens": "25,000"
  },
  {
    "label": "Research paper PDF (500 kB)",
    "tokens": "125,000"
  }
]

Kwa viwango hivyo, token 1M ni takriban kurasa 400 za wavuti zilizosomwa mara moja, au karatasi nane za utafiti za ukubwa huo. Ni mzunguko mmoja wa kusoma codebase ya ukubwa wa wastani, au mwezi mmoja wa matumizi madogo ya gumzo kwa mtu mmoja.

Chukulia hayo yote kama makadirio. Nambari za programu (code), JSON, na maandishi katika lugha nyingine isipokuwa Kiingereza huweka maneno machache zaidi ndani ya token moja, kwa hivyo idadi hiyo ya maneno ni makadirio ya juu zaidi. Jambo lingine hubadilisha hesabu hiyo: Claude Opus 4.7 na matoleo yanayofuata, ambayo yanajumuisha Opus 5 na Sonnet 5, yanatumia tokenizer mpya inayozalisha takriban asilimia 30 ya token nyingi zaidi kwa maandishi yale yale ikilinganishwa na Sonnet 4.6 na matoleo ya awali. Claude Haiku 4.5 inatumia tokenizer ya zamani. Kwa hivyo, hesabu uliyopima kwenye Haiku 4.5 itakuwa ndogo kuliko hesabu kwenye Sonnet 5 kwa ingizo linalofanana, jambo ambalo linamaanisha kuwa kulinganisha bei kwa milioni moja moja kwa moja kuvuka mpaka huo si sahihi. Hesabu prompt ile ile kwenye modeli zote mbili kabla ya kufanya uamuzi.

Claude hutoza kiasi gani kwa kila token milioni

[
  {
    "label": "Haiku 4.5",
    "input_usd": 1,
    "output_usd": 5
  },
  {
    "label": "Sonnet 5",
    "input_usd": 2,
    "output_usd": 10
  },
  {
    "label": "Sonnet 4.6",
    "input_usd": 3,
    "output_usd": 15
  },
  {
    "label": "Opus 5",
    "input_usd": 5,
    "output_usd": 25
  }
]

Claude Sonnet 5 hugharimu $2 kwa input na $10 kwa output. Anthropic iliuza bei hiyo kwanza kama kiwango cha utangulizi hadi 31 August 2026, kisha ikaifanya kuwa bei ya kawaida na kufuta ongezeko lililopangwa hadi $3 na $15. Claude Opus 5 hugharimu $5 kwa input na $25 kwa output. Miundo ya Fable iko juu zaidi ya jedwali hilo: Claude Fable 5 na Claude Fable 5.1 mpya zaidi zote zimeorodheshwa kwa $10 kwa input na $50 kwa output, kwa hiyo kama viwango hivyo vinafaa kulipiwa inategemea kazi utakazoipa.

Mfululizo wa sasa wa Anthropic ni mpya zaidi kuliko miundo ambayo bei zake zimehesabiwa kwenye ukurasa huu. Claude Opus 5.5 imeorodheshwa kwa $4 kwa input na $20 kwa output, Claude Sonnet 5.5 kwa $2 na $10, na Claude Haiku 5.5 kuanzia $0.10 na $0.50. Opus 5, Sonnet 5, Haiku 4.5 na Fable 5 sasa zimeorodheshwa kama miundo ya zamani ambayo bado inapatikana, kwa hiyo mifano ya hesabu iliyo hapa chini bado inaendeshwa kama ilivyoandikwa. Claude Haiku 5.5 hugharimu kiasi gani na inafaa wapi inaeleza kuhusu miundo mipya iliyo nafuu zaidi.

Viwango hubadilika. Chukulia kila takwimu kwenye ukurasa huu kama mfano wa hesabu wa October 2026, na uthibitishe nambari za sasa kwenye ukurasa rasmi wa bei kabla ya kuidhinisha bajeti.

Viwango hivi vinaonyesha gharama ya Claude, lakini si kama ndiyo chaguo la bei nafuu zaidi kwa mzigo wako wa kazi, na kazi tatu zilizohesabiwa kwa Claude na ChatGPT zinaonyesha ni API ipi inakuwa nafuu katika kila hali.

Jambo moja lisilobadilisha kiwango ni urefu wa context, isipokuwa katika hali moja. Kwenye miundo ya Claude 4.6 na ya baadaye, isipokuwa Claude Haiku 5.5, context window kamili ya token 1M hutozwa kwa bei ya kawaida, kwa hiyo ombi la token 900,000 hugharimu kiasi kilekile kwa kila token kama ombi la token 9,000. Prompt ndefu hugharimu zaidi kwa sababu ina token nyingi zaidi, na hakuna kiwango tofauti cha long-context. Claude Haiku 5.5 huwekewa bei kulingana na urefu wa prompt badala yake: ombi ambalo prompt yake ina zaidi ya token 100,000 hutozwa $0.50 kwa input na $2.50 kwa output kwa kila milioni, badala ya $0.10 na $0.50, na usomaji na uandishi wa cache huhesabiwa katika kizingiti hicho.

Hesabu inayosalia sahihi baada ya mabadiliko ya bei

Kila bili ina kuzidisha mara mbili na kujumlisha mara moja.

cost = (input_tokens  / 1,000,000) * input_rate
     + (output_tokens / 1,000,000) * output_rate

Imeandikwa kama msimbo unaoweza kuendesha:

INPUT_RATE = 2.00    # USD per million input tokens, Sonnet 5, October 2026
OUTPUT_RATE = 10.00  # USD per million output tokens

def cost(input_tokens, output_tokens):
    return (input_tokens * INPUT_RATE + output_tokens * OUTPUT_RATE) / 1_000_000

print(f"{cost(4300, 400):.4f}")

Hiyo huchapisha 0.0126. Ombi linalotuma tokeni 4,300 za ingizo na kupokea tokeni 400 za matokeo hugharimu takriban senti 1.3 kwenye Sonnet 5. Weka viwango hivyo viwili mahali pamoja kwenye msimbo wako. Bei ikibadilika, unahariri mistari miwili, na kila makadirio kwenye mfumo wako hubadilika nayo.

Makadirio yaliyofanyiwa kazi kwa programu halisi

Chukua msaidizi wa usaidizi (support assistant). Prompt yake ya mfumo na nyaraka za bidhaa hufikia token 4,000, na hutumwa katika kila ombi, kwa sababu Messages API haina hali (stateless) na modeli haikumbuki chochote kati ya wito mmoja na mwingine. Swali la mtumiaji huongeza takriban token 300. Jibu huchukua takriban 400. Hiyo ni token 4,300 za kuingiza na 400 za kutoa kwa kila ombi.

Token milioni moja za kuingiza hununua takriban maombi 232 ya umbo hilo. Kwa maombi 1,000 kwa siku, programu hutumia token milioni 4.3 za kuingiza kila siku, kwa hivyo "token 1M" ni chini ya saa sita za trafiki.

[
  {
    "label": "Opus 5, list rates",
    "cost_per_1k_usd": "31.50"
  },
  {
    "label": "Sonnet 5, list rates",
    "cost_per_1k_usd": "12.60"
  },
  {
    "label": "Sonnet 5, Batch API",
    "cost_per_1k_usd": "6.30"
  },
  {
    "label": "Haiku 4.5, list rates",
    "cost_per_1k_usd": "6.30"
  },
  {
    "label": "Sonnet 5, warm prompt cache",
    "cost_per_1k_usd": "5.40"
  }
]

Kwenye Claude Opus 5 trafiki hiyo hugharimu $31.50 kwa kila maombi 1,000. Kwenye Sonnet 5 ni $12.60. Kushuka hadi Claude Haiku 4.5 huileta hadi $6.30, na cache ya prompt yenye joto kwenye Sonnet 5 hushuka zaidi hadi $5.40.

Zidisha kwa 30 kwa mwezi wa trafiki hiyo. Sonnet 5 kwa viwango vya orodha ni takriban $378 kwa mwezi. Programu hiyo hiyo yenye cache yenye joto ni takriban $162. Chaguo lako la modeli na uamuzi wako wa kuweka cache kila moja ina thamani zaidi kuliko kiwango chochote utakachojadiliana kwa kiasi hiki. Ni modeli ipi ya kuendesha ni swali lake lenyewe, na ile ya bei nafuu zaidi inayopita tathmini zako ndiyo inayoshinda: kuchagua kati ya Opus, Sonnet na Haiku inashughulikia jinsi ya kupima hilo ipasavyo.

Prompt caching inapunguza sehemu inayojirudia

Ile prefix ya token 4,000 inafanana kwenye kila ombi, na unalipia bei kamili ya ingizo kila wakati. Prompt caching huhifadhi prefix iliyochakatwa na kutoza kiwango kilichopunguzwa ili kuitumia tena.

Kwenye modeli zilizopo kwenye chati ya bei ya ukurasa huu na mifano iliyofanyiwa kazi (Haiku 4.5, Sonnet 5, Sonnet 4.6 na Opus 5), na kwenye Fable 5, usomaji wa cache hugharimu mara 0.1 ya kiwango cha msingi cha ingizo. Modeli nyingine mpya hutoza kidogo zaidi kwa usomaji: Opus 5.5 na Sonnet 5.5 hutoza mara 0.05, na Fable 5.1 na Mythos 5.1 hutoza mara 0.025. Kuandika kwenye cache hugharimu mara 1.25 ya bei ya msingi kwa muda wa maisha wa dakika 5, au mara 2 ya bei ya msingi kwa muda wa maisha wa saa 1. Kwa hivyo kwenye modeli za mara 0.1, cache ya dakika 5 hujilipia yenyewe baada ya usomaji mmoja, kwa sababu uandikaji hugharimu ziada ya 0.25 wakati kila usomaji huokoa 0.9. Cache ya saa 1 inahitaji usomaji miwili ili kufikia usawa wa gharama.

Njia rahisi zaidi ya kuiwasha ni kupitia sehemu moja ya ngazi ya juu:

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-opus-5",
    "max_tokens": 1024,
    "cache_control": {"type": "ephemeral"},
    "system": "You are a helpful assistant.",
    "messages": [
      {"role": "user", "content": "What are the key themes in Pride and Prejudice?"}
    ]
  }'

Kisha soma block ya usage inayorejeshwa:

{
  "usage": {
    "cache_creation_input_tokens": 5120,
    "cache_read_input_tokens": 1800,
    "input_tokens": 50,
    "output_tokens": 503
  }
}

Vipingio vitatu hivyo vya ingizo hutozwa kwa viwango vitatu tofauti na jumla yake ndiyo ujazo wako halisi wa ingizo: total_input_tokens = cache_read_input_tokens + cache_creation_input_tokens + input_tokens. Makadirio ya gharama yanayosoma input_tokens pekee yatakuwa na makosa makubwa mara tu caching itakapowashwa.

Mambo mawili huzuia cache isilete faida, na yote mawili hushindwa kimyakimya.

Prefix lazima ifanane kwa byte. Utafutaji wa cache ni ulinganishaji wa prefix, kwa hivyo timestamp au jina la mtumiaji juu ya system prompt yako huibadilisha kwenye kila ombi. Kisha unalipa mara 1.25 ya ingizo la msingi kila wakati na hutasoma hata mara moja. Dalili yake ni cache_creation_input_tokens kubaki juu wakati cache_read_input_tokens inabaki 0. Weka cache_control kwenye block ya mwisho ambayo maudhui yake yanafanana kwenye maombi yote, na weka kila kitu kinachobadilika baada yake. Kubadilisha ufafanuzi wako wa tools hufuta cache nzima iliyo chini yake, kwa sababu ufutaji hufuata mpangilio wa tools, kisha system, kisha messages.

Prefix lazima iwe ndefu vya kutosha. Urefu wa chini kabisa unaoweza kuhifadhiwa kwenye cache ni token 512 kwenye Opus 5, 1,024 kwenye Sonnet 5 na 4,096 kwenye Haiku 4.5. Prompt fupi zaidi haihifadhiwi kwenye cache na hakuna kosa linalorejeshwa. Ile prefix ya token 4,000 katika mfano hapo juu inahifadhiwa kwenye Sonnet 5 na haihifadhiwi kwenye Haiku 4.5, kwa sababu 4,000 iko chini ya kiwango cha chini cha modeli hiyo. Wakati vipingio vyote viwili vinasoma 0, hakuna kilichohifadhiwa kwenye cache.

Uchakataji wa bechi hupunguza gharama kwa nusu

Batch API huchakata maombi kwa njia ya asynchronous kwa punguzo la asilimia 50 kwenye gharama za input na output. Katika mfano hapo juu, hii inabadilisha $12.60 kwa kila maombi 1,000 kuwa $6.30. Punguzo hili huongezeka pamoja na prompt caching, hivyo kazi ya bechi iliyohifadhiwa kwenye cache ndiyo njia ya bei nafuu zaidi ya kufanya kazi kwa wingi.

Unachopoteza ni latency, jambo linalofanya bechi kutofaa kwa chochote ambacho mtumiaji anasubiri kukamilika. Inafaa zaidi kwa uainishaji wa usiku kucha na usasishaji wa nyaraka za nyuma (backfills).

Kwa nini gharama za gumzo huongezeka ndani ya mazungumzo moja

Kwa sababu API haina hali (stateless), mteja wako hutuma tena mazungumzo yote katika kila hatua. Matumizi ya tokeni ndani ya gumzo moja kwa hivyo hukua kwa mraba wa urefu wake, si kwa mstari ulionyooka.

Chukua hatua zenye wastani wa tokeni 500. Hatua ya 1 hutuma tokeni 500 za kuingiza. Hatua ya 2 hutuma 1,000. Hatua ya 20 hutuma 10,000. Jumlisha hiyo kwa n(n+1)/2 na mazungumzo ya hatua 20 yatakuwa yametuma takriban tokeni 105,000 za kuingiza, wakati nakala ya mazungumzo yenyewe ina urefu wa tokeni 10,000 pekee.

Hiyo ndiyo sababu kipengele cha gumzo hugharimu zaidi ya inavyoonekana kwenye nakala yake, na kwa nini kuhifadhi (caching) kiambishi awali kisichobadilika au kufupisha hatua za awali hulipa gharama zake kwenye nyuzi ndefu za mazungumzo. Wakala anayezunguka kwenye miito ya zana (tool calls) ana umbo sawa, na mbaya zaidi: kila matokeo ya zana hubaki kwenye historia na hutumwa tena katika kila hatua inayofuata. Kuweka kikomo kikali cha matumizi kwa wakala unayejiendeshea mwenyewe ni muhimu zaidi hapa, kwa sababu ukuaji huo ni wa kiotomatiki na hakuna anayeufuatilia.

Hesabu token kabla ya kukisia

Acha kukadiria idadi ya token kwa kuhesabu maneno. API inakuhesabia bila malipo, kwa kutumia kikomo cha viwango kilicho tofauti na uundaji wa ujumbe.

curl https://api.anthropic.com/v1/messages/count_tokens \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-opus-5",
    "system": "You are a scientist",
    "messages": [{
      "role": "user",
      "content": "Hello, Claude"
    }]
  }'

Jibu lina field moja:

{ "input_tokens": 14 }

Ipe system prompt na ufafanuzi wa zana zako halisi, pamoja na ujumbe wa mtumiaji unaowakilisha matumizi, kisha weka nambari hiyo kwenye cost function iliyo hapo juu. Endpoint inapokea body ileile inayotumiwa na ombi la ujumbe, kwa hiyo picha na PDF zinazotumwa kama base64 huhesabiwa kwa usahihi pia. Inakataa server tools kama web search na web fetch, pamoja na picha au nyaraka zinazopitishwa kwa URL au file reference. Kuna tahadhari mbili muhimu. Hesabu hiyo ni makadirio na inaweza kutofautiana kidogo na nambari inayotozwa. Pia hupimwa kwa tokenizer ya model unayopitisha, kwa hiyo pitisha model utakayoendesha kwa kweli.

Output tokens haziwezi kuhesabiwa mapema, kwa sababu bado hazipo. Zikomo kwa max_tokens, kisha pima mgawanyo halisi kutoka usage.output_tokens kwenye traffic ya moja kwa moja.

Vitu vingine vinavyoongezeka kwenye bili

Tokens ndizo sehemu kubwa ya bili. Kuna vitu vichache ambavyo si tokens, na hivi huwashangaza watu.

• Ufafanuzi wa zana (tool definitions) huwa input tokens katika kila ombi. Mfumo wa prompt wa matumizi ya zana pekee huongeza tokens 286 hadi 406 kwenye Opus 5, kabla ya kuhesabu schemas zako mwenyewe. Ufafanuzi kumi wa zana wenye maneno mengi unaweza kuongeza mara mbili ya ukubwa wa prompt ndogo.
• Web search hutozwa $10 kwa kila utafutaji 1,000, juu ya tokens ambazo matokeo hayo hutumia yanapoingia kwenye context.
• Web fetch haina ada ya ziada, lakini ukurasa uliopakuliwa huwa input tokens. Ukurasa wa nyaraka wa 100 kB ni takriban 25,000 za tokens hizo.
• Kuomba inference ya Marekani pekee (US-only) kwa kutumia inference_geo kwenye Claude 4.6 na matoleo mapya zaidi hutumia kizidishi cha 1.1 kwa kila aina ya token, ikijumuisha usomaji na uandikaji wa cache.

Kama API ndiyo chaguo sahihi la kununua inategemea na kiasi chako cha matumizi. Kufikia kikomo cha matumizi kwenye mpango fulani ndiko kwa kawaida huanzisha swali hilo, na njia za kutoka kwenye kikomo huanzia kusubiri muda wa matumizi uishe hadi kuhamishia kazi hiyo kwenye API calls zinazotozwa kwa matumizi. Chini ya kiwango fulani cha matumizi, mpango wa bei isiyobadilika (flat monthly plan) ni bora zaidi, na API ikilinganishwa na usajili wa Claude hufanya ulinganifu huo kwa kutumia namba halisi.

FAQ

1M tokens hugharimu kiasi gani kwenye Claude?

Inategemea modeli, na ikiwa tokens ni za input au output. Kufikia October 2026, tokens milioni 1 za input hugharimu $1 kwenye Claude Haiku 4.5, $2 kwenye Claude Sonnet 5, na $5 kwenye Claude Opus 5. Claude Haiku 5.5 mpya huanza kwa $0.10 kwa kila tokens milioni 1 za input kwa prompts zenye hadi tokens 100,000, na hutoza $0.50 zaidi ya kiwango hicho. Gharama ya output ni mara 5 ya kiwango cha input kwenye kila mojawapo ya modeli hizo. Viwango hubadilika, kwa hiyo vithibitishe kwenye ukurasa rasmi wa bei kabla ya kuweka kiasi kwenye bajeti.

Je, 1M tokens ni sawa na maneno 1M?

Hapana. Kwenye modeli zilizotangulia Claude Opus 4.7, Anthropic inaweka token 1 kuwa takriban herufi 3.5 za Kiingereza na inasema tokens milioni 1 hubeba takriban maneno 750,000. Kwenye tokenizer mpya inayotumiwa na Claude Opus 4.7 na matoleo ya baadaye, tokens milioni 1 hubeba takriban maneno 555,000, kwa sababu tokenizer hiyo hutengeneza takriban tokens 30 percent zaidi kwa maandishi yaleyale kuliko Claude Sonnet 4.6 na matoleo ya awali. Uwiano huo ni mwongozo tu. Code, JSON na lugha nyingine isipokuwa Kiingereza hutumia tokens nyingi zaidi kwa kila neno, na hesabu hazihamishiki kati ya vizazi vya modeli. Pima kwa kutumia endpoint ya bure ya /v1/messages/count_tokens, ukipitisha modeli unayopanga kuendesha.

Je, prompt caching huokoa pesa kila wakati?

Hapana. Kuandika cache ya dakika 5 hugharimu mara 1.25 ya kiwango cha msingi cha input, kwa hiyo prefix inayoandikwa na kutosomwa kamwe hugharimu 25 percent zaidi kuliko kuituma bila cache. Hujilipa kuanzia usomaji wa kwanza. Hushindwa kwa njia 2, ambazo zote hutokea bila taarifa. Ikiwa prefix iliyowekwa kwenye cache inabadilika kati ya maombi, utafutaji haulingani kamwe, kwa sababu ulinganifu wake ni wa prefix kamili. Ikiwa prefix ni fupi kuliko urefu wa chini unaokubalika kwa cache wa modeli, ambao ni tokens 1,024 kwenye Sonnet 5 na 4,096 kwenye Haiku 4.5, hakuna kinachowekwa kwenye cache na hakuna error inayorejeshwa. cache_creation_input_tokens na cache_read_input_tokens zinaposoma 0 zote mbili, cache haifanyi chochote.

Kwa nini bili yangu ilikua haraka kuliko idadi ya ujumbe?

Kwa sababu mazungumzo yote hutumwa tena kwenye kila zamu. Messages API haihifadhi state, kwa hiyo zamu ya 20 ya chat hubeba tena zamu zote 19 zilizotangulia kama input. Kwa zamu zenye wastani wa tokens 500, mazungumzo ya zamu 20 hutuma takriban tokens 105,000 za input, ingawa transcript ina urefu wa tokens 10,000 tu. Agent loops hufanya vivyo hivyo, kwa sababu kila matokeo ya tool hubaki kwenye historia. Weka prefix thabiti kwenye cache, au fanya muhtasari wa zamu za zamani na uziondoe kwenye ombi.