ଗୋଟିଏ ନଜରରେ

ଏହି ଡକ୍ୟୁମେଣ୍ଟ 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 ରେ ଅତି କମରେ 1ଟି ବାର୍ତ୍ତା ଅବଜେକ୍ଟ ଥିବା ଆବଶ୍ୟକ, ଏବଂ ପ୍ରତ୍ୟେକ ଅବଜେକ୍ଟରେ 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 ଏବଂ ଅନ୍-ପ୍ରେମାଇସ୍ ସ୍ଥାପନ—ଏହି ଦୁଇ ପ୍ରକାରରେ ବ୍ୟବହାର କରାଯାଏ। ଅନୁରୋଧ ଫର୍ମାଟ୍ ଏବଂ ପ୍ରମାଣୀକରଣ ପ୍ରଣାଳୀ ଉଭୟ କ୍ଷେତ୍ରରେ ସମାନ, କିନ୍ତୁ ଠିକଣା ଏବଂ କୀ ପରିଚାଳନା ସ୍କ୍ରିନ୍ ଭିନ୍ନ।

ଡାଟା ଶାସନ

ପ୍ଲାଟଫର୍ମ ନିମ୍ନଲିଖିତ ଚାରୋଟିକୁ ମୌଳିକ କାର୍ଯ୍ୟ ଭାବେ ରଖେ। ୱର୍କସ୍ପେସ୍ ବିଭାଜନର ମାନଦଣ୍ଡ ନିର୍ଦ୍ଧାରଣ କରିବାବେଳେ ଏଗୁଡ଼ିକୁ ମଧ୍ୟ ଯାଞ୍ଚ କରନ୍ତୁ।

• ଅନୁମତି ଆଧାରିତ ନିୟନ୍ତ୍ରଣ — ୱର୍କସ୍ପେସ୍ ଆଧାରରେ ପ୍ରବେଶ ଅଧିକାର ଏବଂ କୀ ବିଭାଜନ କରାଯାଏ।
• ପୃଥକ କାର୍ଯ୍ୟସ୍ଥାନ — ୱର୍କସ୍ପେସ୍‌ଗୁଡ଼ିକ ମଧ୍ୟରେ ଡାଟା ମିଶ୍ରିତ ହୁଏ ନାହିଁ।
• ରିଅଲ୍-ଟାଇମ୍ ଡାଟା ସଂଯୋଗ — ବାହ୍ୟ ସିଷ୍ଟମ୍‌ଗୁଡ଼ିକ ସହିତ ସଂଯୁକ୍ତ ଡାଟାକୁ ଦେଖିବା ସମୟରେ ଆଣାଯାଏ।
• ପ୍ରକ୍ରିୟା ଅନୁଯାୟୀ ରେକର୍ଡ ସଂରକ୍ଷଣ — ଚାଲୁ କରାଯାଇଥିବା କାର୍ଯ୍ୟ ଏକକ ଅନୁଯାୟୀ ରେକର୍ଡ ରଖାଯାଏ।

ଆରମ୍ଭ କରିବାର କ୍ରମ

ପ୍ରଥମ ଥର ସଂଯୋଗ କରୁଥିଲେ, ନିମ୍ନଲିଖିତ କ୍ରମରେ ଆଗେଇଯାଆନ୍ତୁ। ୩ ନମ୍ବର ପର୍ଯ୍ୟନ୍ତ ସମାପ୍ତ କଲେ, ଗୋଟିଏ କି ସହିତ ଉଭୟ ମଡେଲ୍‌କୁ କଲ୍ କରିପାରିବେ।

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 କି ଜାରି କରନ୍ତୁ

ପ୍ଲେଗ୍ରାଉଣ୍ଡ ଖୋଲନ୍ତୁ