Character AI API Entegrasyon Rehberi

Neden Character AI'yi Bir API ile Değiştirmelisiniz?

Character AI kullanışlıdır, ancak karakterlerinizi kendi ekosistemine hapseder. Tam bağlam penceresini kaydedemez, model parametrelerini ince ayarlayamaz veya verilerinizin özel kalmasını sağlayamazsınız. API çözümü gibi uncutly AI özensürümlü bir LLM'a doğrudan erişim sağlar. İstemleri, sıcaklığı ve durdurma dizilerini siz kontrol edersiniz. Bu, karakterlerin tam olarak istediğiniz gibi davranması anlamına gelir.

Tescilli platformlar genellikle tamamen yasal olan içeriği reddeder. Hassas bir anahtar kelime nedeniyle bir hikayeyi kesebilirler. Bir uncensored sohbet botu API'si ile neyin izin verileceğine siz karar verirsiniz. Metin üretimi için tek, güvenilir bir uç nokta alırsınız. Bu güvenilirlik, tutarlı karakter davranışına bağlı bir ürün oluştururken kritiktir. Bir platformun keyfi denetim ekibinin elinde değilsiniz.

Adım 1: API Anahtarınızı Alın

Sağlayıcının kontrol panelinde bir hesap oluşturmaya başlayın. Google ile oturum açabilir veya basit bir e-posta ve şifre kullanabilirsiniz. Telefon numarası gerekmez. Kayıt olduktan sonra API anahtarı bölümüne gidin. Sistem hemen benzersiz bir anahtar oluşturur. Bu anahtarı kopyalayın ve ortam değişkenlerinizde güvenli bir şekilde saklayın.

API'ye yapılan her istek, başlıkta bu anahtarı içermelidir. Anahtar eksikse veya geçersizse sunucu 401 hatası döndürür. Entegrasyonu test etmek için para harcamadan önce küçük bir deneme kredisi alırsınız. Bu deneme kredisi yedi gün sürer. Kurulumunuzun doğru çalıştığını doğrulamanın iyi bir yoludur.

Adım 2: Base URL'yi Yapılandırın

Çoğu modern LLM istemcisi OpenAI uyumlu bir arayüz bekler. SDK'nızı doğru temel URL'ye yönlendirmeniz gerekir. Bu hizmet için uç nokta https://api.uncutlyai.com/v1. Bu URL yapısı standart OpenAI API'yi yansıtır. Bu, mevcut kütüphaneleri büyük kod değişiklikleri olmadan kullanabileceğiniz anlamına gelir.

Yapılandırma nesnenize bu temel URL'yi ekleyin. Ayrıca API anahtarını yetkilendirme başlığında ayarlayın. Kullanacağınız model kimliği basitçe "uncensored" olacaktır. Bu model, daha az reddetme ve daha iyi yaratıcı özgürlük için ayarlanmıştır. Uzun bağlamları iyi yönetir, 100,000 token'a kadar. Bu uzunluk, derin karakter geçmişlerine olanak tanır.

Adım 3: İlk Sohbet Tamamlama İsteğinizi Gönderin

Şu adrese bir istek oluşturun: /v1/chat/completions endpoint. Gövde bir mesaj listesi içermelidir. Her mesajın "system", "user" veya "assistant" gibi bir rolü vardır. Sistem mesajı karakterin kişiliğini tanımlar. Kullanıcı mesajları konuşmayı yönlendirir.

İstek nasıl yapılandırılır:

Copycurl https://api.uncutlyai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Show me the API endpoint for text generation"}]
  }'

Modelin yanıt vermesini görmek için bu isteği gönderin. Sunucu tokenları işler ve metin tamamlaması döndürür. Şu parametreleri ayarlayabilirsiniz temperature yaratıcılığı kontrol etmek için. Daha yüksek değerler karakteri daha öngörülemez kılar. Daha düşük değerler onu daha tutarlı hale getirir. Bu esneklik, sesi ince ayarlamanıza olanak tanır.

Adım 4: Akış Yanıtlarını Yönetin

Tüm yanıtın sona kadar beklemesi sohbet uygulamalarını yavaş hissettirir. Akış (streaming) bu sorunu çözer. Şunu ayarlayın: stream parametresini true olarak ayarlayın. Sunucu, bir dizi Sunucu Tarafından Gönderilen Olay (SSE) döndürür. Her olay küçük bir metin parçası içerir.

İstemci kodunuz bu chunkları ayrıştırmalı ve gerçek zamanlı olarak görüntülemelidir. Bu, bir insanın yazıyormuş izlenimini yaratır. Kullanıcı deneyimini önemli ölçüde iyileştirir. Son chunk genellikle token kullanım istatistiklerini içerir. Bu verileri maliyetlerinizi doğru bir şekilde izlemek için kullanabilirsiniz.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.uncutlyai.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)

Akış işleyicinizin ağ hatalarını yakaladığından emin olun. Kopuk bir akış, kullanıcı arayüzünü yükleme durumunda bırakabilir. Akış bittiğinde veya başarısız olduğunda bağlantıyı her zaman kapatın.

Adım 5: Tokenleri ve Maliyetleri Yönet

Token maliyetlerini anlamak bütçeleme için esastır. Her milyon token başına ödeme yaparsınız. Girdi tokenları milyon başına $0.15'e mal olur. Çıktı tokenları milyon başına $0.50'ye mal olur. Sadece işlenen tokenlar için ödeme yaparsınız. Hatalar size ücret yansıtmaz. Reddettiğiniz yanıtlar için de ücret ödemezsiniz.

Bu ön ödemeli model şeffaftır. Kripto para ile yükleme yaparsınız. Minimum yükleme tutarı $20'dir. Bir seferde $500 ekleyebilirsiniz. Aylık abonelikler yoktur. Kredi hiçbir zaman sona ermez. Bu öngörülebilirlik, geliştirme maliyetlerinizi planlamanıza yardımcı olur. Her konuşmanın ne kadar maliyetle gerçekleşeceğini tam olarak bilirsiniz.

Adım 6: Fonksiyon Çağrısını Uygula

Gelişmiş karakterler genellikle harici araçlarla etkileşim kurmalıdır. Fonksiyon çağırma, modelin yapılandırılmış veri döndürmesine olanak tanır. Fonksiyon için bir şema tanımlarsınız. Model, konuşmaya dayanarak ne zaman çağıracak olduğuna karar verir.

Örneğin, bir karakterin hava durumunu kontrol etmesi gerekebilir. İşlev tanımını isteğe gönderirsiniz. Model, işlev adını ve argümanları içeren bir JSON nesnesiyle yanıt verir. Kodunuz işlevi çalıştırır ve sonucu modele geri gönderir.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.uncutlyai.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);

Bu döngü, model nihai metin yanıtını oluşturana kadar devam eder. Dinamik, etkileşimli hikayeler sağlar. Statik metin çıktılarıyla sınırlı değilsiniz. Model, uygulamanızda olayları tetikleyebilir.

Adım 7: Hata Yönetimi ve Limitler

API'lerin sınırları vardır. Dakikada 300 istek gönderebilirsiniz. Aynı anda yalnızca sekiz istek aktif olabilir. İstek gövdesi 8 MB'ın altında olmalıdır. Bu sınırları aşarsanız 429 hatası alırsınız. Yeniden deneme mantığınıza üstel geri çekilme uygulayın.

Ağ hatalarını zarifçe yönetin. Sunucu 500 hatası döndürürse bekleyin ve yeniden deneyin. Modelin her zaman başarılı olacağını varsaymayın. Bu hataları günlükleyerek desenleri belirleyin. Sık zaman aşımıları, zaman aşımı ayarlarınızı ayarlamanız gerektiğini gösterebilir.

Adım 8: Entegrasyonunuzu Ölçeklendir

Kullanıcı tabanınız büyüdükçe, API kullanımınız artacaktır. Token tüketiminizi yakından izleyin. Maliyetleri takip etmek için akış yanıtlarından gelen kullanım verilerini kullanın. Yüksek maliyetler fark ederseniz, promptlarınızı optimize etmeyi düşünün. Daha kısa sistem promptları, girdi tokenlarını azaltabilir.

Sık yanıtları önbelleğe almayı düşünün. Birden fazla kullanıcı aynı soruyu sorarsa, önbelleğe alınmış sonucu sunun. Bu, API çağrılarını azaltır ve tasarruf sağlar. Kendi sunucunuzda hız sınırlama uygulayabilirsiniz. Bu, tek bir kullanıcının tüm kredinizi tüketmesini engeller. İyi ölçeklendirilmiş bir entegrasyon hızlı ve güvenilir kalır.