በአንድ እይታ

ይህ ሰነድ የCLEVI የገንቢዎች ሰነዶች መነሻ ነው። የClevi-X-Platform አወቃቀርን፣ በAPI ሊጠሩ የሚችሉ ሁለቱን ሞዴሎች፣ የማረጋገጫ ዘዴን፣ እንዲሁም የጥያቄና ምላሽ ቅርጸቶችን በአንድ ላይ ያብራራል። ጥያቄና ምላሾቹ የOpenAI Chat Completions ቅርጸትን ስለሚከተሉ፣ ከነባሩ OpenAI SDK ጋር base_url እና api_key የሚባሉትን ሁለት እሴቶች ብቻ በመቀየር መገናኘት ይችላሉ። ሳይጫኑ እስከ መጀመሪያው ጥሪ ድረስ የሚከተሉት ሂደት በQuick Start ሰነድ ውስጥ ይገኛል።

የመድረኩ አወቃቀር

Clevi-X-Platform ሞዴሎችን፣ ኤጀንቶችን፣ ሴማንቲክ ዳታቤዝን እና ፊዚካል AIን በአንድ የማስኬጃ አካባቢ ያካትታል። ከእነዚህ ውስጥ ገንቢዎች በአሁኑ ጊዜ በHTTP በቀጥታ የሚጠሩት የሞዴል ንብርብሩን ነው። ሌሎቹ ንብርብሮች በመድረኩ ውስጥና በኮንሶል ላይ ይሰራሉ፣ ይፋዊ API ደግሞ ከታች በሰንጠረዡ የተመለከተውን ወሰን ብቻ ይሸፍናል።

የሞዴሎች ዝርዝር

በጥያቄው አካል ውስጥ ባለው 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 ስሞች በተለየ ይገለጻሉ።

መሠረታዊ መረጃ እና ማረጋገጫ

ቁልፎች በየሥራ ቦታው ደረጃ ይሰጣሉ፣ እና በእያንዳንዱ ጥያቄ ውስጥ በAuthorization ራስጌ ላይ Bearer በማከል ይላካሉ። ከታች ባለው ሰንጠረዥ ያሉት ስድስት እሴቶች የመጀመሪያ ጥሪ የሚያስፈልገውን ማዋቀር ለመጨረስ በቂ ናቸው።

በሠንጠረዡና በምሳሌዎቹ ውስጥ ያለው sk-... የተሰጠዎትን ቁልፍ የሚያስገቡበት ቦታ ነው። በአካባቢ ተለዋዋጭ ውስጥ ለማስቀመጥ ከታች ያለውን ትእዛዝ ከተጠቀሙ፣ የዚህን ሰነድ ምሳሌ በቀጥታ በመቅዳት ማስኬድ ይችላሉ።

export CLEVI_API_KEY="sk-..."

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

የመልዕክቶች ድርድርና የሞዴል ስም ተቀብሎ፣ ሞዴሉ ያመነጨውን አንድ መልዕክት በchoices ድርድር ውስጥ አካቶ ይመልሳል። ሙሉ አድራሻው 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 ድርድር የመጀመሪያው ንጥል ውስጥ ይገኛል፣ የቶከኖች አጠቃቀም መጠን ደግሞ በusage ውስጥ ነው።

ስህተት

ያልተሳካ ጥያቄ ምክንያቱን በ HTTP ሁኔታ ኮድ ያሳውቃል። መጀመሪያ ከታች ያሉትን መፍትሔዎች ይመልከቱ፤ ተመሳሳይ ኮድ ደጋግሞ ከታየ የምላሹን id እና የጥያቄውን ሰዓት ይመዝግቡ።

የማሰማሪያ አይነት

ተመሳሳዩን ሞዴል በደመና API እና በግቢ ውስጥ ጭነት በሁለት መንገዶች ይጠቀማሉ። የጥያቄ ቅርጹ እና የማረጋገጫ ዘዴው በሁለቱም አንድ ናቸው፤ አድራሻው እና የቁልፍ አስተዳደር ገጹ ግን ይለያያሉ።

የውሂብ አስተዳደር

መድረኩ የሚከተሉትን አራት ነገሮች እንደ መደበኛ አሠራር ይጠቀማል። የሥራ ቦታዎችን የሚከፋፍሉበትን መስፈርት ሲወስኑ እነዚህንም አብረው ያረጋግጡ።

• በፈቃድ ላይ የተመሠረተ ቁጥጥር — የመድረሻ ፈቃዶችን እና ቁልፎችን በሥራ ቦታ ደረጃ ይከፋፍላሉ።
• የተገለለ የሥራ ቦታ — በሥራ ቦታዎች መካከል ውሂብ አይቀላቀልም።
• በቅጽበት የውሂብ ግንኙነት — ከውጫዊ ሥርዓቶች ጋር የተገናኘውን ውሂብ በመጠየቂያ ጊዜ ያመጣል።
• በሂደት የተደራጀ መዝገብ ማቆየት — ለተፈጸመ እያንዳንዱ ሥራ መዝገብ ይይዛል።

የመጀመሪያ ደረጃ

መጀመሪያ ጊዜ እየተገናኙ ከሆነ፣ ከታች ባለው ቅደም ተከተል ይቀጥሉ። እስከ 3ኛው ደረጃ ከጨረሱ በኋላ በአንድ ቁልፍ ሁለቱንም ሞዴሎች መጠቀም ይችላሉ።

1. https://platform.clevi.net/account/login ላይ ይግቡ ወይም መለያ ይፍጠሩ።
2. https://clevi.app/cloud ላይ የሥራ ቦታ ያክሉ።
3. https://clevi.app/cloud/keys ላይ ቁልፍ ያውጡና በአካባቢ ተለዋዋጭ ውስጥ ያስቀምጡ።
4. https://clevi.app/cloud/playground ላይ የcip-5.5-im እና የcip-5.5-mm ምላሾችን ያወዳድሩ።
5. በQuick Start ሰነድ ውስጥ ያለውን የጥያቄ ምሳሌ በመቅዳት የመጀመሪያ ጥሪዎን ይላኩ።

የሥራ ቦታ መፍጠር

የAPI ቁልፍ ማውጣት

የመጫወቻ ሜዳ መክፈት