API कॉल करब

CLEVI गेटवे के कॉल पथ OpenAI संगत विनिर्देश आ Anthropic संगत विनिर्देश मे बाँटल अछि।
दुनू विनिर्देश एके API कुंजीक उपयोग करैत अछि, आ संवादात्मक तर्क मॉडल के कोनो सेहो विनिर्देश सँ कॉल कएल जा सकैत अछि।
एम्बेडिंग आ आवाज·वॉइस पथ केवल OpenAI संगत विनिर्देश मे उपलब्ध अछि,
Anthropic संगत विनिर्देश messages, count_tokens, models तीन पथ प्रदान करैत अछि।

स्ट्रीमिंग अनुरोध बॉडीक stream सँ चालू कएल जाइत अछि, आ एम्बेडिंग तथा किछु मॉडल·पथ एकरा समर्थन नहि करैत अछि। आवाज·वॉइस पथ ऑडियो केँ जकाँक तकेँ वापस करैत अछि आ आउटपुट केँ CleviDrive मे 3 दिन धरि सुरक्षित रखैत अछि, एहि तरहेँ ई सामान्य तर्क सँ भिन्न नियमक पालन करैत अछि।

मॉडल ID आ प्रत्येक मॉडल लेल अनुमत कॉल मॉडल पृष्ठ पर, आ प्रमाणीकरण हेडर तथा base URL API कुंजी सँ प्रमाणीकरण करू पृष्ठ पर उपलब्ध अछि।

पथ चयन

जे काज करबाक अछि आ जे SDK उपयोग कऽ रहल छी, तकर आधार पर पथ चुनू। तालिका मे देल पथ प्रत्येक विनिर्देशक base URL क बाद आबयवला सापेक्ष पथ अछि।

OpenAI संगत पथ

OpenAI संगत विनिर्देशक base URL https://platform.clevi.net/api/v2/aiservice/openai/v1 अछि। अनुरोध आ प्रतिक्रिया बॉडी OpenAI विनिर्देशकक पालन करैत अछि। नीचाँक तालिका तर्क आ मॉडल पथ केँ होस्ट-आधारित पूर्ण पथक रूप मे देखबैत अछि, जखन कि आवाज·वॉइस पथक विवरण आगाँक आवाज आ वॉइस पथ खंड मे देल गेल अछि।

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 तालिकामे देखू।

निम्नलिखित नियम केवल आवाज·बोइस पथपर लागू होइत अछि।