Character AI API: İstemcinizi üç satırda değiştirin

Önkoşullar

Kod yazmadan önce characteraiapi.com üzerinde aktif bir hesabınız olmalıdır. API anahtarı al sayfasını ziyaret edin ve yalnızca e-posta ve şifre ile kaydolun. Başlamak için kredi kartı gerekmez; yeni hesaplar 7 gün geçerli $0.50 deneme kredisi alır. Kayıt olduktan sonra API anahtarınız hemen görüntülenir. Bu anahtarı güvenli tutun, çünkü uç noktaya yapılan tüm istekleri doğrular. Geliştirme ortamınızda desteklenen bir dil SDK'sının yüklü olması gerekir. character ai api uç noktası standart OpenAI parametrelerini kabul eder; bu nedenle mevcut herhangi bir OpenAI uyumlu istemci, minimum değişikliklerle çalışabilir.

SDK'yı Yükleyin

Python projeleri için resmi OpenAI paketini pip kullanarak yükleyin. Bu kütüphane JSON serileştirmesini ve HTTP isteklerini otomatik olarak yönetir. Node.js uygulamaları için npm ile openai paketini ekleyin. Her iki kütüphane de bu kılavuzda daha sonra açıklanan akış ve araç çağırma özelliklerini destekler. Gerçek zamanlı token akışı için Sunucu Tarafı Olayları'nı (SSE) destekleyecek kadar güncel bir SDK sürümü kullandığınızdan emin olun. Bir SDK yerine özel bir HTTP istemcisi kullanıyorsanız, OpenAI API spesifikasyonuna göre JSON yükünü ve SSE akış ayrıştırmayı manuel olarak yönetmeniz gerekir.

Kimlik Doğrulama

Her API isteğinde Authorization başlığına API anahtarınızı eklemelisiniz. Bearer YOUR_API_KEY formatını kullanın. Tüm istekler için temel URL https://api.characteraiapi.com/v1 şeklindedir. Bir SDK kullanırken, base_url yapılandırmasını bu değere ayarlayın ve anahtarınızı api_key parametresi aracılığıyla sağlayın. Anahtarınızı kaybederseniz veya sızdırılmasından şüphelenirseniz, panelden anahtarınızı yeniden oluşturabilirsiniz; eski anahtar hemen iptal edilir. Hesap başına yalnızca bir aktif anahtar izine izin verilir. Standart OpenAI uç noktasına yapılan isteklerin 404 veya 401 hatası ile başarısız olacağını unutmayın, bu nedenle doğru temel URL'yi kullandığınızdan emin olun.

Temel Sohbet Tamamlama

Temel işlevsellik /v1/chat/completions uç noktası aracılığıyla sunulur. Model adı olarak uncensored ve mesaj geçmişinizle bir POST isteği gönderin. Model, yasal yetişkin içerik için standart içerik filtreleri uygulamadan metin çıktısı verir. Aşağıda basit bir metin tamamlama isteğini gösteren bir curl örneği bulunmaktadır.

Copycurl https://api.characteraiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Bu istek, oluşturulan metni içeren bir tamamlama nesnesi döndürür. Rastgeleliği kontrol etmek için temperature veya çıktı uzunluğunu sınırlamak için max_tokens gibi parametreleri ayarlayabilirsiniz. Model, 100.000 token'lık bir bağlam penceresi destekler; bu da tek bir istekte kapsamlı bir sohbet geçmişinin veya uzun belgelerin işlenmesine olanak tanır.

Akışlı Yanıtlar

Daha iyi bir kullanıcı deneyimi için isteğinizde stream: true ayarlayarak akışı etkinleştirin. API, kısmi token parçaları oluşturuldukça bunları içeren Sunucu Tarafı Olayları'nı (SSE) döndürür. Bu, chatbot uygulamaları için algılanan gecikmeyi azaltır. Son olayda kullanım istatistiklerini almak istiyorsanız stream_options parametresini kullanın. Akış, metni kelime kelime görüntüleyerek içg tiêneyi artıran gerçek zamanlı karakter rol yapma için özellikle yararlıdır. İstemci kodunuzun her parçayı sırayla ayrıştırmak için SSE formatını doğru şekilde işlediğinden emin olun.

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)

Hız Limitleri ve Hatalar

API, anahtar başına dakikada 300 isteklik bir limite tabidir. Bu limiti aşarsanız, 429 Too Many Requests hatı alırsınız. İstek gövdeleri 8 MB ile sınırlıdır. Yaygın hatalar arasında geçersiz veya eksik anahtar için 401 ve ön ödemeli krediniz tükendiğinde 402 yer alır. Kripto para (USDT veya USDC) kullanarak 10 $'dan başlayan bakiye yükleyebilirsiniz; daha büyük para yatırmaları için bonus kredi sunulur. Bazı sağlayıcıların aksine, gizli ücretler veya abonelik kilitlemeleri yoktur; yalnızca tükettiğiniz token'lar için ödeme yaparsınız. Fiyatlandırma şeffaftır: 1M giriş token'ı başına 0,25 $ ve 1M çıkış token'ı başına 1,00 $. Hata işleme mantığınızda 429 hatalarında üstel geri çekilme ile yeniden deneme yaptığınızdan emin olun.

Copyfrom openai import OpenAI

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