Je, Claude API ina mpango wa bure wa matumizi?

Je, Claude API ina mpango wa bure?

Claude API haina mpango wa bure. Hakuna kiasi cha tokeni za bure kwa mwezi, na hakuna mpango unaoweza kutumia kwa $0. Akaunti mpya hupata kiasi kidogo cha mkopo wa bure (free credits) kwa ajili ya kufanyia majaribio API, na nyaraka za bei za Anthropic hazitaji kiasi hicho. Mkopo huo ukiisha, maombi yataanza kutumia mkopo uliolipia au ruzuku nyingine za mkopo wa API. Ikiwa unalipia usajili wa Max, Ultra au Team, mipango hiyo inajumuisha mkopo wa API wa kila mwezi, ambao umeelezwa hapa chini. Na ikiwa unafanya utafiti kuhusu usalama wa AI au alignment, Mpango wa Ufikiaji wa Watafiti wa Nje (External Researcher Access Program) wa Anthropic hutoa $1,000 katika mikopo ya API kwa akaunti ya kila mwombaji aliyekubaliwa, kuanzia Oktoba 2026. Anthropic hupitia maombi kila Jumatatu ya kwanza ya mwezi na haitoi majibu kwa maombi yaliyokataliwa.

Hiyo ndiyo jibu la moja kwa moja. Sehemu iliyobaki ya mwongozo huu inafafanua yafuatayo: ni sehemu zipi za jukwaa ambazo hazigharimu chochote, kwa nini hili ni swali tofauti na mpango wa bure katika programu za Claude, na njia rahisi na ya kweli ya kuanza kutumia programu ya kwanza.

Ni nini cha bure kwenye akaunti ya Claude API

Sehemu kadhaa za jukwaa hili hazitozi gharama za token, na ni muhimu zaidi kuliko inavyosikika.

• Kuhesabu token. Endpoint ya kuhesabu token ni bure kutumia. Ina kikomo chake cha maombi kwa dakika, tofauti na uundaji wa ujumbe, kwa hivyo kupima prompt hakupunguzi bajeti ya kuituma.
• Console yenyewe. Kuunda shirika, kusoma ukurasa wako wa matumizi, na kufungua playground (iliyokuwa ikijulikana kama Workbench) hakugharimu chochote. Kuendesha prompt kwenye playground ni ombi la kawaida la API, kwa hivyo sehemu hiyo hutoza token kama ombi lingine lolote.
• Operesheni za faili. Kupakia, kuorodhesha na kufuta faili kupitia Files API ni bure. Unalipia tu wakati maudhui ya faili yanapoingia kwenye ombi kama token za ingizo.
• Web fetch. Zana ya web fetch haiongezi gharama zaidi ya token za chochote inachovuta kwenye mazungumzo. Utafutaji wa wavuti (web search) si bure: unagharimu $10 kwa kila utafutaji 1,000 kufikia Oktoba 2026.
• Utekelezaji wa msimbo (code execution), hadi kiwango fulani. Kila shirika hupata saa 1,550 za bure za container kwa mwezi kufikia Oktoba 2026, kisha $0.05 kwa saa kwa kila container. Utekelezaji wa msimbo haugharimu chochote cha ziada katika ombi linalojumuisha web search au web fetch katika matoleo yao ya 20260209 au baadaye.

Hakuna kati ya hayo kinachounda "free tier". Inamaanisha kuwa upimaji wa matumizi ni wa kweli: unatozwa kwa ajili ya inference, na si kwa ajili ya miundombinu inayozunguka. Web fetch ya bure huenda vizuri na vyanzo vya data ambavyo navyo ni vya bure, na kuendesha uchambuzi wa hisa na chaguzi kutoka kwa API ya data ya soko isiyo na ufunguo ni mfano uliotekelezwa ambapo kitu pekee unacholipia ni token ambazo data iliyovutwa huleta kwenye prompt.

Kadiria gharama ya prompt kabla ya kuilipia

Kwa sababu kuhesabu token ni bure, unaweza kujua ukubwa wa ombi lako kwanza. Hesabu hii ni makadirio, na nyaraka za Anthropic zinasema kuwa idadi ya token katika ombi halisi inaweza kutofautiana kidogo. Hii ni endpoint ileile inayotumiwa na SDK, na inakubali body ileile kama ujumbe halisi, isipokuwa kwa machache: inakataa maombi yenye zana za seva kama vile web search, web fetch au code execution, MCP connector, au picha na PDF zilizopitishwa kwa URL au file ID; kwa hiyo, tuma picha na PDF kama base64 ili ziweze kuhesabiwa.

Tumia key iliyowekewa wigo wa workspace kwa mfano ufuatao. Ikiwa key yako haijafungwa kwenye workspace, tuma pia anthropic-workspace-id pamoja na ID ya workspace hiyo; kuikosa kutasababisha HTTP 400 pamoja na invalid_request_error.

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-haiku-4-5",
    "system": "You are a scientist",
    "messages": [{"role": "user", "content": "Hello, Claude"}]
  }'

Jibu sahihi ni mstari mmoja wa JSON, kama vile {"input_tokens": 14}. Zidisha thamani hiyo kwa kiwango cha gharama ya input ya model yako ili kupata makadirio ya karibu ya gharama ya input ya ombi hilo kabla ya kulituma. Fanya hesabu hiyo kwa kutumia model utakayotumia, kwa sababu Claude 4.7 na model za baadaye hutoa takriban 30% ya token nyingi zaidi kwa maandishi yaleyale ikilinganishwa na zile za zamani kama Haiku 4.5. Ikiwa utapata HTTP 401 pamoja na authentication_error, hakikisha kama key si mbaya, imefutwa au muda wake umeisha. Key iliyotolewa kwa usahihi pia hurejesha error hii baada ya muda wake kuisha; angalia tarehe ya kuisha kwake kwenye Console na utengeneze key mpya, kwa sababu key zilizokwisha muda wake haziwezi kuwashwa tena. Ikiwa key inaonekana kuwa sahihi na bado ombi linashindwa kufanya authentication, au unatumia Claude kupitia Bedrock, Vertex au Foundry badala ya key ya Anthropic, njia nne za kufanya authentication ya client inaelezea kile kila njia inachohitaji na mahali pa kuhifadhi credential.

Kwa nini hili ni swali tofauti na lile la mpango wa bure kwenye apps

Watu hutafuta yote mawili, na hayana uhusiano wowote. Mpango wa bure kwenye apps za Claude ni bidhaa halisi unayoweza kutumia kwa muda mrefu bila kadi, ikipimwa kwa kutumia dirisha la matumizi linalojirudia, na kile ambacho tier ya bure ya Claude inajumuisha kinaelezea kile inachobeba na wakati inapoanza upya. API ni mfumo wa malipo ya awali (prepaid) ambao hauna mpango kama huo nyuma yake.

Matokeo yanayowachanganya watu ni kwamba kwenye mipango mingi, usajili (subscription) na API key ni pochi tofauti. Kulipia Pro hakufadhili API key, na credits za API haziongezi kiwango chako cha chat. Claude Code ndipo mgawanyo huu huwachanganya watu zaidi, kwa sababu hufanya kazi kwa kutumia mojawapo: kama Claude Code imejumuishwa na Pro inaelezea ni mipango ipi inayoifunika na wakati inapoanza kutumia API key kwa malipo kimyakimya. Ikiwa unachagua kati ya hayo mawili badala ya kujaribu kuepuka kulipa kabisa, gharama ya Claude API dhidi ya usajili inafafanua hesabu za kazi halisi.

Kuna tofauti mbili. Tangu tarehe 7 Oktoba 2026, mipango ya Max na Team inajumuisha mkopo wa API wa kila mwezi. Kufikia Oktoba 2026, ni $100 kwenye Max na $200 kwenye Ultra, ambayo zamani ilikuwa Max 20x. Kwenye Team, ni $20 kwa kila kiti cha Standard au $100 kwa kila kiti cha Premium, zikijumuishwa na kupangiwa ukomo wa $500. Unadai mkopo huo kwa kuunganisha shirika la Console (wasajili wapya husubiri siku 7 kwanza), na huhitaji kuongeza njia ya malipo kwenye Claude Platform. Inagharamia API, Agent SDK na Managed Agents lakini si Claude Code ya mwingiliano. Pia inagharamia claude -p unapoiendesha mwenyewe kwa kutumia API key kutoka kwa shirika la Console lililounganishwa; uendeshaji ulioanzishwa na Claude Code GitHub Action, extension ya IDE au app ya desktop ya Claude haugharamiwi. Mkopo usiotumika huisha muda wake mwishoni mwa kila mzunguko wa malipo. Mara tu unapotumika, maombi husimama hadi mkopo mwingine ufike isipokuwa kama umenunua mkopo wa API au una mkataba wa ankara. Mipango ya Free, Pro na Enterprise haipati mkopo huu, kwa hivyo soma mambo ya kuzingatia kabla ya kupandisha daraja hadi Max kabla ya kununua mpango kwa ajili ya mkopo huo pekee. Tofauti nyingine ni Claude Enterprise, ambayo huoanisha bei kwa kila kiti na matumizi ya token yaliyopimwa kwa viwango vya kawaida vya API, na jinsi bei ya kiti cha Enterprise inavyofanya kazi inaelezea kile ambacho kiwango cha chini cha viti hununua kabla ya mita kuanza kusoma.

Gharama ya ombi baada ya mkopo kuisha

Hizi ni bei za API za mtoa huduma kuanzia Oktoba 2026, kwa kila token milioni moja.

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

Haiku 4.5 inatoza 1 dola kwa kila token milioni moja za kuingiza na 5 dola kwa kila token milioni moja za kutoa. Opus 5 inatoza 5 na 25 kwa kiasi hicho hicho, kwa hivyo modeli unayochagua inaweza kubadilisha bili mara 5 kabla ya marekebisho yoyote ya prompt. Sonnet 5 ilizinduliwa kwa $2 na $10 kama bei ya utangulizi, na Anthropic imefanya hiyo kuwa bei yake ya kawaida, kwa hivyo ongezeko la $3 na $15 lililopangwa kufanyika tarehe 1 Septemba 2026 halikutokea. Gharama ya kutoa ni mara tano ya gharama ya kuingiza kwa kila modeli kati ya hizo, jambo ambalo ndilo ukweli muhimu zaidi kwenye ukurasa huu: jibu refu ni ghali zaidi kuliko swali refu. ni modeli ipi ya Claude unayopaswa kutumia inazilinganisha kwa kazi iliyotekelezwa. Fable 5 iko juu ya zote tatu kwa $10 kwa kila token milioni moja za kuingiza na $50 kwa kila milioni za kutoa, kwa hivyo viwango hivyo vinanunua nini hasa inafaa kufafanuliwa kabla ya kuelekeza kazi yoyote ya kawaida kwake. Modeli tatu mpya zaidi pia ziko kwenye orodha ya bei: Haiku 5.5 inatoza $0.10 kwa kila token milioni moja za kuingiza na $0.50 kwa kila milioni za kutoa kwa prompts za hadi token 100,000, Sonnet 5.5 inatoza $2 na $10, na Opus 5.5 inatoza $4 na $20.

Njia halisi za gharama nafuu za kufanya majaribio

Viwango vinne hufanya karibu kazi yote, na hakuna hata kimoja kinachohitaji punguzo la bei.

• Anza na modeli ndogo zaidi inayopita jaribio lako. Uainishaji, uchimbaji wa data, utambulisho (tagging) na uelekezaji (routing) mara chache huhitaji modeli ya kiwango cha juu (frontier model). Haiku 4.5 ni ya bei nafuu mara tano kuliko Opus 5 na inajibu haraka zaidi.
• Weka kikomo cha max_tokens. Hii ni dari thabiti ya tokeni zinazozalishwa, na matokeo (output) ndiyo nusu ya gharama kubwa. Kichambuzi kinachojibu kwa neno moja hakipaswi kubeba bajeti ya tokeni 16,000.
• Hifadhi (cache) sehemu ya prompt isiyobadilika. Usomaji wa cache hugharimu 10% ya bei ya msingi ya input kwenye modeli nyingi (5% kwenye Opus 5.5 na Sonnet 5.5, na 2.5% kwenye Fable 5.1) na uandishi wa cache wa dakika tano hugharimu 1.25x, kwa hivyo kuhifadhi kwenye cache hujilipia baada ya usomaji mmoja tu. Kuhifadhi kwenye cache ni ulinganishaji wa kiambishi awali (prefix match), kumaanisha kuwa maandishi thabiti lazima yawe mwanzo na swali linalobadilika liwe mwisho, vinginevyo hakuna kitakacholingana na utalipia gharama ya ziada ya uandishi bila faida.
• Fanya kazi kwa makundi (batch) kwa chochote kisicho cha mwingiliano wa moja kwa moja. API ya Message Batches ina punguzo la 50% kwa input na output, na makundi mengi hukamilika ndani ya saa moja. Kazi za usiku, ujazaji wa data (backfills) na majaribio ya tathmini (evaluation runs) yanapaswa kufanywa hapo.

Gharama iliyokadiriwa kwa programu ndogo ya kwanza

Chukua hati ya muhtasari wa logi: wito 1,000, kila moja ikituma takriban token 800 za ingizo za mistari ya logi na kupokea takriban token 200 za muhtasari. Hiyo ni token 800,000 za ingizo na token 200,000 za pato kwenye Haiku 4.5.

[
  {
    "label": "Standard rates",
    "cost_usd": "1.80"
  },
  {
    "label": "Same job on the Batch API",
    "cost_usd": "0.90"
  }
]

Hesabu ni milioni 0.8 za token za ingizo kwa $1 pamoja na milioni 0.2 za token za pato kwa $5, ambayo ni 1.80 dola kwa jumla. Ikitumwa kama batch badala yake, kazi hiyo hiyo inagharimu 0.90. Salio la mkopo wa kuanzia linatosha kwa majaribio mengi katika kiwango hicho, ndiyo sababu kukosekana kwa tier ya bure huleta changamoto baadaye sana kuliko watu wanavyotarajia. Kwa mwongozo kamili kwenye seva unayomiliki, kujenga programu ya kwanza ya Claude API kwenye VPS inashughulikia usimamizi wa key, streaming na njia za makosa.

Viwango vya matumizi ni ukomo, si mgao

API huweka kila shirika kwenye kiwango cha matumizi (usage tier) kiotomatiki, kulingana na historia ya matumizi na hali ya akaunti. Viwango hivyo huitwa Start, Build, Scale na Custom, na kila kimoja huweka mipaka ya kasi (rate limits) pamoja na ukomo wa matumizi ya kila mwezi. Kufikia Oktoba 2026, ukomo huo ni $500 kwa Start, $1,000 kwa Build na $200,000 kwa Scale, huku Custom ikiwa haina ukomo. Mashirika mapya, na yale yenye historia ndogo ya matumizi, yanaweza kuanza kwenye kiwango cha Evaluation chenye mipaka iliyo chini ya viwango hivi hadi historia hiyo itakapojengeka.

Chukulia hili kama ukomo badala ya mgao. Kuwa kwenye kiwango cha Start haimaanishi una $500 za kutumia. Inamaanisha huwezi kutumia zaidi ya $500 katika mwezi wa kalenda kabla ya matumizi kusitishwa hadi mwezi unaofuata. Unaweza pia kuweka ukomo wako wa matumizi uliyo chini ya ukomo wa kiwango husika, jambo ambalo ni la kwanza kufanya kwenye akaunti yoyote iliyounganishwa na kadi, kwa sababu kitanzi cha matumizi yasiyodhibitiwa (runaway loop) ni njia ya kawaida zaidi ya kupoteza pesa kuliko bei ya kila token.

Nini cha kufanya ikiwa kutumia bila malipo ni sharti kuu

Ikiwa bajeti yako ni sifuri kabisa na lazima ibaki hivyo, basi API si zana sahihi, na hakuna kiasi chochote cha kutafuta viwango vya bei kitakachobadilisha ukweli huo. Kuna chaguo mbili za kweli zilizobaki. Tumia mpango wa bure kwenye programu za Claude kwa kazi za mwingiliano, ukikubali kuwa una kikomo cha matumizi na haupati endpoint inayoweza kupangwa. Au endesha model yenye open-weights kwenye maunzi unayokodisha, jambo ambalo hubadilisha bili ya kila token na kuwa bili ya seva unayoimiliki: kuendesha Ollama kwenye VPS ili kujihostia LLM inaelezea kumbukumbu inayohitajika kwa kila ukubwa wa model na kile ambacho zile ndogo zinaweza kufanya. Ikiwa kikomo cha matumizi ndicho kikwazo kikubwa badala ya pesa, Claude Pro kwa $20 kwa mwezi huondoa kikomo hicho kwenye programu kwa gharama nafuu kuliko bili nyingi za kwanza za API. Hata hivyo, haiji na API key wala mkopo wa API. Njia pekee ya kukaribia kuita Claude kutoka kwenye code ni Claude Code, ambayo Pro inajumuisha na inaweza kuendeshwa bila mwingiliano kwa kutumia claude -p ndani ya vikomo vilevile vya matumizi. Ikiwa $20 hiyo inafaa kulipwa inategemea ni mara ngapi kikomo cha bure kinakuzuia, jambo ambalo mwongozo wa maamuzi kwa ajili ya Pro linachambua kulingana na mifumo halisi ya matumizi. Ikiwa unalinganisha watoa huduma tofauti badala ya ndani ya safu moja, mipango ya Claude na ChatGPT ikilinganishwa kwa bei inaweka viwango vya bure na vya kulipia vya pande zote mbili pamoja, ikiwemo kipi kinakuwa nafuu zaidi kwa kazi za coding. Na ikiwa usajili unaolipa sasa ni sehemu ya matumizi unayojaribu kuyaondoa, kufuta au kushusha mpango huo kutakuruhusu kumaliza mwezi uliokwisha nunua na kuzuia ule unaofuata.

Kwa chochote kilicho katikati ya hapo, jibu la kivitendo ni kutumia key yenye ufadhili, kuweka kikomo cha chini cha matumizi, kutumia model ndogo, na kuwasha prompt caching kuanzia siku ya kwanza.

FAQ

Je, Claude API ni bure kutumia?

Hapana. Hakuna tier ya bure wala kiasi cha token za bure cha kila mwezi. Akaunti mpya hupokea kiasi kidogo cha mkopo wa bure kwa ajili ya kufanyia majaribio API. Baada ya hapo, maombi hutumia mkopo uliolipwa au ruzuku nyingine za mkopo wa API, ikiwemo mkopo wa API wa kila mwezi unaopatikana kwenye plan za Max, Ultra na Team, ambao hauhitaji njia ya malipo kwenye Claude Platform, na $1,000 ya mkopo wa API ambayo Anthropic's External Researcher Access Program huweka kwenye akaunti za watafiti wa usalama na uwiano wa AI waliokubaliwa. Baadhi ya sehemu za jukwaa hazigharimu chochote, ikiwemo kuhesabu token, kupakia na kufuta faili, na zana ya web fetch nje ya token za kile inachokipakua.

Je, napata mkopo wa bure nikijisajili kwa Claude API?

Ndiyo, kiasi kidogo, na nyaraka za bei za Anthropic hazitaji kiasi hicho. Ichukulie kama kiasi cha kutosha kuthibitisha kuwa integration yako inafanya kazi badala ya kuichukulia kama bajeti ya kujengea. Mkopo wa majaribio uliopanuliwa kwa ajili ya tathmini ya kibiashara hupangwa kupitia mauzo ya Anthropic, hautolewi kiotomatiki.

Je, kulipia Claude Pro au Max kunajumuisha ufikiaji wa API?

Pro haijumuishi, na Max sasa inajumuisha kiasi fulani. Usajili wa Pro na API key hulipiwa kando na hupimwa kwa njia tofauti: Pro huongeza ukomo wako ndani ya programu za Claude na Claude Code, na si vinginevyo. Kufikia Oktoba 2026, Max inajumuisha mkopo wa API wa kila mwezi wa $100 na Ultra inajumuisha $200, ambao unadai kwa kuunganisha shirika la Console. Mkopo huu hugharamia API calls lakini si Claude Code ya mwingiliano, huisha kila mzunguko wa malipo, na haubadilishi ukomo wako kwenye programu. Zaidi ya mkopo huo, API key hutumia mikopo iliyolipwa kabla na ina ukomo kwa kila dakika kulingana na maombi na token.

Njia ya bei nafuu zaidi ya kufanyia majaribio Claude API ni ipi?

Hesabu token zako kwanza, kwa sababu endpoint hiyo ni bure. Kisha fanya jaribio kwenye Haiku 4.5 ukiwa na max_tokens ndogo, hifadhi kwenye cache prefix ya prompt isiyobadilika ya angalau 4,096 token ili maombi ya kurudia yasomwe kwa 10% ya bei ya input, na tuma chochote ambacho si cha mwingiliano kupitia Batch API kwa nusu bei. Kwa mipangilio hiyo, maombi elfu moja madogo hugharimu chini ya dola moja kufikia Oktoba 2026.