Hızlı Başlangıç: API'yi entegre edin

Önkoşullar: SDK Kurulumu

Bağlantıyı yapılandırmadan önce tercih ettiğiniz dil için resmi istemci kütüphanesini yükleyin. Kütüphane JSON seri hale getirme, yeniden denemeler ve akış protokollerini otomatik olarak yönetir.

Python için paketi pip ile yükleyin. Node.js için npm veya yarn kullanarak bağımlılığı projenize ekleyin.

Fonksiyon çağırma ve JSON modu gibi tüm özellikleri desteklemek için SDK'nın güncel bir sürümünü kullandığınızdan emin olun.

Yapılandırma: Temel URL & Anahtar

SDK istemcinizi özel temel URL'mize işaretleyin ve kayıt sırasında edindiğiniz API anahtarını sağlayın.

Temel URL HTTPS://api.claudellmapi.com/v1'dir. Bu, tüm isteklerin varsayılan sağlayıcı yerine sansürsüz model sunucularımıza gitmesini sağlar.

API anahtarını bir ortam değişkeni olarak ayarlayın veya doğrudan istemci yapıcısına iletin. Ek başlıklara gerek yoktur.

İlk İsteğinizi Gönderme

Bağlantıyı ve yanıt kalitesini doğrulamak için basit bir sohbet tamamlama isteği gönderin. Kısıtlamasız modele erişmek için model kimliğini 'uncensored' olarak kullanın.

İstek yapısı standart OpenAI formatını yansıtır, bu da mevcut entegrasyonları değiştirmeyi kolaylaştırır.

Modelin prompt'unuza verdiği yanıtı içeren bir metin yanıtı bekleyin.

Akış Yanıtlarını İşleme

Uzun çıktılar için algılanan gecikmeyi azaltmak amacıyla oluşturulurken tokenlar almak için akış özelliğini etkinleştirin.

İsteğinizde stream parametresini true olarak ayarlayın. SDK, mevcut olduğunda metin parçalarını üretecektir.

Bu, model hâlâ düşünürken anında geri bildirim bekleyen sohbet arayüzleri için idealdir.

İşlev Çağırma Uygulama

Modelin düz metin yerine yapılandırılmış veriler döndürmesini sağlamak için istek gövnenize araçlar tanımlayın.

İşlev şemasını belirtin ve tool_choice parametresini 'auto' veya belirli bir işlev adına ayarlayın.

Model, kodunuzda yürütebileceğiniz bir fonksiyon çağırma nesnesi ile yanıt verecektir. Bu, uncensored modelimizle sorunsuz çalışır.

Hata Yönetimi & Sınırlamalar

Yaygın HTTP hatalarını zarif bir şekilde yöneterek sorunsuz bir kullanıcı deneyimi sağlayın. 401 durumu geçersiz veya eksik bir API anahtarı olduğunu gösterir. 402 durumu ön ödemeli kredinizin tükendiği anlamına gelir. 429 durumu, dakikada 300 isteğe kadar olan hız sınırını aştığınızı işaret eder.

Bağlam pencereniz istem ve tamamlama birlikte 8 MB gövde sınırı aşan isteklerin de başarısız olacağı şekilde 100.000 token'dır.

cURL

Copycurl https://api.claudellmapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What are the current rate limits for large context windows"}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.claudellmapi.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.claudellmapi.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Akış

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)