Bi awirekê yekê dîtin

Ev belge destpêka belgeyên pêşdebirên CLEVI ye. Ew pêkhateyên Clevi-X-Platform, du modelên ku dikarin bi API werin gazîkirin, awayê pejirandinê û formatên daxwaz û bersivê bi hev re berhev dike. Ji ber ku daxwaz û bersiv li gorî formata OpenAI Chat Completions in, di SDK-ya heyî ya OpenAI de tenê base_url û api_key biguherînin da ku girêbidin. Prosedûra ku bêyî sazkirin heta yekem gazîkirinê dişopîne di belgeya Quick Start de heye.

Pêkhateya platformê

Clevi-X-Platform model, ajan, databasa semantîk û AI-ya fîzîkî di hundirê hawîrdorekê ya yekane ya xebitandinê de dicivîne. Ji van qatên platformê, tiştê ku pêşdebir niha dikare rasterast bi HTTP gazî bike qata modelê ye. Qatên din di hundirê platformê û konsolê de dixebitin, û API-ya giştî heta sînorê ku di tabloya jêrîn de hatiye nîşandan vekirî ye.

Rêza modelan

Di qada model a bedena daxwazê de yek ji van her du navan bêyî guhertin binivîsin. Her du model heman navnîşan, heman pejirandin û heman formata daxwazê bi kar tînin.

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

cip-5.5-im

Belge, wêne, xêz û daneyên karê bi yekîneyên wateyê ve girêdide û encamên lêgerînê û avahiya zanînê çêdike. Di qonaxên plansazkirin û ji nû ve plansazkirina Physical AI de jî heman model ji bo şîrovekirina têketinê tê bikaranîn. Nasnameya hundirîn RB-IM e, û di API de tenê cip-5.5-im navê derbasdar e.

cip-5.5-mm

Nivîs, wêne û çarçoveya tevlihev a li ser gelek belgeyan bi hev re dixwîne û bersivê çêdike. Ev model ji bo karên Agentic hatiye eyarkirin ku bangên amûran û pêkanîna rêzikên karê dihewîne.

Hilbijartina modelê

Modelên din

Di platformê de modelên jêrîn jî hene. Ji ber ku cureyên belavkirinê û rêyên gihiştinê ji hev cuda ne, navên API yên giştî cuda tên ragihandin.

Agahiyên bingehîn û pejirandin

Mifte li gorî workspaceê tên dayîn û di her daxwazê de bi Bearer di serê Authorization de tên zêdekirin. Bi şeş nirxên tabloya jêrîn, sazkirina ji bo bangên yekemîn temam dibe.

sk-... di tablo û nimûneyan de cihê kilîta ku we stendî ye. Heke hûn wê bi fermana jêrîn di guhêrbarekî jîngehê de bihêlin, hûn dikarin nimûneyên vê belgeyê rasterast kopî bikin û bimeşînin.

export CLEVI_API_KEY="sk-..."

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

Ev rêzek peyaman û navê modelê werdigire û peyamekê ku model çêkiriye di rêzika choices de vedigerîne. Navnîşana tevahî https://platform.clevi.net/api/services/v1/aiservice/openai/v1/chat/completions ye. messages divê herî kêm 1 objeya peyamê dihewîne, û her objeyek role û content heye.

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

Qadên bersivê

Bersiv ji şeş qadên asta jorîn pêk tê. Hevokên hatine çêkirin di yekem hêmanê rêzika choices de ne, û bikaranîna tokenan di usage de ye.

Xeletî

Daxwazên têkçûyî sedemê bi koda rewşa HTTP nîşan didin. Pêşî çareyên li jêr kontrol bikin û heke heman kod dubare bibe, id ya bersivê û dema daxwazê tomar bikin.

Şêwaza belavkirinê

Em heman modelê bi du awayan bikar tînin: API-ya cloudê û sazkirina on-premises. Formata daxwazê û awayê pejirandinê di her du rewşan de wekhev in, lê navnîşan û rûpela rêvebirina mifteyan cuda ne.

Rêveberiya daneyan

Platform ji bo çalakiyên bingehîn çar tiştên jêrîn esas digire. Dema ku hûn standarda dabeşkirina workspace-an diyar dikin, wan jî bi hev re kontrol bikin.

• Kontrola li ser bingeha destûran — Destûrên gihiştinê û mifteyan li gorî workspace-an parçe dikin.
• Cihê karê veqetandî — Daneyên di navbera workspace-an de tevlihev nabin.
• Girêdana daneyên zindî — Daneyên girêdayî pergalên derveyî di dema lêpirsînê de têne anîn.
• Parastina tomarê li gorî pêvajoyê — Tomarê li gorî her karê hatî bicihanîn bihêlin.

Rêza destpêkirinê

Heke ev cara yekem e ku hûn girêdanê dikin, li gorî rêza jêrîn pêşde biçin. Piştî ku hûn heta gavê 3 biqedînin, hûn dikarin bi tenê yek kilîtê her du modelan jî bixebitînin.

1. Li https://platform.clevi.net/account/login têkevin an hesabek çêbikin.
2. Li https://clevi.app/cloud workspaceek zêde bikin.
3. Li https://clevi.app/cloud/keys kilîtê bistînin û wê di guhêrbarekî jîngehê de tomar bikin.
4. Li https://clevi.app/cloud/playground bersivên cip-5.5-im û cip-5.5-mm bidin ber hev.
5. Mînakê daxwazê ji belgeya Quick Start kopî bikin û yekem bangê bişînin.

Workspace çêbikin

Kilîta API bistînin

Playground vekin