ഒറ്റനോട്ടത്തിൽ

ഈ രേഖ 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 കീ സൃഷ്ടിക്കുക

പ്ലേഗ്രൗണ്ട് തുറക്കുക