API ಕರೆ ಮಾಡುವುದು

CLEVI ಗೇಟ್‌ವೇಯ ಕರೆ ಮಾರ್ಗಗಳನ್ನು OpenAI ಹೊಂದಾಣಿಕೆ ಮತ್ತು Anthropic ಹೊಂದಾಣಿಕೆ ವಿಶೇಷಣಗಳಾಗಿ ವಿಂಗಡಿಸಲಾಗಿದೆ.
ಎರಡೂ ವಿಶೇಷಣಗಳು ಒಂದೇ API ಕೀಯನ್ನು ಬಳಸುತ್ತವೆ ಮತ್ತು ಸಂವಾದಾತ್ಮಕ推reasoning ಮಾದರಿಗಳನ್ನು ಯಾವುದೇ ವಿಶೇಷಣದ ಮೂಲಕ ಕರೆ ಮಾಡಬಹುದು.
ಎಂಬೆಡಿಂಗ್ ಮತ್ತು ಧ್ವನಿ·ವಾಯ್ಸ್ ಮಾರ್ಗಗಳು OpenAI ಹೊಂದಾಣಿಕೆ ವಿಶೇಷಣದಲ್ಲಷ್ಟೇ ಇವೆ,
Anthropic ಹೊಂದಾಣಿಕೆ ವಿಶೇಷಣವು messages, count_tokens, models ಎಂಬ ಮೂರು ಮಾರ್ಗಗಳನ್ನು ಒದಗಿಸುತ್ತದೆ.

ವಿನಂತಿಯ ದೇಹದಲ್ಲಿರುವ stream ಮೂಲಕ ಸ್ಟ್ರೀಮಿಂಗ್ ಅನ್ನು ಸಕ್ರಿಯಗೊಳಿಸಲಾಗುತ್ತದೆ; ಎಂಬೆಡಿಂಗ್ ಮತ್ತು ಕೆಲವು ಮಾದರಿ·ಮಾರ್ಗಗಳು ಇದನ್ನು ಬೆಂಬಲಿಸುವುದಿಲ್ಲ. ಧ್ವನಿ·ವಾಯ್ಸ್ ಮಾರ್ಗಗಳು ಆಡಿಯೊವನ್ನು ಹಾಗೆಯೇ ಹಿಂತಿರುಗಿಸುವುದು ಮತ್ತು ಉತ್ಪನ್ನಗಳನ್ನು CleviDrive ನಲ್ಲಿ 3 ದಿನಗಳ ಕಾಲ ಸಂಗ್ರಹಿಸುವುದು ಸೇರಿದಂತೆ ಸಾಮಾನ್ಯ推reasoning ಗಿಂತ ಭಿನ್ನವಾದ ನಿಯಮಗಳನ್ನು ಅನುಸರಿಸುತ್ತವೆ.

ಮಾದರಿ ID ಮತ್ತು ಮಾದರಿಯನುಸಾರ ಅನುಮತಿಸಲಾದ ಕರೆಗಳು ಮಾದರಿ ಪುಟದಲ್ಲಿವೆ; ದೃಢೀಕರಣ ಹೆಡರ್ ಮತ್ತು base URL ಗಳು API ಕೀಯಿಂದ ದೃಢೀಕರಿಸುವುದು ಪುಟದಲ್ಲಿವೆ.

ಮಾರ್ಗ ಆಯ್ಕೆ

ನೀವು ಮಾಡಲು ಉದ್ದೇಶಿಸಿರುವ ಕೆಲಸ ಮತ್ತು ಬಳಸುತ್ತಿರುವ SDK ಆಧರಿಸಿ ಮಾರ್ಗವನ್ನು ಆಯ್ಕೆಮಾಡಿ. ಕೋಷ್ಟಕದಲ್ಲಿನ ಮಾರ್ಗಗಳು ಪ್ರತಿ ವಿಶೇಷಣದ base URL ನಂತರ ಬರುವ ಸಂಬಂಧಿತ ಮಾರ್ಗಗಳಾಗಿವೆ.

OpenAI ಹೊಂದಾಣಿಕೆಯ ಮಾರ್ಗ

OpenAI ಹೊಂದಾಣಿಕೆ ವಿಶೇಷಣದ base URL https://platform.clevi.net/api/v2/aiservice/openai/v1 ಆಗಿದೆ. ವಿನಂತಿ ಮತ್ತು ಪ್ರತಿಕ್ರಿಯೆಯ ದೇಹಗಳು OpenAI ವಿಶೇಷಣವನ್ನು ಅನುಸರಿಸುತ್ತವೆ. ಕೆಳಗಿನ ಕೋಷ್ಟಕವು推reasoning ಮತ್ತು ಮಾದರಿ ಮಾರ್ಗಗಳನ್ನು ಹೋಸ್ಟ್ ಆಧಾರಿತ ಸಂಪೂರ್ಣ ಮಾರ್ಗಗಳಾಗಿ ಸೂಚಿಸುತ್ತದೆ; ಧ್ವನಿ·ವಾಯ್ಸ್ ಮಾರ್ಗಗಳನ್ನು ಮುಂದಿನ ಧ್ವನಿ ಮತ್ತು ವಾಯ್ಸ್ ಮಾರ್ಗಗಳ ವಿಭಾಗದಲ್ಲಿ ವಿವರಿಸಲಾಗಿದೆ.

chat/completions ಗೆ ಕರೆ ಮಾಡುವ ಕನಿಷ್ಠ ಉದಾಹರಣೆಯಾಗಿದೆ. sk-... ಸ್ಥಾನದಲ್ಲಿ API ಕೀ ಪರದೆಯಿಂದ ನೀಡಲಾದ ಕೀಯನ್ನು ಮತ್ತು model ನಲ್ಲಿ ಮಾದರಿ ಪುಟದಲ್ಲಿರುವ ID ಅನ್ನು ನಮೂದಿಸಿ.

curl https://platform.clevi.net/api/v2/aiservice/openai/v1/chat/completions \
  -H "X-API-Key: sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "cip-5.5-im",
    "messages": [{"role": "user", "content": "안녕하세요"}]
  }'

ಇತರ ಮಾರ್ಗಗಳು

ಕೆಳಗಿನ ಮಾರ್ಗಗಳು ಡಯಾಗ್ನೋಸ್ಟಿಕ್ಸ್, ಲೆಗಸಿ ಹೊಂದಾಣಿಕೆ ಮತ್ತು ರಿಲೇ ಉದ್ದೇಶಗಳಿಗಾಗಿ ಬಳಸಲಾಗುತ್ತವೆ.

요청과 응답 필드 전체는 OpenAPI 3.0 문서 https://platform.clevi.net/api/v2/console/openapi/cloud-inference-v1 에서 확인할 수 있습니다. 경로 목록은 이 문서에서 생성되며, 문서는 콘솔에 로그인한 세션으로만 열립니다. 같은 문서로 클라이언트를 생성할 수 있습니다.

Anthropic 호환 경로

Anthropic 호환 규격의 base URL은 https://platform.clevi.net/api/v2/aiservice/anthropic 이며, Anthropic SDK가 요청 경로에 /v1을 직접 추가합니다. 요청과 응답 본문은 Anthropic Messages 규격을 따릅니다.

messages를 호출하는 최소 예제입니다.

curl https://platform.clevi.net/api/v2/aiservice/anthropic/v1/messages \
  -H "X-API-Key: sk-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "cip-5.5-im",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "안녕하세요"}]
  }'

anthropic-version ಹೆಡರ್ ಅನ್ನು ಬಿಟ್ಟರೆ, ಅದನ್ನು 2023-06-01 ಎಂದು ಪರಿಗಣಿಸಲಾಗುತ್ತದೆ. ಗೇಟ್‌ವೇ anthropic-version ಮತ್ತು anthropic-beta ಹೆಡರ್‌ಗಳನ್ನು ಹಾಗೆಯೇ ಫಾರ್ವರ್ಡ್ ಮಾಡುತ್ತದೆ.

ಸ್ಟ್ರೀಮಿಂಗ್ (SSE)

ವಿನಂತಿಯ ಬಾಡಿಯಲ್ಲಿ stream ಅನ್ನು true ಎಂದು ಹೊಂದಿಸಿದರೆ, ಸರ್ವರ್ Server-Sent Events ಮೂಲಕ ಪ್ರತಿಕ್ರಿಯಿಸುತ್ತದೆ. ಬೆಂಬಲವು ಮಾರ್ಗ ಮತ್ತು ಮಾದರಿಯನ್ನು ಅವಲಂಬಿಸಿ ಈ ಕೆಳಗಿನಂತೆ ಬದಲಾಗುತ್ತದೆ.

ಮೊದಲ ಚಂಕ್‌ನೊಂದಿಗೆ ಕೆಳಗಿನ ಮೂರು ಹೆಡರ್‌ಗಳನ್ನು ಕಳುಹಿಸಲಾಗುತ್ತದೆ. ನಂತರ ಪ್ರತಿ ಚಂಕ್‌ಗೆ data: ಸಾಲನ್ನು ಕಳುಹಿಸಿ ತಕ್ಷಣ flush ಮಾಡಲಾಗುತ್ತದೆ ಮತ್ತು ಅಪ್‌ಸ್ಟ್ರೀಮ್ ಈವೆಂಟ್ ಹೆಸರನ್ನು ಒದಗಿಸಿದಾಗ ಮಾತ್ರ event: ಸಾಲನ್ನು ಜೊತೆಯಲ್ಲಿ ಕಳುಹಿಸಲಾಗುತ್ತದೆ.

• Content-Type: text/event-stream
• Cache-Control: no-cache
• X-Accel-Buffering: no

Anthropic ಹೊಂದಾಣಿಕೆಯ ಮಾರ್ಗದ ಚಂಕ್‌ಗಳಲ್ಲಿ event ಸಾಲು ಮತ್ತು data ಸಾಲು ಜೋಡಿಯಾಗಿರುತ್ತವೆ.

event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"안"}}

chat/completions ನ ಚಂಕ್‌ಗಳು data ಸಾಲಿನ ರೂಪದಲ್ಲಿ ಬರುತ್ತವೆ ಮತ್ತು ಕೊನೆಯಲ್ಲಿ data: [DONE] ಅನ್ನು ಹಾಗೆಯೇ ಫಾರ್ವರ್ಡ್ ಮಾಡಲಾಗುತ್ತದೆ.

data: {"id":"chatcmpl-...","object":"chat.completion.chunk","choices":[...]}

data: [DONE]

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

ಧ್ವನಿ ಮತ್ತು ವಾಯ್ಸ್ ಮಾರ್ಗಗಳು

TTS·STT ಮತ್ತು Cosa ವಾಯ್ಸ್ ನಿರ್ವಹಣಾ ಮಾರ್ಗಗಳು OpenAI ಹೊಂದಾಣಿಕೆಯ ಸ್ಪೆಸಿಫಿಕೇಶನ್‌ನಲ್ಲಿವೆ ಮತ್ತು ಸಾಮಾನ್ಯ ಇನ್‌ಫರೆನ್ಸ್‌ಗಿಂತ ಕೆಲವು ವಿಭಿನ್ನ ನಿಯಮಗಳು ಅನ್ವಯಿಸುತ್ತವೆ. ಯಾವ ಮಾದರಿ ಯಾವ ಮಾರ್ಗವನ್ನು ಅನುಮತಿಸುತ್ತದೆ ಎಂಬುದನ್ನು ಮಾದರಿ ಪುಟದ Cosa ಪಟ್ಟಿಯಲ್ಲಿ ಪರಿಶೀಲಿಸಿ.

ಈ ನಿಯಮಗಳು ಧ್ವನಿ ಮಾರ್ಗಗಳಿಗೆ ಮಾತ್ರ ಅನ್ವಯಿಸುತ್ತವೆ.