एक नजरमे

ई दस्तावेज 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 आ अनुरोधक समय लिखि कऽ राखू।

परिनियोजनक रूप

समान मॉडल cloud API आ on-premises स्थापना—दुनू रूपमे उपयोग होइत अछि। अनुरोधक ढाँचा आ प्रमाणीकरणक तरीका दुनूमे समान अछि, मुदा पता आ कुंजी व्यवस्थापनक पर्दा अलग अछि।

डेटा शासन

प्लेटफॉर्म निम्न चारिटा बातकेँ मूलभूत व्यवहार मानैत अछि। वर्कस्पेस विभाजनक मापदण्ड तय करैत समय एकरा संगहि जाँचू।

• अधिकार-आधारित नियन्त्रण — वर्कस्पेसक आधार पर पहुँच अधिकार आ कुंजी अलग करैत अछि।
• पृथक कार्यक्षेत्र — वर्कस्पेससभक बीच डेटा मिश्रित नहि होइत अछि।
• रियल-टाइम डेटा कनेक्शन — बाहरी प्रणालीसँ जोड़ल डेटा देखबाक समयमे आनल जाइत अछि।
• प्रक्रियाक आधार पर अभिलेख संरक्षण — निष्पादित कार्यक एकाइका आधार पर अभिलेख राखल जाइत अछि।

प्रारम्भक क्रम

यदि अहाँ पहिल बेर कनेक्ट क' रहल छी, तँ नीचाँ देल क्रमसँ आगाँ बढ़ू। 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 की जारी करू

प्लेग्राउंड खोलू