Claude API ကို သင့်အက်ပ်တွင် ပေါင်းစပ်နည်း

Claude API ကို ပေါင်းစပ်ရန်၊ Anthropic ၏ Claude Console တွင် API key ဖန်တီးပြီး server-side secret (အများအားဖြင့် ANTHROPIC_API_KEY) အဖြစ် သိမ်းပါ၊ ထို့နောက် Anthropic ၏ တရားဝင် SDK တစ်ခုကို အသုံးပြုကာ သင့်ကိုယ်ပိုင် server ရှိ route မှ Messages API ကို ခေါ်ပါ။ တောင်းဆိုမှုတိုင်းတွင် model ကို အမည်ပေးရမည်၊ max_tokens (လက်ခံမည့် အရှည်ဆုံး အဖြေ) ကို သတ်မှတ်ရမည်၊ ပြောဆိုမှုကို messages အဖြစ် ပို့ရမည်၊ ညွှန်ကြားချက်များကို သီးခြား system prompt တွင် ထည့်ရမည်။ သုံးစွဲမှု ကန့်သတ်ချက် သတ်မှတ်ပါ၊ ရှည်သော အဖြေများကို stream လုပ်ပါ၊ rate-limit (429) နှင့် overload (529) error များကို retry ဖြင့် ကိုင်တွယ်ပါ။

ဤလမ်းညွှန်တွင် တပ်ဆင်ခြင်း၊ လုံခြုံသော တောင်းဆိုမှု စီးဆင်းမှု၊ AI builder အတွက် prompt များနှင့် ကြုံတွေ့ရနိုင်သော error များကို ပါဝင်သည်။ Anthropic အသေးစိတ်များသည် 2026 စက်တင်ဘာလအထိ ၎င်းတို့၏ စာရွက်စာတမ်းမှ ဖြစ်သည်။ Token နှင့် ဈေးနှုန်း အကြောင်းကို ယေဘုယျအားဖြင့် သိလိုပါက LLM API များကို သုံးနည်း ကို အရင်ဖတ်ပါ။

ဘာတွေ တည်ဆောက်နိုင်သလဲ

• Chat assistant နှင့် help widget များ (AI chatbot app တည်ဆောက်နည်း)
• အကျဉ်းချုပ်၊ ပြန်ရေးခြင်းနှင့် ပြန်စာ ရေးဆွဲခြင်း
• စာတမ်း၊ အီးမေးလ်နှင့် ဖောင်များမှ field များ ထုတ်ယူခြင်း
• သင့်ကိုယ်ပိုင် content အပေါ် မေးခွန်းများကို ဖြေခြင်း
• tool use မှတဆင့် သင့်အက်ပ်၏ function များကို ခေါ်ဆိုသော agent များ

ပိုမိုသော အိုင်ဒီယာများအတွက် အက်ပ်သို့ AI feature များ ထည့်နည်း ကို ကြည့်ပါ။

Messages API အကျဉ်းချုပ်

Anthropic ၏ API reference အရ တောင်းဆိုမှုသည် https://api.anthropic.com/v1/messages သို့ POST ဖြစ်ပြီး အောက်ပါတို့ ပါဝင်သည်:

API သည် stateless ဖြစ်သည်: စကားဝိုင်းကို ဆက်ရန် ယခင်အလှည့်များကို တောင်းဆိုမှုတိုင်းတွင် ပြန်ပို့ရမည်။ ထို့ကြောင့် ရှည်သော chat များက မက်ဆေ့ဂျ်တစ်ခုစီအတွက် ပိုကုန်ကျသည်။

Anthropic က Python၊ TypeScript၊ C#၊ Go၊ Java၊ PHP နှင့် Ruby အတွက် တရားဝင် SDK များ ထုတ်ပေးသည်။ ၎င်းတို့က header များ သတ်မှတ်ခြင်း၊ response များကို parse လုပ်ခြင်းနှင့် streaming ကို ပံ့ပိုးသည်။ အကြောင်းရှိမှသာ raw HTTP ကို သုံးပါ၊ အများအားဖြင့် SDK ကိုသုံးပါ။

Model ရွေးချယ်ခြင်း

Anthropic က စွမ်းဆောင်ရည်၊ အမြန်နှုန်းနှင့် ဈေးနှုန်းကို ကွဲပြားစွာ ညှိနှိုင်းထားသော Claude model အများအပြား ပေးထားပြီး စာရင်းသည် ပြောင်းလဲနေတတ်သည်။ လုပ်ငန်းကို ကောင်းစွာ လုပ်နိုင်သည့် အသေးဆုံး model ကို ရွေးပါ၊ တကယ့်ဥပမာများဖြင့် စမ်းပါ၊ model ID ကို configuration တွင် ထားပါ၊ code ပြင်စရာမလိုဘဲ ပြောင်းနိုင်စေရန်။ လက်ရှိရွေးချယ်စရာများနှင့် နှုန်းထားများအတွက် Anthropic ၏ models နှင့် pricing စာမျက်နှာများကို စစ်ဆေးပါ။

သင့်အကောင့်ကို တပ်ဆင်ခြင်း

1. Claude Console သို့ ဝင်ရောက်ပါ platform.claude.com တွင် ပြီးလျှင် billing ထည့်ပါ။
2. API key ဖန်တီးပါ။ Environment တစ်ခုစီ (စမ်းသပ်ခြင်းနှင့် production) အတွက် key တစ်ခုစီထားပါ၊ တစ်ခုကို ပြန်ရုပ်သိမ်းရာတွင် တခြားတစ်ခု မပျက်စေရန်။
3. Spend limit သတ်မှတ်ပါ။ Anthropic ၏ errors စာမျက်နှာက သင်သတ်မှတ်ထားသော spend limit သို့ရောက်သည့်အခါ API က 400 error ပြန်ပေးကြောင်း ဖော်ပြသည်၊ ထို့ကြောင့် သင့်အက်ပ်က ရှင်းလင်းသော မက်ဆေ့ဂျ်ကို ပြသသင့်သည်။
4. Rate limit များကို ပြန်စစ်ပါ Console တွင်၊ ၎င်းတို့သည် organization အလိုက် တိုင်းတာသည်။

တောင်းဆိုမှု စီးဆင်းပုံ

1. အသုံးပြုသူက သင့်အက်ပ်တွင် လုပ်ဆောင်သည်: မက်ဆေ့ဂျ်ပို့သည်၊ "အကျဉ်းချုပ်" ကို နှိပ်သည်။
2. Browser က သင့် server route ကို ခေါ်သည်၊ Anthropic ကို တိုက်ရိုက်ခေါ်ခြင်း မဟုတ်ပါ။
3. သင့် server က အသုံးပြုသူ login ဝင်ထားကြောင်း၊ feature ကို သုံးခွင့်ရှိကြောင်း စစ်ဆေးပြီး တစ်ဦးချင်းစီ ကန့်သတ်ချက်ကို လိုက်နာစေသည်။
4. တောင်းဆိုမှု တည်ဆောက်သည်: သင့်စည်းမျဉ်းများပါသော system prompt၊ အသုံးပြုသူ input၊ လုပ်ငန်းလိုအပ်သော database ဒေတာ။
5. Environment မှ key နှင့် သင့်တော်သော max_tokens ဖြင့် Messages API ကို ခေါ်သည်။
6. အဖြေကို browser သို့ stream လုပ်ပြီး response မှ token သုံးစွဲမှုကို မှတ်တမ်းတင်သည်။

ရွေးချယ်စရာများနှင့် trade-off များ

AI builder သို့ ပေးရန် prompt များ

ပထမ feature:

"Ask about this document" panel တစ်ခု ထည့်ပါ။ POST /api/ask server route ကို ခေါ်ရမည်၊ ထို route က user login ဝင်ထားပြီး document ကို ပိုင်ဆိုင်ကြောင်း စစ်ဆေးရမည်၊ ထို့နောက် official Anthropic SDK နှင့် ANTHROPIC_API_KEY secret ဖြင့် Claude Messages API ကို ခေါ်ရမည်။ Model ID ကို CLAUDE_MODEL secret မှ ဖတ်ပါ။ System prompt: "ပေးထားသော document မှသာ ဖြေပါ။ အဖြေ မပါလျှင် ထိုသို့ ပြောပါ။" Document စာသားနှင့် မေးခွန်းကို ပို့ပါ၊ max_tokens ကို 800 သတ်မှတ်ပါ၊ အဖြေကို စာမျက်နှာသို့ stream လုပ်ပါ၊ key ကို browser သို့ ဘယ်တော့မှ မပေးပါနှင့်။

လုံခြုံရေးနှင့် error များ:

အသုံးပြုသူတစ်ယောက်စီအတွက် တစ်နာရီလျှင် မေးခွန်း 20 ကန့်သတ်ပါ၊ database တွင် ခြေရာခံပါ။ တုံ့ပြန်မှုတစ်ခုစီမှ input နှင့် output token များကို user ID နှင့် request ID တို့နှင့်အတူ မှတ်တမ်းတင်ပါ။ 429 သို့မဟုတ် 529 error တွင် exponential backoff ဖြင့် အများဆုံး 3 ကြိမ် ပြန်ကြိုးစားပါ၊ retry-after header ကို လေးစားပါ၊ ထို့နောက် "အကူအညီပေးသူ အလုပ်များနေပါသည်၊ ခဏနောက်မှ ပြန်ကြိုးစားပါ။" ဟု ပြပါ။ API က spend limit error ပြလျှင် "AI feature များ ခဏရပ်ထားပါသည်" ဟု ပြပြီး admin ကို သတိပေးပါ။

ကြုံတွေ့နိုင်သော error များ

Anthropic ၏ errors စာရွက်စာတမ်းမှ သင့်အက်ပ်က တကယ်ကြုံရမည့်အရာများ:

Anthropic ၏ စာရွက်စာတမ်းအရ တရားဝင် SDK များက ယာယီ ပျက်ကွက်မှုများ (connection error၊ rate limit နှင့် 5xx error များ) ကို default အားဖြင့် နှစ်ကြိမ် exponential backoff ဖြင့် အလိုအလျောက် ပြန်ကြိုးစားပြီး ၎င်းကို configure လုပ်နိုင်သည်။ Response တိုင်းတွင် request-id header ပါရှိသည်; support က ပြဿနာကို ခြေရာခံနိုင်ရန် မှတ်တမ်းတင်ပါ။

အဖြစ်များသော အမှားများ

• Browser မှ API ကို တိုက်ရိုက်ခေါ်ခြင်း။ သင့် key ကို ပွင့်လင်းစွာ ဖော်ထုတ်ရာရောက်သည်။ အမြဲ server မှတဆင့် သွားပါ။ API key များကို လုံခြုံစွာ ထားနည်း ကို ကြည့်ပါ။
• max_tokens သည် ပစ်မှတ်မဟုတ်၊ ကန့်သတ်ချက်ဖြစ်ကြောင်း မေ့ခြင်း။ Feature ကလိုအပ်သည့်အရာသို့ သတ်မှတ်ပါ; နိမ့်လွန်းလျှင် အဖြေ ဖြတ်တောက်မည်၊ မြင့်လွန်းလျှင် ရှည်လျားပြီး ကုန်ကျစရိတ်မြင့်သော အဖြေများ ရနိုင်သည်။
• စည်းမျဉ်းများကို user message ထဲတွင် ထည့်ခြင်း။ တည်ငြိမ်သော ညွှန်ကြားချက်များသည် system prompt တွင် ရှိသင့်သည်; ခွင့်ပြုချက်များသည် သင့် code တွင် ရှိသင့်သည်။
• စကားဝိုင်းတစ်ခုလုံးကို အစဉ်ပို့ခြင်း။ ဝိုင်းများ ကြီးလာသည်နှင့်အမျှ ဟောင်းသော အလှည့်များကို ဖြတ်ပါ သို့မဟုတ် အကျဉ်းချုပ်ပါ။
• Spend limit သို့မဟုတ် အသုံးပြုသူတစ်ဦးချင်းစီ ကန့်သတ်ချက် မရှိခြင်း။
• Model ID ကို hard-code လုပ်ခြင်း။ Model များ update နှင့် ပိတ်သိမ်းခံရသည်။
• Stop reason ကို လျစ်လျူရှုခြင်း။ အဖြေသည် max_tokens သို့ရောက်၍ ရပ်သွားလျှင် အသုံးပြုသူကို ပြောပြပါ သို့မဟုတ် ကန့်သတ်ချက်ကို မြှင့်ပါ။

Checklist

• API key ကို Claude Console တွင် ဖန်တီးပြီး server-side secret အဖြစ် သိမ်းထားသည်
• စမ်းသပ်ခြင်းနှင့် production အတွက် key သီးခြား
• Spend limit သတ်မှတ်ပြီး ရောက်သည့်အခါ ရှင်းလင်းသော မက်ဆေ့ဂျ်
• တောင်းဆိုမှုအားလုံး သင့် server မှ ခွင့်ပြုချက်စစ်ဆေးမှုဖြင့်
• System prompt တွင် စည်းမျဉ်းများ; model ID configure လုပ်နိုင်သည်
• Feature တစ်ခုစီအတွက် max_tokens; ရှည်သော အဖြေများကို stream လုပ်သည်
• အက်ပ်တွင် အသုံးပြုသူတစ်ဦးချင်း rate limit
• 429 နှင့် 529 ကို backoff ဖြင့် ကိုင်တွယ်; request ID များ မှတ်တမ်းတင်
• စာမျက်နှာ မပျက်စီးစေသော ရိုးရှင်းသော error အခြေအနေ
• ဗလာ၊ အလွန်ရှည်သော နှင့် ခေါက်ဆွဲသော input များဖြင့် စမ်းသပ်ပြီး

Mythex တွင် Claude API ကို သုံးခြင်း

Mythex ဖြင့် တည်ဆောက်ထားသော အက်ပ်များတွင် Claude feature များသည် သင့်ကိုယ်ပိုင် Anthropic key ကို သုံးပြီး Mythex build credit မဟုတ်ဘဲ သင့် Anthropic အကောင့်သို့ ငွေတောင်းသည်။ ၎င်းသည် code ကို ရေးပေးသော Mythex agent နှင့် သီးခြားဖြစ်သည်။ ANTHROPIC_API_KEY ကို /secrets၊ project settings သို့မဟုတ် chat ရှိ secrets card မှတဆင့် project secret အဖြစ် ထည့်ပါ၊ ထို့နောက် အထက်ပါ prompt များနှင့်ဆင်တူသော prompt ဖြင့် feature ကို ဖော်ပြပါ။ Live အက်ပ်တွင် secret ပြောင်းပြီးနောက် ထပ်မံ publish လုပ်ပါ။ စတင် prompt အတွက် Add AI features with your own API keys ကို ကြည့်ပါ။ Provider ရွေးချယ်နေပါက OpenAI API ကို ပေါင်းစပ်နည်း က OpenAI အတွက် တူညီသော အကြောင်းအရာကို ရှင်းပြသည်။

မေးခွန်းများ