ಒಂದು ನೋಟದಲ್ಲಿ

ಈ ದಸ್ತಾವೇಜು CLEVI ಡೆವಲಪರ್ ದಸ್ತಾವೇಜಿನ ಪ್ರಾರಂಭ ಬಿಂದುವಾಗಿದೆ. Clevi-X-Platform ನ ರಚನೆ, API ಮೂಲಕ ಕರೆ ಮಾಡಬಹುದಾದ ಎರಡು ಮಾದರಿಗಳು, ದೃಢೀಕರಣ ವಿಧಾನ, ವಿನಂತಿ ಮತ್ತು ಪ್ರತಿಕ್ರಿಯೆ ಸ್ವರೂಪಗಳನ್ನು ಒಂದೇ ಸ್ಥಳದಲ್ಲಿ ಸಂಕ್ಷಿಪ್ತವಾಗಿ ವಿವರಿಸುತ್ತದೆ. ವಿನಂತಿ ಮತ್ತು ಪ್ರತಿಕ್ರಿಯೆಗಳು OpenAI Chat Completions ಸ್ವರೂಪವನ್ನು ಅನುಸರಿಸುವುದರಿಂದ, ಅಸ್ತಿತ್ವದಲ್ಲಿರುವ OpenAI SDK ನಲ್ಲಿ base_url ಮತ್ತು api_key ಎಂಬ ಎರಡು ಮೌಲ್ಯಗಳನ್ನು ಮಾತ್ರ ಬದಲಿಸಿ ಸಂಪರ್ಕಿಸಬಹುದು. ಇನ್‌ಸ್ಟಾಲ್ ಮಾಡದೆ ಮೊದಲ ಕರೆ ಮಾಡುವವರೆಗೆ ಅನುಸರಿಸಬಹುದಾದ ಕ್ರಮ Quick Start ದಸ್ತಾವೇಜಿನಲ್ಲಿ ಇದೆ.

ಪ್ಲಾಟ್‌ಫಾರ್ಮ್ ರಚನೆ

Clevi-X-Platform ಮಾದರಿಗಳು, ಏಜೆಂಟ್‌ಗಳು, ಸಿಮ್ಯಾಂಟಿಕ್ ಡೇಟಾಬೇಸ್ ಮತ್ತು ಭೌತಿಕ AI ಅನ್ನು ಒಂದೇ ಕಾರ್ಯಗತಗೊಳಿಸುವ ಪರಿಸರದಲ್ಲಿ ಇರಿಸುತ್ತದೆ. ಇವುಗಳಲ್ಲಿ ಡೆವಲಪರ್‌ಗಳು ಈಗ HTTP ಮೂಲಕ ನೇರವಾಗಿ ಕರೆ ಮಾಡಬಹುದಾದದ್ದು ಮಾದರಿ ಪದರವಾಗಿದೆ. ಉಳಿದ ಪದರಗಳು ಪ್ಲಾಟ್‌ಫಾರ್ಮ್‌ನ ಒಳಭಾಗದಲ್ಲಿ ಮತ್ತು ಕನ್ಸೋಲ್‌ನಲ್ಲಿ ಕಾರ್ಯನಿರ್ವಹಿಸುತ್ತವೆ; ಸಾರ್ವಜನಿಕ API ಕೆಳಗಿನ ಪಟ್ಟಿಯಲ್ಲಿ ತೋರಿಸಿರುವ ವ್ಯಾಪ್ತಿಯಲ್ಲಿದೆ.

ಮಾದರಿ ಸರಣಿ

ವಿನಂತಿಯ body ಯ 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 ಮತ್ತು ಆನ್-ಪ್ರಿಮೈಸಸ್ ಸ್ಥಾಪನೆ ಎಂಬ ಎರಡು ರೂಪಗಳಲ್ಲಿ ಬಳಸಲಾಗುತ್ತದೆ. ವಿನಂತಿಯ ಸ್ವರೂಪ ಮತ್ತು ದೃಢೀಕರಣ ವಿಧಾನ ಎರಡರಲ್ಲೂ ಒಂದೇ ಆಗಿದ್ದು, ವಿಳಾಸ ಮತ್ತು ಕೀ ನಿರ್ವಹಣಾ ಪರದೆ ವಿಭಿನ್ನವಾಗಿರುತ್ತವೆ.

ಡೇಟಾ ಆಡಳಿತ

ಪ್ಲಾಟ್‌ಫಾರ್ಮ್ ಕೆಳಗಿನ ನಾಲ್ಕು ಅಂಶಗಳನ್ನು ಮೂಲಭೂತ ಕಾರ್ಯಾಚರಣೆಯಾಗಿ ಹೊಂದಿದೆ. ವರ್ಕ್‌ಸ್ಪೇಸ್‌ಗಳನ್ನು ವಿಭಜಿಸುವ ಮಾನದಂಡವನ್ನು ನಿರ್ಧರಿಸುವಾಗ ಇವುಗಳನ್ನು ಸಹ ಪರಿಶೀಲಿಸಿ.

• ಅನುಮತಿ ಆಧಾರಿತ ನಿಯಂತ್ರಣ — ವರ್ಕ್‌ಸ್ಪೇಸ್ ಮಟ್ಟದಲ್ಲಿ ಪ್ರವೇಶ ಅನುಮತಿಗಳು ಮತ್ತು ಕೀಗಳನ್ನು ವಿಭಜಿಸಲಾಗುತ್ತದೆ.
• ಪ್ರತ್ಯೇಕ ಕಾರ್ಯಸ್ಥಳಗಳು — ವರ್ಕ್‌ಸ್ಪೇಸ್‌ಗಳ ನಡುವೆ ಡೇಟಾ ಮಿಶ್ರಣವಾಗುವುದಿಲ್ಲ.
• ನೈಜ-ಸಮಯದ ಡೇಟಾ ಸಂಪರ್ಕ — ಬಾಹ್ಯ ವ್ಯವಸ್ಥೆಗಳಿಗೆ ಸಂಪರ್ಕಿಸಿದ ಡೇಟಾವನ್ನು ಪ್ರಶ್ನಿಸುವ ಸಮಯದಲ್ಲಿ ಪಡೆಯಲಾಗುತ್ತದೆ.
• ಪ್ರಕ್ರಿಯೆವಾರು ದಾಖಲೆ ಸಂಗ್ರಹಣೆ — ಕಾರ್ಯಗತಗೊಳಿಸಿದ ಕೆಲಸದ ಘಟಕದ ಆಧಾರದ ಮೇಲೆ ದಾಖಲೆಗಳನ್ನು ಉಳಿಸಲಾಗುತ್ತದೆ.

ಪ್ರಾರಂಭಿಸುವ ಕ್ರಮ

처음 연결한다면 아래 순서로 진행하세요. 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 ಕೀ ರಚಿಸಿ

ಪ್ಲೇಗ್ರೌಂಡ್ ತೆರೆಯಿರಿ