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

OpenAI API ကို ပေါင်းစပ်ရန်၊ OpenAI project တစ်ခုတွင် API key ဖန်တီးပြီး OPENAI_API_KEY အမည်ဖြင့် server-side secret အဖြစ် သိမ်းပါ၊ ထို့နောက် OpenAI ၏ တရားဝင် SDK ကို အသုံးပြုကာ သင့်ကိုယ်ပိုင် server ရှိ route မှ ခေါ်ပါ၊ browser code မှ ဘယ်တော့မှ မခေါ်ပါနှင့်။ 2026 စက်တင်ဘာလအထိ OpenAI ၏ quickstart က Responses API ကို project အသစ်များအတွက် စတင်ရာနေရာအဖြစ် တင်ပြသည်။ မစမီ spend limit သတ်မှတ်ပါ၊ အဖြေအရှည်ကို ကန့်သတ်ပါ၊ အသုံးပြုသူတစ်ဦးချင်းစီ feature ကို မကြာခဏ ခေါ်နိုင်မှုကို ကန့်သတ်ပါ၊ rate-limit error များကို retry ဖြင့် ကိုင်တွယ်ပါ။

ဤလမ်းညွှန်တွင် တပ်ဆင်ခြင်း၊ request စီးဆင်းမှု၊ AI builder အတွက် prompt များနှင့် key များ ယိုဖိတ်စေခြင်း သို့မဟုတ် ငွေဖြုန်းစေသော အမှားများကို ပါဝင်သည်။ OpenAI အသေးစိတ်များသည် 2026 စက်တင်ဘာလအထိ တရားဝင် စာရွက်စာတမ်းမှ ဖြစ်သည်။ ယေဘုယျ အယူအဆများ (token၊ context window၊ ဈေးနှုန်း) အတွက် LLM API များကို သုံးနည်း ကို ဦးစွာဖတ်ပါ။

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

• အက်ပ်အတွင်း chat assistant (AI chatbot app တည်ဆောက်နည်း)
• "အကျဉ်းချုပ်ပါ"၊ "ပြန်ရေးပါ" သို့မဟုတ် "ပြန်စာ ရေးဆွဲပါ" ခလုတ်များ
• အီးမေးလ်ကို order အဖြစ်၊ support ticket ကို tag လုပ်ခြင်း စသည့် free text မှ structured data ထုတ်ယူခြင်း
• သင့်ကိုယ်ပိုင် content အပေါ် ရှာဖွေခြင်းနှင့် မေးခွန်းဖြေခြင်း
• Model ရရှိနိုင်မှုအလိုက် ပုံဖန်တီးခြင်း၊ အသံနှင့် အခြား media feature များ

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

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

1. OpenAI platform တွင် အကောင့်နှင့် project တစ်ခု ဖန်တီးပါ။ OpenAI ၏ production အကောင်းဆုံးအလေ့အကျင့်များက staging နှင့် production အတွက် project သီးခြား ထားရန် အကြံပြုသည်၊ ထို့ကြောင့် key နှင့် limit များ သီးခြား ရနိုင်သည်။
2. Project API key ဖန်တီးပါ။ OpenAI က သက်တမ်းကုန်ဆုံးရက် သတ်မှတ်ရန်နှင့် ပုံမှန် key ပြောင်းရန် အကြံပြုသည်။
3. Spend alert နှင့် hard spend limit ကို limits စာမျက်နှာတွင် သတ်မှတ်ပါ။ OpenAI ၏ လမ်းညွှန်အရ alert က အသုံးပြုမှု ပမာဏကျော်လွန်သည့်အခါ အသိပေးပြီး hard limit က တစ်လလျှင် ကန့်သတ်ချက်ကို တင်းကျပ်စွာ ထိန်းသည်။
4. Billing ထည့်ပါ။ OpenAI ၏ rate-limit စာရွက်စာတမ်းက usage tier များကို ဖော်ပြသည်: ပိုသုံးလေ သင့်ကန့်သတ်ချက်များ အလိုအလျောက် တက်လေ။

Request စီးဆင်းမှု

Browser  ->  သင့် server route  ->  OpenAI API
         <-  (streamed) အဖြေ    <-

1. အသုံးပြုသူက ခလုတ်ကို နှိပ်သည် သို့မဟုတ် မက်ဆေ့ဂျ်ပို့သည်။
2. Browser က သင့် route ကို ခေါ်သည်၊ ဥပမာ POST /api/summarise။
3. သင့် server က အသုံးပြုသူ login ဝင်ထားကြောင်းနှင့် feature ကို သုံးခွင့်ရှိကြောင်း စစ်ဆေးသည်။
4. Server က request ကို တည်ဆောက်သည်: ညွှန်ကြားချက်များ၊ အသုံးပြုသူ input နှင့် လုပ်ငန်းလိုအပ်သော database ဒေတာ။
5. Environment မှ key ဖြင့် OpenAI ကို ခေါ်သည်။ OpenAI ၏ SDK များက OPENAI_API_KEY ကို အလိုအလျောက် ဖတ်သည်။
6. အဖြေကို stream သို့မဟုတ် ပြန်ပို့ပြီး token သုံးစွဲမှုကို မှတ်တမ်းတင်သည်။

OpenAI ၏ တရားဝင် SDK package များကို JavaScript/TypeScript (npm) နှင့် Python (pip) နှစ်မျိုးလုံးတွင် openai ဟု ခေါ်သည်။

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

OpenAI က ဈေးနှုန်းနှင့် အမြန်နှုန်း မတူသော model များစွာ ပေးထားပြီး စာရင်းသည် မကြာခဏ ပြောင်းလဲသည်။ ပိုသေးငယ်ပြီး ဈေးချိုသော model နဲ့ စတင်ပါ၊ တကယ့်ဥပမာများဖြင့် အရည်အသွေးကို တိုင်းတာပါ၊ လိုအပ်မှသာ အဆင့်မြင့်သော model သို့ တက်ပါ။ Model အမည်ကို config value သို့မဟုတ် secret တွင် ထားပါ၊ code ပြန်ရေးစရာမလိုဘဲ ပြောင်းနိုင်စေရန်။ လက်ရှိနှုန်းထားများအတွက် OpenAI ၏ pricing စာမျက်နှာကို စစ်ပါ။

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

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

ပထမ feature:

Ticket စာမျက်နှာပေါ်တွင် "Summarise" ခလုတ်တစ်ခု ထည့်ပါ။ POST /api/summarise server route ကို ခေါ်ရမည်၊ ထို route က user login ဝင်ထားကြောင်း စစ်ပြီး ticket ကို load လုပ်ရမည်၊ ထို့နောက် official openai SDK နှင့် OPENAI_API_KEY secret ဖြင့် OpenAI Responses API ကို ခေါ်ရမည်။ Model အမည်ကို OPENAI_MODEL secret မှ ဖတ်ပါ။ ညွှန်ကြားချက်: "အမှတ်အသား ၃ ခုဖြင့် အကျဉ်းချုပ်ပြီး နောက် တိုတိုပြန်စာ အကြံပြုပါ။ Order နံပါတ်များကို မဖန်တီးပါနှင့်။" Output အရှည်ကို ကန့်သတ်ပါ၊ အဖြေကို စာမျက်နှာသို့ stream လုပ်ပါ၊ key ကို browser သို့ ဘယ်တော့မှ မပို့ပါနှင့်။

လုံခြုံရေး ကန့်သတ်ချက်များ:

အသုံးပြုသူတစ်ဦးချင်းစီအတွက် တစ်နာရီလျှင် AI request 30 ကန့်သတ်ပါ၊ database တွင် သိမ်းပါ။ Request တစ်ခုစီ၏ input နှင့် output token များကို user ID နှင့် feature အမည်တို့ဖြင့် မှတ်တမ်းတင်ပါ။ OpenAI က 429 ပြန်ပေးလျှင် Retry-After header ကို လေးစားပြီး exponential backoff နှင့် jitter ဖြင့် အများဆုံး 3 ကြိမ် ပြန်ကြိုးစားပါ; ထို့နောက် "AI အလုပ်များနေပါသည်၊ တစ်မိနစ်အကြာ ပြန်ကြိုးစားပါ။" ဟု ပြပါ။ အခြား ပျက်ကွက်မှုများအတွက် ရိုးရှင်းသော error ပြပြီး စာမျက်နှာ၏ ကျန်အပိုင်းများ အလုပ်လုပ်နေစေပါ။

Error နှင့် ကန့်သတ်ချက်များကို ကိုင်တွယ်ခြင်း

OpenAI က rate limit များကို နည်းလမ်းအများအပြား ဖြင့် တိုင်းတာသည်၊ တောင်းဆိုမှု တစ်မိနစ်လျှင် နှင့် token တစ်မိနစ်လျှင် အပါအဝင် ဖြစ်ပြီး ပထမဆုံးကုန်သွားသည့် တစ်ခုကို သင်တွေ့ရမည်။ တစ်ခုကို ကျော်လွန်သည့်အခါ API က 429 နှင့် Retry-After header ကို ပြန်ပေးသည်။ OpenAI ၏ စာရွက်စာတမ်းအရ ထို တန်ဖိုးကို အနည်းဆုံးအချိန်အဖြစ် သတ်မှတ်ပြီး client များ အတူတကွ ပြန်မကြိုးစားစေရန် ကျပန်းနောက်ကျမှု အနည်းငယ်ထည့်ပါ။

အောက်ပါတို့ကိုလည်း စီစဉ်ပါ:

• Timeout ရှည်သော generation များအတွက်။ Streaming က ကူညီပြီး output cap ကောင်းကောင်းလည်း ကူညီသည်။
• Provider ပြတ်တောက်ခြင်း။ AI feature က စာမျက်နှာကို မပျက်စီးစေဘဲ ကျေကျေနပ်နပ် ပျက်ကွက်သင့်သည်။
• မကောင်းသော output။ Structured output ကို သိမ်းမီ validate လုပ်ပါ၊ code ထဲ စစ်ဆေးမှု မပါဘဲ model output က အရေးကြီးသော လုပ်ဆောင်ချက်များကို မဖြစ်စေပါနှင့်။

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

• Frontend သို့မဟုတ် repository ထဲရှိ key။ Browser code သည် အများပြည်သူ ဖြစ်ပြီး ယိုဖိတ်သော key ကို မိနစ်အနည်းငယ်အတွင်း အလွဲသုံးစားလုပ်နိုင်သည်။ API key များကို လုံခြုံစွာ ထားနည်း ကို ကြည့်ပါ။
• Spend limit မရှိခြင်း။ Loop တစ်ခု သို့မဟုတ် အလွဲသုံးစားလုပ်သော အသုံးပြုသူသည် ငွေအကြီးအကျယ် ဖြစ်စေနိုင်သည်။
• အသုံးပြုသူတစ်ဦးချင်းစီ ကန့်သတ်ချက် မရှိခြင်း။ Provider ၏ ကန့်သတ်ချက်က သင့်ပိုက်ဆံအိတ်ကို ကာကွယ်သည်၊ အခြား အသုံးပြုသူများကို မကာကွယ်ပါ။
• လုံခြုံရေးအတွက် prompt ကို ယုံခြင်း။ အသုံးပြုသူက "previous instructions ကို လျစ်လျူရှုပါ" ဟု ရိုက်နိုင်သည်။ ခွင့်ပြုချက်များသည် server code တွင် ရှိရမည်။
• လိုအပ်သည်ထက် ပို ပို့ခြင်း။ Document အပြည့်အစုံ နှင့် ရှည်လျားသော history များသည် ကုန်ကျစရိတ်ကို မြှောက်စေသည်။ အလုပ်လိုအပ်သည်ကိုသာ ပို့ပါ။
• Model အမည်ကို hard-code လုပ်ခြင်း။ Model များ update နှင့် ပိတ်သိမ်းခံရသည်; setting တစ်ခု ဖြစ်စေပါ။
• ကိုယ်ရေးဒေတာကို ဂရုမစိုက်ဘဲ ပို့ခြင်း။ OpenAI ၏ data-use စည်းမျဉ်းများကို ဖတ်ပြီး feature လိုအပ်သည်ကိုသာ ပို့ပါ။

Checklist

• စမ်းသပ်ခြင်းနှင့် production အတွက် သီးခြား OpenAI project (သို့မဟုတ် key)
• Key ကို server-side secret အဖြစ် သိမ်းထား၊ browser code သို့မဟုတ် repo ထဲ မထည့်
• Spend alert နှင့် hard spend limit သတ်မှတ်ပြီး
• ခေါ်ဆိုမှုအားလုံး သင့် server မှတဆင့်၊ အသုံးပြုသူ ခွင့်ပြုချက် စစ်ဆေးပြီး
• Output အရှည် ကန့်သတ်ပြီး; model အမည် configure လုပ်နိုင်သည်
• အက်ပ်တွင် အသုံးပြုသူတစ်ဦးချင်း rate limit
• 429 ကို Retry-After၊ backoff နှင့် jitter ဖြင့် ကိုင်တွယ်
• ရိုးရှင်းသော error အခြေအနေ; AI မပါဘဲ စာမျက်နှာ အလုပ်လုပ်သည်
• Feature အလိုက် token သုံးစွဲမှု မှတ်တမ်းတင်
• ရှည်လျား၊ ဗလာ နှင့် ခေါက်ဆွဲသော input များဖြင့် စမ်းသပ်ပြီး

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

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

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