API çağrısı yapma

CLEVI ağ geçidinin çağrı yolları, OpenAI uyumlu ve Anthropic uyumlu spesifikasyonlara ayrılır.
Her iki spesifikasyon da aynı API anahtarını kullanır ve konuşmalı akıl yürütme modelleri her iki spesifikasyon üzerinden de çağrılabilir.
Gömme ve ses·voice yolları yalnızca OpenAI uyumlu spesifikasyonda bulunur;
Anthropic uyumlu spesifikasyon ise messages, count_tokens ve models olmak üzere üç yol sağlar.

Akış, istek gövdesindeki stream ile etkinleştirilir; gömme ve bazı modeller·yollar tarafından desteklenmez. Ses·voice yolları, sesi olduğu gibi döndürme ve çıktıları CleviDrive'da 3 gün boyunca saklama gibi genel akıl yürütmeden farklı kurallara uyar.

Model kimlikleri ve modele göre izin verilen çağrılar model sayfasında, kimlik doğrulama üst bilgileri ve base URL ise API anahtarıyla kimlik doğrulama sayfasında yer alır.

Yol seçimi

Yapmak istediğiniz işe ve kullandığınız SDK'ya göre bir yol seçin. Tablodaki yollar, her spesifikasyonun base URL'sinin sonuna eklenen göreli yollardır.

OpenAI uyumlu yollar

OpenAI uyumlu spesifikasyonun base URL'si https://platform.clevi.net/api/v2/aiservice/openai/v1 adresidir. İstek ve yanıt gövdeleri OpenAI spesifikasyonunu izler. Aşağıdaki tabloda akıl yürütme ve model yolları ana bilgisayar temelinde tam yollar olarak gösterilir; ses·voice yolları ise ilerideki ses ve voice yolları bölümünde düzenlenmiştir.

chat/completions çağrısı yapan en basit örnektir. sk-... yerine API anahtarı ekranından aldığınız anahtarı, model yerine model sayfasındaki kimliği girin.

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

Diğer yollar

Aşağıdaki yollar tanılama, eski sürüm uyumluluğu ve aktarım amaçlıdır.

İstek ve yanıt alanlarının tamamını OpenAPI 3.0 belgesinde https://platform.clevi.net/api/v2/console/openapi/cloud-inference-v1 bulabilirsiniz. Yol listesi bu belgeden oluşturulur ve belge yalnızca konsolda oturum açmış bir oturumla açılabilir. Aynı belgeyi kullanarak istemci oluşturabilirsiniz.

Anthropic uyumlu yollar

Anthropic uyumlu spesifikasyonun base URL'si https://platform.clevi.net/api/v2/aiservice/anthropic olup Anthropic SDK'sı istek yoluna /v1'i doğrudan ekler. İstek ve yanıt gövdeleri Anthropic Messages spesifikasyonunu izler.

messages çağrısı için minimum örnektir.

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 başlığı atlanırsa 2023-06-01 olarak işlenir. Ağ geçidi, anthropic-version ve anthropic-beta başlıklarını olduğu gibi iletir.

Akış (SSE)

İstek gövdesinde stream true olarak ayarlanırsa sunucu, Server-Sent Events ile yanıt verir. Destek durumu yol ve modele göre aşağıdaki gibi değişir.

İlk parçayla birlikte aşağıdaki üç başlığı gönderir. Daha sonra her parçada data: satırını gönderip hemen flush eder ve yalnızca üst akış bir etkinlik adı sağladığında event: satırını da gönderir.

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

Anthropic uyumlu yolun parçalarında event satırı ile data satırı eşleşir.

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

chat/completions parçaları data satırı olarak gelir ve son olarak data: [DONE] olduğu gibi iletilir.

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

data: [DONE]

Akış sırasında bir hata oluşursa normal çağrıyla aynı hata JSON'ı data: tek satır olarak iletilir ve HTTP durum kodu da değiştirilir.

Ses ve voice yolları

TTS·STT ve Cosa voice yönetimi yolları OpenAI uyumlu spesifikasyona dahildir ve genel çıkarımdan farklı birkaç kural uygulanır. Hangi modelin hangi yola izin verdiğini model sayfasındaki Cosa tablosundan kontrol edin.

Aşağıdaki kurallar yalnızca ses ve voice yollarına uygulanır.