API deitzea

Orrialde honek autentifikazioa amaitu ondoren benetan deitzen diren bideak lantzen ditu.
OpenAI-rekin bateragarria den bidearen eta Anthropic-rekin bateragarria den bidearen zerrenda, eskaeraren gorputzean stream gaitzen denean erantzuna jasotzeko modua,
eta ahotsaren eta voice-en bideei soilik aplikatzen zaizkien arauen hurrenkera azaltzen ditu.
Modeloen IDak eta modelo bakoitzerako baimendutako deiak modeloen orrialdean daude; autentifikazio-goiburuak eta base URL-a, berriz, API gakoarekin autentifikatzea orrialdean.

Aukeratu bidea

Bi bateragarritasun-estandarrak API gako bera erabiltzen dute, eta elkarrizketa-eredu inferentzialetara bi estandarretatik dei daiteke. Aukeratu bidea egin nahi duzunaren eta erabiltzen duzun SDK-aren arabera.

OpenAI-rekin bateragarria den bidea

base URL-a https://platform.clevi.net/api/v2/aiservice/openai/v1 da, eta eskaeren eta erantzunen gorputzek OpenAI-ren estandarra jarraitzen dute. Beheko taulan inferentzia- eta modelo-bideak daude; ahotsaren eta voice-en bideak hurrengo atalean jaso dira bereizita.

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": "안녕하세요"}]
  }'

API gakoen pantailan emandako gakoa jarri sk-... lekuan, eta modeloaren orriko IDa model-en.

Gainerako bideak

Anthropic-ekin bateragarria den bidea

base URL https://platform.clevi.net/api/v2/aiservice/anthropic da, eta Anthropic SDK-k automatikoki gehitzen dio /v1 bideari. Eskaeren eta erantzunen gorputzek Anthropic Messages zehaztapena jarraitzen dute.

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": "안녕하세요"}]
  }'

Streaming-a (SSE)

Eskaeraren gorputzean "stream": true sartzen baduzu, zerbitzariak Server-Sent Events bidez erantzuten du. Bidea eta ereduaren arabera, honela funtzionatzen du.

Lehen zatiarekin batera, hiru goiburu hauek bidaltzen dira. Ondoren, zati bakoitzean event: lerroa (upstream-ak gertaeraren izena eman badu bakarrik) eta data: lerroa bidaltzen dira, eta berehala flush egiten da.

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

Anthropic-rekin bateragarria den bideko zatiek event lerroa eta data lerroa parekatzen dituzte.

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

chat/completions-eko zatiak data lerroen bidez iristen dira, eta amaieran data: [DONE] bere horretan helarazten da.

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

data: [DONE]

Ahotsaren eta voice bideen

TTS, STT eta Cosa ahotsak kudeatzeko bideak OpenAI-rekin bateragarria den zehaztapenaren barruan daude, eta ohiko inferentziaren aldean hainbat arau desberdin dituzte. Eredu bakoitzak zein bide onartzen duen modeloen orriko Cosa taulan dago.