API deitzea

CLEVI atebidearen deitze-bideak OpenAI-rekin bateragarria den araudian eta Anthropic-ekin bateragarria den araudian banatzen dira.
Bi araudiek API-gako bera erabiltzen dute, eta elkarrizketa bidezko inferentzia-ereduei bi araudietako edozein erabiliz dei dakieke.
Txertatze- eta audio/ahots-bideak OpenAI-rekin bateragarria den araudian soilik daude,
eta Anthropic-ekin bateragarria den araudiak hiru bide eskaintzen ditu: messages, count_tokens eta models.

Streaming-a eskaeraren gorputzeko stream bidez aktibatzen da, eta ez dute txertatzeek eta eredu eta bide batzuek onartzen. Audio/ahots-bideek audioa bere horretan itzultzen dute, eta beste arau batzuk dituzte inferentzia arruntaren aldean, adibidez, emaitzak CleviDrive-n 3 egunez gordetzea.

Modeloen IDak eta eredu bakoitzak baimentzen dituen deiak ereduen orrian daude; autentifikazio-goiburuak eta base URL-a, berriz, API-gakoarekin autentifikatzeko orrian.

Bidea hautatzea

Hautatu bidea egin nahi duzunaren eta erabiltzen ari zaren SDK-aren arabera. Taulako bideak araudi bakoitzaren base URL-aren ondoren doazen bide erlatiboak dira.

OpenAI-rekin bateragarria den bidea

OpenAI-rekin bateragarria den araudiaren base URL-a https://platform.clevi.net/api/v2/aiservice/openai/v1 da. Eskaera- eta erantzun-gorputzek OpenAI araudia jarraitzen dute. Beheko taulan inferentzia- eta eredu-bideak ostalariaren araberako bide oso gisa adierazten dira; audio- eta ahots-bideak, berriz, aurrerago azaltzen dira, audio- eta ahots-bideen atalean.

chat/completions deitzeko gutxieneko adibidea da. sk-... lekuan, API-gakoen pantailan igorritako gakoa jarri; model eremuan, berriz, modeloaren orrialdeko IDa.

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

Gainerako bideak

Ondorengo bideak diagnostikorako, bateragarritasun legaturako eta errelebo-lanetarako dira.

Eskaera- eta erantzun-eremu guztiak OpenAPI 3.0 dokumentuan https://platform.clevi.net/api/v2/console/openapi/cloud-inference-v1 kontsulta daitezke. Bideen zerrenda dokumentu honetan sortzen da, eta dokumentua kontsolan saioa hasita duen saio baten bidez soilik ireki daiteke. Dokumentu bera erabil dezakezu bezero bat sortzeko.

Anthropic-ekin bateragarriak diren bideak

Anthropic-ekin bateragarria den zehaztapenaren oinarrizko URLa https://platform.clevi.net/api/v2/aiservice/anthropic da, eta Anthropic SDK-k /v1 gehitzen dio zuzenean eskaeraren bideari. Eskaera- eta erantzun-gorputzek Anthropic Messages zehaztapena betetzen dute.

messages deitzeko gutxieneko adibidea da.

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 goiburua baztertzen baduzu, 2023-06-01 gisa tratatuko da. Gateway-ak anthropic-version eta anthropic-beta goiburuak bere horretan igarotzen ditu.

Streaming-a (SSE)

Eskaeraren gorputzean stream true gisa ezartzen baduzu, zerbitzariak Server-Sent Events bidez erantzuten du. Onartzen den ala ez bidearen eta ereduaren arabera aldatzen da, honela.

Lehen chunk-arekin batera, hiru goiburu hauek bidaltzen ditu. Aurrerantzean, chunk bakoitzean data: lerroa bidali eta berehala flush egiten du; upstream-ak gertaeraren izena ematen badu soilik bidaltzen du event: lerroa ere.

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

Anthropic bateragarriaren bideko chunk-ek event lerroa eta data lerroa binaka dituzte.

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

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

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

data: [DONE]

Streaming-ean zehar errore bat gertatzen bada, ohiko deietan bezala, errorearen JSONa data: lerro bakar baten bidez bidaltzen da, eta HTTP egoera-kodea ere aldatzen da.

Ahots- eta voice-bideak

TTS·STT eta Cosa voice kudeatzeko bideak OpenAI bateragarriak dira, eta ohiko inferentziaren bestelako arau batzuk aplikatzen dira. Eredu bakoitzak zein bide onartzen duen jakiteko, begiratu modeloaren orrialdeko Cosa taula.

Hurrengo arauak ahotsen bideei soilik aplikatzen zaizkie.