Gabaabumatti ilaali

Dokumantiin kun bakka jalqabaa dokumantoota misoomsitootaa CLEVI ti. Qindaa'ina Clevi-X-Platform, moodeelota lama API'n waamamuu danda'an, mala mirkaneessaa, akkasumas bifa gaaffii fi deebii bakka tokkotti ibsa. Gaaffii fi deebiin bifa OpenAI Chat Completions hordofu; kanaaf, OpenAI SDK duraan jiru keessatti gatiiwwan lama qofa, jechuun base_url fi api_key, jijjiiruun wal qunnamsiisu dandeessa. Adeemsa waamicha jalqabaa fe'iinsa malee hordofuuf, dokumantii Quick Start ilaali.

Qindaa'ina pilaataformii

Clevi-X-Platform moodeelota, ejentoota, kuusdeetaa semaantikaa fi AI fiizikaalaa naannoo raawwii tokko keessa kaa'a. Isaan keessaa, wanti misoomsitoonni amma HTTP'n kallattiin waaman sadarkaa moodeelotaa ti. Sadarkaan hafan pilaataformii keessaa fi konsolii irratti hojjetu; API ummataaf baname daangaa gabatee armaan gadii irratti agarsiifametti qofa daanga'a.

Tarree moodeelotaa

Dirree model qaama gaaffii keessatti maqaa lamaan armaan gadii keessaa tokko akkuma jirutti galchi. Moodeelonni lamaan teessoo, mirkaneessaa fi bifa gaaffii wal fakkaataa fayyadamu.

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

cip-5.5-im

Sanadoota, suuraawwan, dizaayinoota, fi daataa hojii walitti dhufeenya hiikaatiin walqabsiisee, bu’aa barbaachaafi caasaa beekumsaa uuma. Physical AI’n sadarkaa karoora baasuufi irra deebi’anii karoora baasan keessatti galtee hiikuufis moodeela walfakkaatu fayyadama. Adda himaan keessaa RB-IM jedhamee fayyada; API keessatti maqaan sirrii ta’e cip-5.5-im qofa.

cip-5.5-mm

Barruu, suuraa, akkasumas haala walxaxaa sanadoota hedduu keessa jiru waliin dubbisee deebii uuma. Waamicha meeshaalee fi raawwii adeemsa hojii dabalatuuf, hojii Agentic irratti kan qophaa’e moodeeladha.

Moodeela filadhu

Moodeelota biroo

Waltajjii kana irratti moodeelotni armaan gadii waliin jiru. Akkaataa raabsaafi karaa itti qaqqabamuun isaanii adda waan ta’eef, maqaan API ifa ta’e addaan ibsameera.

Odeeffannoo bu’uuraa fi mirkaneessa eenyummaa

Furtuun tokkoon tokkoon workspace tiin kennama; gaaffii hunda keessatti mata-duree Authorization jalatti Bearer jedhamee maxxanfama. Gatiiwwan jahan gabatee armaan gadii keessa jiran qofa yoo qabaatte, qophiin waamicha jalqabaa barbaachisu xumurama.

sk-... kan gabatee fi fakkeenya keessa jiru bakka furtuu kenname galchitani dha. Ajaja armaan gadii fayyadamuun yoo jijjiiramaa naannoo keessa kaa'ame, fakkeenya galmee kana akkuma jirutti waraabanii raawwachuu dandeessu.

export CLEVI_API_KEY="sk-..."

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

Tarree ergaa fi maqaa moodeelii fudhatee, ergaa moodeeliin uume tokko tarree choices keessa kaa'ee deebisa. Teessoon guutuun https://platform.clevi.net/api/services/v1/aiservice/openai/v1/chat/completions dha. messages yoo xiqqaate wanta ergaa tokko qabaachuu qaba; wanti tokkoon tokkoon isaas role fi content qaba.

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
  }
}

Dirreewwan deebii

Deebiin dirreewwan saddeetii sadarkaa olaanaa irraa ijaarama. Himni uumame wanta jalqabaa tarree choices keessa jira; baay'inni token itti fayyadame immoo usage keessa jira.

Dogoggora

Gaaffiin kufe sababaa isaa koodii haala HTTP tiin beeksisa. Jalqaba tarkaanfiiwwan armaan gadii ilaalaa; koodiin walfakkaataan yoo irra deddeebi'ame, id deebii fi yeroo gaaffii galmeessaa.

Bifa ramaddii

Model walfakkaatu karaa API duumessaa fi karaa fe'iinsa on-premises lamaanitti fayyadama. Bifni gaaffii fi mala mirkaneessaa haalawwan lamaan keessatti walfakkaatu; teessoon fi fuulli bulchiinsa furtuu garuu adda adda.

Bulchiinsa deetaa

Platformichi hojiiwwan armaan gadii afur akka amala durtii qaba. Ulaagaa workspaces itti qooddan murteessuu yeroo ilaaltan, kanas waliin mirkaneessi.

• To'annoo hayyama irratti hundaa'e — Hayyama seensaa fi furtuuwwan sadarkaa workspaces irratti qoodi.
• Iddoo hojii adda baafame — Deetaan workspaces gidduutti walitti hin makamu.
• Walitti hidhamiinsa deetaa yeroo qabatamaa — Deetaa sirnoota alaa waliin walqabate yeroo gaafatanitti fida.
• Kuusaa galmee adeemsa tokkoon tokkoon — Hojii raawwatame tokkoon tokkoon isaatiin galmee kaa'a.

Tartiiba jalqabaa

Yoo yeroo jalqabaaf wal qunnamsiisaa jirtu, tartiiba armaan gadii hordofi. Hanga 3 xumurtutti, furtuu tokkoon moodeelota lamaan waamuu ni dandeessa.

1. https://platform.clevi.net/account/login irratti seeni ykn akkaawuntii uumi.
2. https://clevi.app/cloud irratti workspace dabali.
3. https://clevi.app/cloud/keys irratti furtuu baasiitii jijjiiramaa naannoo keessatti kuusi.
4. https://clevi.app/cloud/playground irratti deebii cip-5.5-im fi cip-5.5-mm wal bira qabi.
5. Fakkeenya gaaffii dokumantii Quick Start irraa ko’piy godhiitii waamicha jalqabaa ergi.

Workspace uumuu

Furtuu API baafachuu

Playground banuu