တစ်ချက်ကြည့်ရုံဖြင့်

ဤစာရွက်စာတမ်းသည် CLEVI developer documentation ၏ အစပြုရာနေရာဖြစ်သည်။ Clevi-X-Platform ၏ ဖွဲ့စည်းပုံ၊ API ဖြင့် ခေါ်ယူနိုင်သော မော်ဒယ်နှစ်မျိုး၊ အထောက်အထားပြုခြင်းနည်းလမ်းနှင့် တောင်းဆိုချက်၊ တုံ့ပြန်ချက်ပုံစံများကို တစ်နေရာတည်းတွင် အနှစ်ချုပ်ဖော်ပြထားသည်။ တောင်းဆိုချက်နှင့် တုံ့ပြန်ချက်များသည် OpenAI Chat Completions ပုံစံကို လိုက်နာသောကြောင့် ရှိပြီးသား OpenAI SDK တွင် base_url နှင့် api_key တန်ဖိုးနှစ်ခုကိုသာ ပြောင်းလဲပြီး ချိတ်ဆက်နိုင်သည်။ ထည့်သွင်းစရာမလိုဘဲ ပထမဆုံးခေါ်ယူမှုအထိ လိုက်လုပ်နိုင်သော လုပ်ငန်းစဉ်ကို Quick Start စာရွက်စာတမ်းတွင် ဖော်ပြထားသည်။

ပလက်ဖောင်းဖွဲ့စည်းပုံ

Clevi-X-Platform သည် မော်ဒယ်များ၊ အေးဂျင့်များ၊ semantic database နှင့် physical AI တို့ကို လုပ်ဆောင်မှုပတ်ဝန်းကျင်တစ်ခုတည်းတွင် ထားရှိသည်။ ယင်းတို့အနက် developer များက ယခု HTTP ဖြင့် တိုက်ရိုက်ခေါ်ယူနိုင်သည်မှာ မော်ဒယ်အလွှာဖြစ်သည်။ ကျန်အလွှာများသည် ပလက်ဖောင်းအတွင်းနှင့် ကွန်ဆိုးလ်တွင် လုပ်ဆောင်ပြီး အများပြည်သူသုံး API ကို အောက်ပါဇယားတွင် ဖော်ပြထားသော အတိုင်းအတာအထိသာ ရရှိနိုင်သည်။

မော်ဒယ်စာရင်း

တောင်းဆိုချက်၏ body ရှိ model အကွက်တွင် အောက်ပါအမည်နှစ်ခုအနက် တစ်ခုကို မပြောင်းလဲဘဲ ထည့်သွင်းပါ။ မော်ဒယ်နှစ်ခုစလုံးသည် တူညီသောလိပ်စာ၊ တူညီသောအထောက်အထားပြုခြင်းနှင့် တူညီသောတောင်းဆိုချက်ပုံစံကို အသုံးပြုသည်။

• cip-5.5-im
• cip-5.5-mm

cip-5.5-im

စာရွက်စာတမ်းများ၊ ပုံများ၊ ပုံကြမ်းများနှင့် လုပ်ငန်းဒေတာများကို အဓိပ္ပာယ်ယူနစ်များအလိုက် ချိတ်ဆက်ကာ ရှာဖွေမှုရလဒ်များနှင့် အသိပညာဖွဲ့စည်းပုံများကို ဖန်တီးပေးသည်။ Physical AI ၏ အစီအစဉ်ရေးဆွဲခြင်းနှင့် ပြန်လည်အစီအစဉ်ရေးဆွဲခြင်း အဆင့်များတွင် ထည့်သွင်းချက်များကို အဓိပ္ပာယ်ဖော်ရန်လည်း တူညီသောမော်ဒယ်ကို အသုံးပြုသည်။ အတွင်းပိုင်းသတ်မှတ်အမည်အဖြစ် RB-IM ကို အသုံးပြုပြီး API တွင် cip-5.5-im သာ အကျုံးဝင်သောအမည်ဖြစ်သည်။

cip-5.5-mm

စာသားနှင့် ပုံများအပြင် စာရွက်စာတမ်းများစွာအတွင်းရှိ ရှုပ်ထွေးသောအကြောင်းအရာများကို ပေါင်းစပ်ဖတ်ရှုပြီး အဖြေများကို ဖန်တီးပေးသည်။ ကိရိယာခေါ်ယူခြင်းနှင့် လုပ်ငန်းစဉ်များကို အကောင်အထည်ဖော်ခြင်းတို့ ပါဝင်သည့် Agentic လုပ်ငန်းများအတွက် အထူးချိန်ညှိထားသော မော်ဒယ်ဖြစ်သည်။

မော်ဒယ်ရွေးချယ်ရန်

အခြားမော်ဒယ်များ

ပလက်ဖောင်းတွင် အောက်ပါမော်ဒယ်များလည်း ပါဝင်သည်။ ဖြန့်ချိမှုပုံစံနှင့် ဝင်ရောက်အသုံးပြုနိုင်သည့် လမ်းကြောင်းများ မတူညီသောကြောင့် အများပြည်သူသုံး API အမည်များကို သီးခြားဖော်ပြထားသည်။

အခြေခံအချက်အလက်နှင့် အထောက်အထားပြခြင်း

ကီးများကို workspace အလိုက် ထုတ်ပေးပြီး တောင်းဆိုမှုတိုင်းတွင် Authorization header ၌ Bearer အဖြစ် ထည့်သွင်းအသုံးပြုသည်။ အောက်ပါဇယားရှိ တန်ဖိုးခြောက်ခုဖြင့် ပထမဆုံးခေါ်ယူမှုအတွက် လိုအပ်သော ပြင်ဆင်မှုများ ပြီးစီးသည်။

ဇယားနှင့် နမူနာများရှိ sk-... နေရာတွင် ထုတ်ပေးထားသောကီးကို ထည့်ပါ။ အောက်ပါ command ဖြင့် ပတ်ဝန်းကျင်ပြောင်းလဲနိုင်သောအရာထဲသို့ ထည့်ထားပါက ဤစာရွက်စာတမ်းရှိ နမူနာများကို မူရင်းအတိုင်း ကူးယူ၍ လုပ်ဆောင်နိုင်ပါသည်။

export CLEVI_API_KEY="sk-..."

POST /api/services/v1/aiservice/openai/v1/chat/completions

မက်ဆေ့ချ် array နှင့် မော်ဒယ်အမည်ကို လက်ခံပြီး မော်ဒယ်က ဖန်တီးသည့် မက်ဆေ့ချ်တစ်ခုကို choices array ထဲတွင် ထည့်၍ ပြန်ပေးပါသည်။ လိပ်စာအပြည့်အစုံမှာ https://platform.clevi.net/api/services/v1/aiservice/openai/v1/chat/completions ဖြစ်ပါသည်။ messages တွင် အနည်းဆုံး မက်ဆေ့ချ်အရာဝတ္ထု ၁ ခု ပါဝင်ရမည်ဖြစ်ပြီး အရာဝတ္ထုတစ်ခုစီတွင် role နှင့် content ပါဝင်ရပါမည်။

curl https://platform.clevi.net/api/services/v1/aiservice/openai/v1/chat/completions \
  -H "Authorization: Bearer $CLEVI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "cip-5.5-mm",
    "messages": [
      {"role": "system", "content": "사내 문서를 요약하는 도우미로 답한다."},
      {"role": "user", "content": "이 API 의 인증 방식을 한 문장으로 설명해 줘."}
    ]
  }'

# pip install openai
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["CLEVI_API_KEY"],
    base_url="https://platform.clevi.net/api/services/v1/aiservice/openai/v1",
)

completion = client.chat.completions.create(
    model="cip-5.5-mm",
    messages=[
        {"role": "system", "content": "사내 문서를 요약하는 도우미로 답한다."},
        {"role": "user", "content": "이 API 의 인증 방식을 한 문장으로 설명해 줘."},
    ],
)

print(completion.choices[0].message.content)

// npm install openai
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.CLEVI_API_KEY,
  baseURL: "https://platform.clevi.net/api/services/v1/aiservice/openai/v1",
});

const completion = await client.chat.completions.create({
  model: "cip-5.5-mm",
  messages: [
    { role: "system", content: "사내 문서를 요약하는 도우미로 답한다." },
    { role: "user", content: "이 API 의 인증 방식을 한 문장으로 설명해 줘." },
  ],
});

console.log(completion.choices[0].message.content);

{
  "id": "chatcmpl-7d21b4e0",
  "object": "chat.completion",
  "created": 1755500000,
  "model": "cip-5.5-mm",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Authorization 헤더에 Bearer 와 발급받은 API 키를 넣어 인증합니다."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 38,
    "completion_tokens": 24,
    "total_tokens": 62
  }
}

တုံ့ပြန်မှုအကွက်များ

တုံ့ပြန်မှုတွင် အမြင့်ဆုံးအဆင့်အကွက် ခြောက်ခု ပါဝင်သည်။ ထုတ်လုပ်ထားသော စာကြောင်းသည် choices array ၏ ပထမဆုံးအရာအတွင်းတွင်ရှိပြီး၊ token အသုံးပြုမှုပမာဏသည် usage တွင်ရှိသည်။

အမှားအယွင်း

မအောင်မြင်သော တောင်းဆိုချက်များသည် HTTP status code ဖြင့် အကြောင်းရင်းကို အသိပေးသည်။ အောက်ပါဖြေရှင်းနည်းများကို ဦးစွာစစ်ဆေးပြီး၊ တူညီသော code ထပ်ခါတလဲလဲ ဖြစ်ပေါ်ပါက တုံ့ပြန်မှု၏ id နှင့် တောင်းဆိုချက်အချိန်ကို မှတ်တမ်းတင်ထားပါ။

ဖြန့်ကျက်မှုပုံစံ

တူညီသောမော်ဒယ်ကို cloud API နှင့် on-premises တပ်ဆင်မှုဟူသော နည်းလမ်းနှစ်မျိုးဖြင့် အသုံးပြုပါသည်။ တောင်းဆိုမှုပုံစံနှင့် အတည်ပြုနည်းလမ်းသည် နှစ်မျိုးစလုံးတွင် တူညီသော်လည်း လိပ်စာနှင့် ကီးစီမံခန့်ခွဲမှုမျက်နှာပြင်မှာ ကွာခြားပါသည်။

ဒေတာအုပ်ချုပ်မှု

ပလက်ဖောင်းသည် အောက်ပါအချက်လေးချက်ကို အခြေခံလုပ်ဆောင်ချက်များအဖြစ် သတ်မှတ်ထားပါသည်။ workspace များ ခွဲခြားသတ်မှတ်မည့် စံနှုန်းကို ဆုံးဖြတ်ရာတွင် အတူတကွ စစ်ဆေးပါ။

• ခွင့်ပြုချက်အခြေပြု ထိန်းချုပ်မှု — workspace အလိုက် ဝင်ရောက်ခွင့်နှင့် ကီးများကို ခွဲခြားထားပါသည်။
• သီးခြားလုပ်ငန်းခွင် — workspace များအကြား ဒေတာ ရောနှောခြင်းမရှိပါ။
• အချိန်နှင့်တစ်ပြေးညီ ဒေတာချိတ်ဆက်မှု — ပြင်ပစနစ်များနှင့် ချိတ်ဆက်ထားသော ဒေတာကို မေးမြန်းသည့်အချိန်တွင် ရယူပါသည်။
• လုပ်ငန်းစဉ်အလိုက် မှတ်တမ်းသိမ်းဆည်းခြင်း — လုပ်ဆောင်ထားသော အလုပ်ယူနစ်အလိုက် မှတ်တမ်းတင်ထားပါသည်။

စတင်ရန် အစီအစဉ်

ပထမဆုံး ချိတ်ဆက်အသုံးပြုမည်ဆိုပါက အောက်ပါအဆင့်များအတိုင်း လုပ်ဆောင်ပါ။ အဆင့် ၃ အထိ ပြီးမြောက်ပါက ကီးတစ်ခုတည်းဖြင့် မော်ဒယ်နှစ်ခုလုံးကို ခေါ်ယူအသုံးပြုနိုင်ပါသည်။

1. https://platform.clevi.net/account/login တွင် အကောင့်ဝင်ပါ သို့မဟုတ် အကောင့်ဖန်တီးပါ။
2. https://clevi.app/cloud တွင် Workspace တစ်ခု ထည့်ပါ။
3. https://clevi.app/cloud/keys တွင် ကီးထုတ်ယူပြီး ပတ်ဝန်းကျင်ကိန်းရှင်တွင် သိမ်းဆည်းပါ။
4. https://clevi.app/cloud/playground တွင် cip-5.5-im နှင့် cip-5.5-mm တို့၏ တုံ့ပြန်ချက်များကို နှိုင်းယှဉ်ပါ။
5. Quick Start စာရွက်စာတမ်းရှိ တောင်းဆိုချက်နမူနာကို ကူးယူပြီး ပထမဆုံး ခေါ်ယူမှုကို ပေးပို့ပါ။

Workspace ဖန်တီးရန်

API ကီးထုတ်ယူရန်

Playground ဖွင့်ရန်