ತ್ವರಿತ ಪ್ರಾರಂಭ

ಈ ದಸ್ತಾವೇಜು CLEVI API ಕೀಲಿಯನ್ನು ಪಡೆಯುವುದರಿಂದ ಹಿಡಿದು ನಿಮ್ಮ ಮೊದಲ ವಿನಂತಿಯನ್ನು ಕಳುಹಿಸಿ ಪ್ರತಿಕ್ರಿಯೆಯನ್ನು ಪಡೆಯುವವರೆಗೆ ಒಳಗೊಂಡಿದೆ. ಒಂದೇ URL ಮತ್ತು ಒಂದೇ ಕೀಲಿಯಿಂದ cip-5.5-im ಮತ್ತು cip-5.5-mm ಅನ್ನು ಕರೆ ಮಾಡಬಹುದು. ವಿನಂತಿಗಳು ಮತ್ತು ಪ್ರತಿಕ್ರಿಯೆಗಳು OpenAI Chat Completions ಸ್ವರೂಪವನ್ನು ಅನುಸರಿಸುವುದರಿಂದ, ನೀವು ಬಳಸುತ್ತಿದ್ದ OpenAI SDK ಯಲ್ಲಿ base_url ಮತ್ತು api_key ಎಂಬ ಎರಡು ಮೌಲ್ಯಗಳನ್ನು ಮಾತ್ರ ಬದಲಾಯಿಸಿದರೆ ಸಾಕು. Anthropic SDK ಗಾಗಿ ಮಾರ್ಗಗಳು ಮತ್ತು embedding·ಧ್ವನಿ ಮಾರ್ಗಗಳು API ಕರೆ ಮಾಡುವುದು ದಸ್ತಾವೇಜಿನಲ್ಲಿಿವೆ.

API ಕೀ ಪಡೆಯುವುದು

CLEVI Cloud ಕನ್ಸೋಲ್‌ನ API ಕೀ ಪರದೆಯಲ್ಲಿ ಕೀಲಿಯನ್ನು ಪಡೆಯಬಹುದು. ಅದೇ ಪರದೆಯಲ್ಲಿ ಕೀಲಿಯನ್ನು ರದ್ದುಪಡಿಸಿ ಅದರ ಬಳಕೆಯ ವ್ಯಾಪ್ತಿಯನ್ನು ನಿರ್ವಹಿಸಬಹುದು. ಕೆಳಗಿನ ಕ್ರಮಗಳನ್ನು ಅನುಸರಿಸಿದರೆ ವಿನಂತಿಗಳಿಗಾಗಿ ಬಳಸಬಹುದಾದ ಒಂದು ಕೀಲಿಯನ್ನು ಪಡೆಯುತ್ತೀರಿ.

1. https://platform.clevi.net/account/login ನಲ್ಲಿ ಲಾಗಿನ್ ಮಾಡಿ ಅಥವಾ ಖಾತೆಯನ್ನು ರಚಿಸಿ.
2. https://clevi.app/cloud ನಲ್ಲಿ ವರ್ಕ್‌ಸ್ಪೇಸ್ ಸೇರಿಸಿ.
3. https://clevi.app/cloud/keys ಗೆ ಹೋಗಿ.
4. ಹೊಸ ಕೀಲಿಯನ್ನು ಪಡೆಯಿರಿ ಮತ್ತು ಅದರ ಮೌಲ್ಯವನ್ನು ನಕಲಿಸಿ.
5. ನಕಲಿಸಿದ ಮೌಲ್ಯವನ್ನು ಪರಿಸರ ಚರಾಂಶದಲ್ಲಿ ಉಳಿಸಿ.

ಈ ದಸ್ತಾವೇಜಿನ ಉದಾಹರಣೆಗಳಲ್ಲಿ ಕಾಣಿಸುವ sk-... ಸ್ಥಾನದಲ್ಲಿ ನೀವು ಪಡೆದ ಕೀಲಿಯನ್ನು ನಮೂದಿಸಿ. ಕೆಳಗಿನ ಆಜ್ಞೆಯ ಮೂಲಕ ಅದನ್ನು ಪರಿಸರ ಚರಾಂಶದಲ್ಲಿ ಉಳಿಸಿದರೆ, ನಂತರದ ಉದಾಹರಣೆಗಳನ್ನು ಹಾಗೆಯೇ ನಕಲಿಸಿ ಚಲಾಯಿಸಬಹುದು.

export CLEVI_API_KEY="sk-..."

ಮಾದರಿಯನ್ನು ಆಯ್ಕೆಮಾಡುವುದು

ವಿನಂತಿಯ body ಯ model ಕ್ಷೇತ್ರದಲ್ಲಿ ಕೆಳಗಿನ ಹೆಸರನ್ನು ಹಾಗೆಯೇ ನಮೂದಿಸಿ. ಎರಡೂ ಮಾದರಿಗಳು ಒಂದೇ URL ಮತ್ತು ಒಂದೇ ವಿನಂತಿ ಸ್ವರೂಪವನ್ನು ಬಳಸುತ್ತವೆ ಹಾಗೂ ಪಠ್ಯ ಮತ್ತು ಚಿತ್ರಗಳನ್ನು ಇನ್‌ಪುಟ್‌ಗಳಾಗಿ ಸ್ವೀಕರಿಸುತ್ತವೆ.

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

ನಿಮ್ಮ ಖಾತೆಯಿಂದ ವಾಸ್ತವವಾಗಿ ಕರೆ ಮಾಡಬಹುದಾದ ಮಾದರಿಗಳಿಗೆ ಪ್ಲೇಗ್ರೌಂಡ್‌ನ ಮಾದರಿ ಪಟ್ಟಿ ಮತ್ತು GET /models ಪ್ರತಿಕ್ರಿಯೆಯೇ ಮಾನದಂಡ. ಸಂಪೂರ್ಣ ಮಾದರಿ ಪಟ್ಟಿ ಮತ್ತು ಪ್ರತಿ ಮಾದರಿಗೆ ಅನುಮತಿಸಲಾದ ಕರೆಗಳು ಮಾದರಿ ದಸ್ತಾವೇಜಿನಲ್ಲಿ, ನಿರೀಕ್ಷಿತ ಕಡಿತವಾಗುವ ಕ್ರೆಡಿಟ್‌ಗಳ ಪ್ರಮಾಣವು ಕನ್ಸೋಲ್‌ನ ಬಳಕೆ ಪರದೆಯಲ್ಲಿ ಲಭ್ಯವಿದೆ.

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

ಸಂದೇಶಗಳ ಸರಣಿ ಮತ್ತು ಮಾದರಿಯ ಹೆಸರನ್ನು ಪಡೆದು, ಮಾದರಿ ರಚಿಸಿದ ಸಂದೇಶಗಳನ್ನು choices ಸರಣಿಯಲ್ಲಿ ಸೇರಿಸಿ ಹಿಂತಿರುಗಿಸುತ್ತದೆ. ಸಂಪೂರ್ಣ ವಿಳಾಸ https://platform.clevi.net/api/v2/aiservice/openai/v1/chat/completions ಆಗಿದೆ. ವಿನಂತಿಯ ದೇಹವು application/json ಆಗಿರುತ್ತದೆ ಮತ್ತು ದೃಢೀಕರಣಕ್ಕಾಗಿ Authorization ಹೆಡರ್‌ನಲ್ಲಿ Bearer ಪೂರ್ವಪ್ರತ್ಯಯದೊಂದಿಗೆ ಕೀಲಿಯನ್ನು ಸೇರಿಸಲಾಗುತ್ತದೆ. X-API-Key ಹೆಡರ್ ಮೂಲಕವೂ ಕೀಲಿಯನ್ನು ಕಳುಹಿಸಬಹುದು; ಎರಡೂ ಹೆಡರ್‌ಗಳನ್ನು ನಿರ್ದಿಷ್ಟಪಡಿಸಿದರೆ, X-API-Key ಮೌಲ್ಯಕ್ಕೆ ಆದ್ಯತೆ ನೀಡಲಾಗುತ್ತದೆ.

curl https://platform.clevi.net/api/v2/aiservice/openai/v1/chat/completions \
  -H "Authorization: Bearer $CLEVI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "cip-5.5-im",
    "messages": [
      {"role": "user", "content": "CLEVI API를 한 문장으로 설명해 줘."}
    ]
  }'

import os
import requests

url = "https://platform.clevi.net/api/v2/aiservice/openai/v1/chat/completions"

response = requests.post(
    url,
    headers={"Authorization": f"Bearer {os.environ['CLEVI_API_KEY']}"},
    json={
        "model": "cip-5.5-im",
        "messages": [{"role": "user", "content": "CLEVI API를 한 문장으로 설명해 줘."}],
    },
    timeout=60,
)

print(response.json()["choices"][0]["message"]["content"])

const url =
  "https://platform.clevi.net/api/v2/aiservice/openai/v1/chat/completions";

const response = await fetch(url, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CLEVI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "cip-5.5-im",
    messages: [{ role: "user", content: "CLEVI API를 한 문장으로 설명해 줘." }],
  }),
});

const data = await response.json();
console.log(data.choices[0].message.content);

ಇದು ಪ್ರತಿಕ್ರಿಯೆಯ ಉದಾಹರಣೆಯಾಗಿದೆ. id, created, usage ಮೌಲ್ಯಗಳು ಪ್ರತಿ ವಿನಂತಿಗೆ ಬದಲಾಗುತ್ತವೆ.

{
  "id": "chatcmpl-3f0a9c72",
  "object": "chat.completion",
  "created": 1755500000,
  "model": "cip-5.5-im",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "CLEVI API는 주소 하나로 여러 모델을 호출하는 채팅 완료 API입니다."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 21,
    "completion_tokens": 19,
    "total_tokens": 40
  }
}

OpenAI SDK ಬಳಸಿ ಕರೆ ಮಾಡುವುದು

OpenAI SDKಯ base_url ಅನ್ನು https://platform.clevi.net/api/v2/aiservice/openai/v1 ಗೆ ಬದಲಿಸಿ ಮತ್ತು api_keyನಲ್ಲಿ CLEVI ಕೀಲಿಯನ್ನು ನಮೂದಿಸಿ. ಉಳಿದ ಕರೆ ಕೋಡ್ ಅನ್ನು ಹಾಗೆಯೇ ಇರಿಸಿ.

# 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/v2/aiservice/openai/v1",
)

completion = client.chat.completions.create(
    model="cip-5.5-mm",
    messages=[{"role": "user", "content": "CLEVI 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/v2/aiservice/openai/v1",
});

const completion = await client.chat.completions.create({
  model: "cip-5.5-mm",
  messages: [{ role: "user", content: "CLEVI API를 한 문장으로 설명해 줘." }],
});

console.log(completion.choices[0].message.content);

ಸ್ಟ್ರೀಮಿಂಗ್ ಮೂಲಕ ಸ್ವೀಕರಿಸುವುದು

ವಿನಂತಿಯ ಬಾಡಿಯಲ್ಲಿ stream ಅನ್ನು true ಎಂದು ಹೊಂದಿಸಿದರೆ, ಸರ್ವರ್ Server-Sent Events ಮೂಲಕ ಪ್ರತಿಕ್ರಿಯಿಸುತ್ತದೆ. ಮೊದಲ ತುಣುಕಿನೊಂದಿಗೆ Content-Type: text/event-stream, Cache-Control: no-cache, X-Accel-Buffering: no ಹೆಡರ್‌ಗಳು ಬರುತ್ತವೆ; ನಂತರದ ಪ್ರತಿಯೊಂದು ತುಣುಕಿನಲ್ಲೂ data: ಸಾಲಿನಲ್ಲಿ chat.completion.chunk ಆಬ್ಜೆಕ್ಟ್ ಇರುತ್ತದೆ. ಕೊನೆಯ ಸಾಲು data: [DONE] ಆಗಿರುತ್ತದೆ. ಕೆಳಗಿನ Python ಮತ್ತು TypeScript ಉದಾಹರಣೆಗಳು ಹಿಂದಿನ ವಿಭಾಗದಲ್ಲಿ ರಚಿಸಿದ client ಅನ್ನು ಹಾಗೆಯೇ ಬಳಸುತ್ತವೆ.

curl -N https://platform.clevi.net/api/v2/aiservice/openai/v1/chat/completions \
  -H "Authorization: Bearer $CLEVI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "cip-5.5-im",
    "messages": [{"role": "user", "content": "CLEVI API를 한 문장으로 설명해 줘."}],
    "stream": true
  }'

stream = client.chat.completions.create(
    model="cip-5.5-im",
    messages=[{"role": "user", "content": "CLEVI API를 한 문장으로 설명해 줘."}],
    stream=True,
)

for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="")

const stream = await client.chat.completions.create({
  model: "cip-5.5-im",
  messages: [{ role: "user", content: "CLEVI API를 한 문장으로 설명해 줘." }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

ತುಣುಕಿನ ಉದಾಹರಣೆ.

data: {"id":"chatcmpl-3f0a9c72","object":"chat.completion.chunk","model":"cip-5.5-im","choices":[{"index":0,"delta":{"content":"CLEVI"},"finish_reason":null}]}

data: {"id":"chatcmpl-3f0a9c72","object":"chat.completion.chunk","model":"cip-5.5-im","choices":[{"index":0,"delta":{"content":" API는"},"finish_reason":null}]}

data: {"id":"chatcmpl-3f0a9c72","object":"chat.completion.chunk","model":"cip-5.5-im","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

data: [DONE]

ಸ್ಟ್ರೀಮಿಂಗ್ ವೇಳೆ ದೋಷ ಸಂಭವಿಸಿದರೆ, ಅದೇ ದೋಷದ JSON data: ಎಂಬ ಒಂದು ಸಾಲಿನಲ್ಲಿ ಬರುತ್ತದೆ ಮತ್ತು HTTP ಸ್ಥಿತಿ ಕೋಡ್ ಕೂಡ ಬದಲಾಗುತ್ತದೆ.

ದೋಷ

ವಿಫಲವಾದ ವಿನಂತಿಗಳು HTTP ಸ್ಥಿತಿ ಕೋಡ್ ಮೂಲಕ ಕಾರಣವನ್ನು ತಿಳಿಸುತ್ತವೆ. ಅಪ್‌ಸ್ಟ್ರೀಮ್ 4xx·5xx ಅನ್ನು ಹಿಂತಿರುಗಿಸಿದರೆ, ಆ ಕೋಡ್ ಅನ್ನು ಹಾಗೆಯೇ ರವಾನಿಸಲಾಗುತ್ತದೆ. ಮೊದಲು ಕೆಳಗಿನ ಪಟ್ಟಿಯಲ್ಲಿನ ಪರಿಹಾರಗಳನ್ನು ಪರಿಶೀಲಿಸಿ; ಅದೇ ಕೋಡ್ ಪುನರಾವರ್ತನೆಯಾದರೆ, ವಿನಂತಿಯ ಸಮಯ, ಕಳುಹಿಸಿದ ಬಾಡಿ ಮತ್ತು X-Request-Id ಅನ್ನು ದಾಖಲಿಸಿ.

402 ಅನ್ನು ಹಿಂತಿರುಗಿಸಲಾಗುವುದಿಲ್ಲ. ಕ್ರೆಡಿಟ್ ಕೊರತೆ ಮತ್ತು ಬಳಕೆಯ ಮಿತಿ ಮೀರಿದ ಸಂದರ್ಭಗಳು 403 ಆಗಿ ಬರುತ್ತವೆ. ದೋಷದ ದೇಹವು ಕೆಳಗಿನ ಸ್ವರೂಪದಲ್ಲಿರುತ್ತದೆ ಮತ್ತು ಕಾರಣವು error.message ನಲ್ಲಿ ಒಳಗೊಂಡಿರುತ್ತದೆ.

{"error":{"message":"API key is required.","type":"invalid_request_error"}}

ವಿನಂತಿಯಲ್ಲಿ X-Request-Id ಹೆಡರ್ ಸೇರಿಸಿದರೆ, ಸಂಪರ್ಕಿಸುವಾಗ ಆ ಮೌಲ್ಯದ ಮೂಲಕ ಪತ್ತೆಹಚ್ಚಬಹುದು. ಕಳುಹಿಸದಿದ್ದರೆ, ಸರ್ವರ್ ಅದನ್ನು ನೀಡುತ್ತದೆ.

ಮುಂದಿನ ಹಂತಗಳು

ಮಾಡೆಲ್ ಹೆಸರುಗಳು ಮತ್ತು ನಿಯತಾಂಕಗಳನ್ನು ಬದಲಾಯಿಸುತ್ತಾ ಫಲಿತಾಂಶಗಳನ್ನು ಹೋಲಿಸುವುದು ಪ್ಲೇಗ್ರೌಂಡ್‌ನಲ್ಲಿ ಮಾಡಲಾಗುತ್ತದೆ. ಹೊಸ ಕೀಗಳನ್ನು ರಚಿಸುವುದು ಅಥವಾ ರದ್ದುಗೊಳಿಸುವುದು API ಕೀ ಪರದೆಯಲ್ಲಿ ಮಾಡಲಾಗುತ್ತದೆ. ಮುಂದೆ ಓದಬೇಕಾದ ದಾಖಲೆಗಳು ಇವು.

• ಮಾಡೆಲ್: ಸಂಪೂರ್ಣ ಮಾಡೆಲ್ ಪಟ್ಟಿ, ಪ್ರತಿ ಮಾಡೆಲ್‌ನ ವಿಶೇಷಣಗಳು ಮತ್ತು ಅನುಮತಿಸಲಾದ ಕರೆಗಳು
• API ಕರೆ ಮಾಡುವುದು: Anthropic ಹೊಂದಾಣಿಕೆಯ ಮಾರ್ಗ, ಎಂಬೆಡ್ಡಿಂಗ್ ಮತ್ತು ಧ್ವನಿ ಮಾರ್ಗಗಳು, ಸ್ಟ್ರೀಮಿಂಗ್ ನಿಯಮಗಳು
• ದೋಷ ಕೋಡ್‌ಗಳು: ಸಂಪೂರ್ಣ ಸ್ಥಿತಿ ಕೋಡ್ ಪಟ್ಟಿ ಮತ್ತು ಮರುಪ್ರಯತ್ನ ನಿಯಮಗಳು

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

API ಕೀಗಳನ್ನು ನಿರ್ವಹಿಸಿ