Je, Claude API ina mpango wa bure?

Je, Claude API ina mpango wa bure?

Claude API haina mpango wa bure. Hakuna kiasi cha token za bure kwa mwezi, na hakuna mpango unaoweza kutumia kwa $0. Kile ambacho akaunti mpya hupata ni kiasi kidogo cha mkopo wa bure (free credits) kwa ajili ya kufanyia majaribio API, na Anthropic haitoi taarifa ya kiasi hicho. Mkopo huo ukiisha, kila ombi litakatwa kutoka kwenye salio ulilolipia.

Hiyo ndiyo jibu la moja kwa moja. Sehemu iliyobaki ya mwongozo huu inafafanua mambo yanayotokana na ukweli huo: ni sehemu zipi za jukwaa hili ambazo hazigharimu chochote, kwa nini hili ni swali tofauti na mpango wa bure uliopo kwenye programu za Claude, na njia rahisi na ya kweli ya kufanikisha programu yako ya kwanza.

Ni nini kisichotozwa ada kwenye akaunti ya Claude API

Vipengele kadhaa vya jukwaa hili havitozi ada ya token, na ni muhimu zaidi kuliko inavyoweza kuonekana.

• Kuhesabu token. Endpoint ya kuhesabu token haitozi ada. Ina kikomo chake cha maombi kwa dakika (requests-per-minute), ambacho ni tofauti na kile cha kutuma ujumbe, kwa hivyo kupima prompt hakupunguzi bajeti yako ya kuituma.
• Console yenyewe. Kuunda shirika, kusoma ukurasa wako wa matumizi, na kufungua Workbench hakugharimu chochote. Kuendesha prompt ndani ya Workbench ni ombi la kawaida la API, kwa hivyo sehemu hiyo hutoza token kama ombi lingine lolote.
• Uendeshaji wa faili. Kupakia, kuorodhesha, na kufuta faili kupitia Files API ni bure. Unalipia tu wakati maudhui ya faili yanapoingia kwenye ombi kama input tokens.
• Web fetch. Zana ya web fetch haiongezi gharama yoyote zaidi ya token za maudhui yanayovutwa kwenye mazungumzo. Web search si bure: inagharimu $10 kwa kila utafutaji 1,000 kufikia Julai 2026.
• Utekelezaji wa msimbo (Code execution), hadi kiwango fulani. Kila shirika hupata saa 1,550 za bure za container kwa mwezi kufikia Julai 2026, kisha $0.05 kwa saa kwa kila container. Utekelezaji wa msimbo haugharimu chochote cha ziada unapoendeshwa pamoja na web search au web fetch.

Hiyo siyo "free tier". Inamaanisha kuwa mfumo wa malipo ni wa haki: unatozwa kwa ajili ya inference, na si kwa ajili ya miundombinu inayozunguka mchakato huo. Web fetch ya bure inafanya kazi vizuri na vyanzo vya data ambavyo navyo ni vya bure, na kuendesha uchambuzi wa hisa na chaguzi (options) kutoka kwa API ya soko isiyohitaji key ni mfano halisi ambapo kitu pekee unacholipia ni token ambazo data iliyovutwa huleta kwenye prompt.

Kadilia bei ya ombi kabla ya kulilipia

Kwa sababu kuhesabu ni bure, unaweza kujua ukubwa kamili wa ombi kwanza. Hii ni endpoint ileile inayotumiwa na SDKs, na inakubali body ileile kama ujumbe halisi.

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 zuri ni mstari mmoja wa JSON: {"input_tokens": 14}. Zidisha thamani hiyo kwa kiwango cha gharama ya input ya modeli yako na utajua gharama ya ombi kabla ya kulituma. Ukipata HTTP 401 yenye authentication_error, ufunguo si sahihi au umefutwa. Ikiwa ufunguo unaonekana kuwa sahihi na bado ombi halijathibitishwa, au unatumia Claude kupitia Bedrock, Vertex au Foundry badala ya ufunguo wa Anthropic, njia nne za kuthibitisha mteja inaeleza kile kila njia inachohitaji na mahali pa kuhifadhi kitambulisho. Kuhesabu hufanya kazi hata kwenye akaunti isiyo na salio, kwa sababu hakuna chochote kinachozalishwa.

Kwa nini hili ni swali tofauti na mpango wa bure kwenye programu

Watu hutafuta yote mawili, na mambo haya mawili hayahusiani kabisa. Mpango wa bure kwenye programu za Claude ni bidhaa halisi unayoweza kutumia kwa muda mrefu bila kadi, ikipimwa kwa kipindi cha matumizi kinachozunguka, na kile ambacho kiwango cha bure cha Claude kinajumuisha kinaelezea kile kinachobeba na wakati kinapojirejesha. API ni mfumo wa malipo ya awali (prepaid) bila mpango kama huo nyuma yake.

Matokeo yanayowachanganya watu ni kwamba usajili na API key ni pochi mbili tofauti. Kulipia Pro hakufadhili key, na salio la API haliongezi kikomo chako cha chat. Claude Code ndipo mgawanyo huo huwachanganya watu zaidi, kwa sababu hufanya kazi kwa kutumia mojawapo: kama Claude Code imejumuishwa na Pro inaelezea ni mipango ipi inayoiunga mkono na wakati inapoanza kutumia 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. Isipokuwa ni Claude Enterprise, ambayo huweka bei kwa kila mtumiaji na matumizi ya token yaliyopimwa kwa viwango vya API kwenye bili moja, na jinsi bei ya kila mtumiaji katika Enterprise inavyofanya kazi inaelezea kile ambacho kiwango cha chini cha watumiaji hununua kabla ya kipimo kuanza.

Gharama ya ombi baada ya mkopo kuisha

Hizi ni viwango vya API vya mtoa huduma kuanzia Julai 2026, kwa kila token milioni moja.

[
  {
    "label": "Haiku 4.5",
    "input_usd": 1,
    "output_usd": 5
  },
  {
    "label": "Sonnet 5, intro rate",
    "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. Takwimu ya Sonnet 5 ni kiwango cha utangulizi kinachodumu hadi 31 Agosti 2026, baada ya hapo kitarudi kuwa $3 na $15. Gharama ya kutoa ni mara tano ya gharama ya kuingiza katika kila moja ya modeli hizi, ambayo ndiyo ukweli muhimu zaidi kwenye ukurasa huu: jibu refu ni ghali zaidi kuliko swali refu. ni modeli ipi ya Claude unayopaswa kutumia inazilinganisha katika kazi iliyotekelezwa. Fable 5 iko juu ya zote tatu kwa $10 kwa kila token milioni moja za kuingiza na $50 kwa kila milioni moja za kutoa, kwa hivyo viwango hivyo vinanunua nini hasa inafaa kufafanuliwa kabla ya kuelekeza kazi yoyote ya kawaida kwake.

Njia halisi za bei nafuu za kufanya majaribio

Vifaa vinne hufanya karibu kazi yote, na hakuna hata kimoja kinachohitaji punguzo.

• Anza na modeli ndogo zaidi inayopita jaribio lako. Uainishaji, uchimbaji wa data, utambulisho na uelekezaji mara chache huhitaji modeli ya kiwango cha juu. Haiku 4.5 ni ya bei nafuu mara tano kuliko Opus 5 na inajibu kwa kasi zaidi.
• Weka kikomo cha max_tokens. Hii ni dari thabiti ya tokeni zinazozalishwa, na matokeo ndiyo nusu ya gharama kubwa. Kichambuzi kinachojibu kwa neno moja hakipaswi kuwa na bajeti ya tokeni 16,000.
• Hifadhi sehemu ya prompt ambayo haibadiliki kamwe. Usomaji wa cache hugharimu 10% ya bei ya msingi ya ingizo 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, kumaanisha 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 kisichohitaji mwingiliano wa haraka. Message Batches API hutoa punguzo la 50% kwa ingizo na matokeo, na makundi mengi hukamilika ndani ya saa moja. Kazi za usiku, uingizaji wa data wa nyuma (backfills) na majaribio ya tathmini yanapaswa kufanywa huko.

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 posho

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 Julai 2026, ukomo huo ni $500 kwa Start, $1,000 kwa Build na $200,000 kwa Scale, huku Custom ikiwa haina ukomo.

Soma hayo kama kikomo badala ya ruzuku. 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 ya chini zaidi chini ya ukomo wa kiwango hicho, jambo ambalo ni la kwanza kufanya kwenye akaunti yoyote iliyounganishwa na kadi, kwa sababu kitanzi kisichodhibitiwa (runaway loop) ni njia ya kawaida zaidi ya kupoteza pesa kuliko bei ya kila token.

Nini cha kufanya ikiwa kutokuwa na gharama ni sharti la lazima

Ikiwa bajeti ni sifuri kabisa na lazima ibaki hivyo, API si zana sahihi, na hakuna kiasi chochote cha kutafuta viwango vya bei kitakachobadilisha hilo. Chaguo mbili za kweli zimesalia. Tumia mpango wa bure kwenye programu za Claude kwa kazi za mwingiliano, ukikubali kuwa unapimwa kwa kiasi cha matumizi na haupati endpoint inayoweza kupangwa. Au endesha model yenye open-weights kwenye maunzi unayokodisha, ambayo hubadilisha bili ya kila token na 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 kihalisi. Ikiwa itabainika kuwa kiasi cha matumizi ndicho kikwazo cha kweli badala ya pesa, Claude Pro kwa $20 kwa mwezi huondoa kikomo hicho kwenye programu kwa gharama nafuu kuliko bili nyingi za kwanza za API, ingawa bado haikupi chochote cha kuita kutoka kwenye code. Ikiwa $20 hiyo inafaa kulipwa inategemea ni mara ngapi kikomo cha bure kinakuzuia kihalisi, jambo ambalo mwongozo wa maamuzi kwa ajili ya Pro linachambua kulingana na mifumo halisi ya matumizi. Ikiwa unalinganisha watoa huduma badala ya kuchagua ndani ya safu moja, mipango ya Claude na ChatGPT ikilinganishwa kwa bei inaweka viwango vya bure na vya kulipia vya pande zote mbili pamoja, ikijumuisha kipi kinatokea kuwa nafuu kwa kazi za coding. Na ikiwa usajili unaolipa tayari ni sehemu ya matumizi unayojaribu kuyaondoa, kufuta au kushusha mpango huo kunahifadhi mwezi uliokwisha nunua na kusitisha ule unaofuata.

Kwa chochote kilicho katikati, jibu la kivitendo ni ufunguo wenye ufadhili, kikomo cha chini cha matumizi, model ndogo, na prompt caching iliyowashwa kuanzia siku ya kwanza.

FAQ

Je, Claude API ni bure kutumia?

Hapana. Hakuna ngazi ya bure wala kiasi cha token za bure kila mwezi. Akaunti mpya hupokea kiasi kidogo cha mkopo wa bure kwa ajili ya kufanyia majaribio API, na baada ya hapo kila ombi hupunguza mkopo uliolipia mapema au kadi iliyohifadhiwa. Baadhi ya sehemu za jukwaa hazigharimu chochote, ikiwemo kuhesabu token, kupakia na kufuta faili, na zana ya web fetch isipokuwa token za maudhui yanayochotwa.

Je, napata mkopo wa bure ninapojiunga na Claude API?

Ndiyo, kiasi kidogo, na Anthropic haichapishi takwimu hiyo. Ichukulie kama kiasi cha kutosha kuthibitisha kuwa muunganiko wako unafanya kazi, si kama bajeti ya kujengea mfumo. Mkopo wa majaribio uliopanuliwa kwa ajili ya tathmini ya kibiashara hupangwa kupitia idara ya mauzo ya Anthropic, hautolewi kiotomatiki.

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

Hapana. Usajili na API key hulipiwa kando na hupimwa kwa njia tofauti. Pro na Max huongeza uwezo wako ndani ya programu za Claude. API key hutumia mkopo uliolipia mapema na ina mipaka ya maombi na token kwa dakika. Kuhitaji vyote viwili inamaanisha kulipia vyote viwili.

Njia rahisi 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 (cache) prompt yoyote ya mfumo isiyobadilika ili maombi ya mara kwa mara yasomwe kwa asilimia 10 ya bei ya ingizo, na tuma chochote kisicho cha mwingiliano kupitia Batch API kwa nusu bei. Kwa mipangilio hiyo, maombi madogo elfu moja hugharimu kidogo zaidi ya dola moja kufikia Julai 2026.