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 நிலைக் குறியீடும் மாற்றப்படும்.

குரல் மற்றும் voice பாதைகள்

TTS·STT மற்றும் Cosa குரல் மேலாண்மை பாதைகள் OpenAI இணக்கமான தரநிலையைப் பின்பற்றுகின்றன; பொதுவான ஊகத்திலிருந்து மாறுபடும் சில விதிகள் பயன்படுத்தப்படுகின்றன. எந்த மாதிரி எந்தப் பாதையை அனுமதிக்கிறது என்பதை மாதிரிப் பக்கத்தின் Cosa அட்டவணையில் பார்க்கவும்.

பின்வரும் விதிகள் குரல் மற்றும் குரல் பாதைகளுக்கு மட்டுமே பொருந்தும்.