Character AI API Anahtarı: Nasıl Alınır ve Kullanılır
Bir Character AI API anahtarı aradıysanız, bilmeniz gereken ilk şey, bu sitenin Character.ai olmadığını ve onun anahtarlarını vermediğidir. Karakter sohbet uygulamaları için doğrudan yerine geçebilen bir arka uç olarak çalışan bağımsız, OpenAI uyumlu bir metin API'si için size bir anahtar verir.
Güncellendi

Temel noktalar
- Google veya e-posta ve şifre ile kayıt olduktan ve API anahtarı sayfasını açtıktan sonra bir anahtar alırsınız.
- Yeni kullanıcılar tek tıkla, kart gerekmeden $0,50 deneme kredisi alabilir; bu kredi 7 gün boyunca geçerlidir.
- Herhangi bir OpenAI SDK ile base URL https://api.characteraiapi.com/v1 ve model kimliği
uncensoredkullanın. - Anahtarı bir sunucuda veya ortam değişkeninde tutun, asla genel ön uç kodunda bırakmayın.
Aslında ne aldığınız
Character.ai bir tüketici sohbet ürünüdür. Character AI API anahtarı arayan kişiler genellikle iki şeyden birini ister: kendi kodlarından bir karakter sohbet botuna erişmek veya bir kişilik uygulaması için barındırılan bir ürünün kurallarıyla sınırlı olmayan bir arka uç. Bu site ikinci ihtiyacı karşılar. Kayıt olursunuz, bir anahtar alırsınız ve OpenAI uyumlu bir uç noktaya istek gönderirsiniz. Burada hiçbir şey Character.ai'ye bağlanmaz veya onun karakterlerini kullanmaz.
Hizmet, bağımsız bir sağlayıcı tarafından işletilen ve yasal yetişkin kullanımı için içerik reddi olmadan cevap verecek şekilde ayarlanmış tek bir açık ağırlıklı modelin önünde barındırılan bir metin API'sidir. Herhangi bir model satıcısının resmi API'si değildir ve satıcılar arasında bir yönlendirici değildir. Model kimliği uncensored'dir ve base URL https://api.characteraiapi.com/v1'dir. İki yöntem vardır: POST /v1/chat/completions ve GET /v1/models.
Arayüz OpenAI'ninkine benzediğinden, karakter oluşturma işi size düşer. Karakteri bir sistem mesajı olarak yazarsınız, sohbet geçmişini korursunuz ve her istekte bunu gönderirsiniz. Bu size, kapalı bir ürünün nadiren sunduğu ses, hafıza ve tempo kontrolü sağlar. Her kullanıcı için zor sınır aynıdır: reşit olmayanları içeren cinsel içerik asla.
Anahtarınızı beş adımda alın
Tüm yol birkaç dakika sürer. Başlamak için bir karta ihtiyacınız yoktur.
- Kayıt olun. Google kullanın veya bir e-posta ve şifre ile kaydolun.
- Anahtar sayfasını açın. Hesabınızın anahtarının gösterildiği API anahtarı sayfasına gidin.
- Denemeyi talep edin. O sayfada tek bir tıklama $0,50 deneme kredisi ekler. Bu kişi başı bir kezle sınırlıdır ve 7 gün boyunca geçerlidir.
- Anahtarı kopyalayın. Bunu hemen bir parola yöneticisine veya bir gizli dosyaya kaydedin.
- Bir test isteği gönderin. Herhangi bir uygulama koduna dokunmadan önce aşağıdaki curl komutunu kullanın.
Anahtarı bir şifre gibi ele alın. Ona sahip olan herkes bakiyenizi harcayabilir. Sızdığını düşünüyorsanız, hemen kullanmayı bırakın, onu her uygulamadan kaldırın ve beklenmedik harcamalar için bakiyenizi kontrol edin.
Anahtarı curl ile test edin
Anahtarı bir ortam değişkeni olarak ayarlayın, böylece düz metin olarak kabuk geçmişinize düşmez. Ardından modelleri listeleyin. Bu, anahtarın çalıştığını ve doğru ana makineye ulaştığınızı doğrular.
export API_KEY="paste-your-key-here"
curl https://api.characteraiapi.com/v1/models \
-H "Authorization: Bearer $API_KEY"uncensored içeren bir JSON listesi almalısınız. Şimdi küçük bir karakterle ilk sohbet isteğini gönderin. Sistem mesajı karakteri belirler, kullanıcı mesajı sahneyi başlatır.
curl https://api.characteraiapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You are Mara, a dry-witted ship engineer in a space opera. Stay in character."},
{"role": "user", "content": "The reactor is humming wrong again. What do you do?"}
],
"temperature": 0.9
}'Yanıt standart sohbet tamamlama biçimini izler. Yanıt metni choices[0].message.content içinde yer alır. Yanıt başlıkları ayrıca X-Request-Id, X-Balance-USD ve hız limiti başlıklarını da taşır; bu, kendi arayüzünüzde kalan bakiyeyi göstermek istediğinizde kullanışlıdır.
Anahtarı Python veya Node'dan kullanın
İki değeri değiştirdikten sonra herhangi bir OpenAI SDK çalışır. İşte resmi openai paketiyle Python sürümü.
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.characteraiapi.com/v1",
api_key=os.environ["API_KEY"],
)
reply = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are Mara, a ship engineer. Stay in character."},
{"role": "user", "content": "Status report?"},
],
)
print(reply.choices[0].message.content)Ve Node'da aynı çağrı:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.characteraiapi.com/v1",
apiKey: process.env.API_KEY,
});
const reply = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "system", content: "You are Mara, a ship engineer. Stay in character." },
{ role: "user", content: "Status report?" },
],
});
console.log(reply.choices[0].message.content);Birçok sohbet ön ucunda özel bir OpenAI uyumlu uç nokta için bir alan bulunur. Bu araçlarda base URL'yi yapıştırın, anahtarı yapıştırın ve model adı olarak uncensored yazın. Başka hiçbir şeyin değişmesi gerekmez. dokümantasyon sayfası akış, fonksiyon çağırma ve JSON modu dahil desteklenen parametreleri listeler.
Yaygın anahtar sorunları ve hızlı çözümler
Çoğu ilk kez başarısızlık birkaç küçük hatadan kaynaklanır. Daha büyük bir şeye şüphe duymadan önce bunları bu sırayla kontrol edin.
- Anahtarda ekstra boşluk veya tırnak işaretleri. Bir dosyadan kopyalanan son bir satır sonu bile kimlik doğrulamanın başarısız olmasına neden olabilir. Değişkenin uzunluğunu yazdırın ve kopyaladığınız şeyle karşılaştırın.
- Yanlış base URL. Base URL
/v1ile biter ve SDK/chat/completions'i kendisi ekler. Base URL'ye de/chat/completionseklerseniz, yol iki katına çıkar ve istek başarısız olur. - Yanlış model adı. Model kimliği
uncensored'dir. Başka hizmetlerden alınan isimler eşleşmeyecektir. Sunucunun ne bildirdiğini görmek içinGET /v1/modelsçağrısını yapın. - Eksik başlık. Ham HTTP çağrıları için
Authorization: Bearerardından bir boşluk ve anahtar, POST istekleri içinContent-Type: application/jsongerekir. - Boş bakiye.
X-Balance-USDyanıt başlığı kalan miktarı gösterir. Deneme kredisi harcandığında veya 7 gün geçtiğinde, bakiye yükleyin veya istekler başarısız olmaya başlayacaktır. - Hız limitleri. Bir deneme anahtarı 2 eşzamanlı istek ve dakikada 60 istek izni verir. İki açık akış zaten her iki yuvayı da kullanır.
Kötü bir anahtar genellikle bir model yanıtı yerine bir kimlik doğrulama hatası üretir. Bir limit, rate_limited veya concurrency koduyla HTTP 429 üretir. Sadece durum kodunu değil, hata gövdesini okumak zaman kazandırır çünkü kod hangi limite takıldığınızı söyler. Her yanıt bir X-Request-Id taşır; başarısız bir çağrıyı daha sonra belirli bir istekle eşleştirebilmek için bunu günlüklerinize kaydedin.
Deneme limitleri ve denemenin ne satın aldığı
Bir deneme anahtarı, tam bir anahtardan daha düşük limitlere sahiptir: 2 eşzamanlı istek ve dakikada 60 istek. Tam bir anahtar dakikada 8 eşzamanlı istek ve 300 istek izni verir. Tek bir karakteri test etmek için bu yeterlidir. Test betiğinizden aynı anda birkaç sohbet çalıştırırsanız, concurrency veya rate_limited hata koduyla HTTP 429 görürsünüz. Akışlı bir istek, akış bitene kadar eşzamanlılık yuvasını tutar, bu nedenle bir deneme anahtarında iki açık akış yuvayı doldurur.
$0,50 ile ne kadar gidebilirsiniz? Fiyatlar 1M giriş token'ı başına $0,15 ve 1M çıktı token'ı başına $0,50'dir. Ortalama bir sohbet dönüşü için, 1.500 tokenlık geçmiş ve karakter girdisi ve 300 token çıktı ile hesaplayın:
- Girdi: 1.500 token x $0,15 / 1.000.000 = $0,000225
- Çıktı: 300 token x $0,50 / 1.000.000 = $0,00015
- Bir dönüş: $0,000375
- $0,50 / $0,000375 yaklaşık 1.333 dönüş demektir
Bu, birkaç karakteri düzgünce test etmek için yeterlidir. Başarısız veya reddedilen istekler ücretlendirilmez, bu nedenle hata veren bir istek kredinizi yemez. Deneme 7 gün sonra sona erer; daha sonra satın aldığınız kredi süresi dolmaz.
Kişiliğin doğru hissettirmesini sağlayan ayarlar
Bir anahtar bağlantı sağlar; bir karakterin kalitesi istem ve örnekleme ayarlarından gelir. Bazı alışkanlıklar, zeki hilelerden daha fazla yardımcı olur.
Sistem mesajını, karakterin kim olduğunu, nasıl konuştuğunu, ne istediğini ve yanıtlarının ne kadar uzun olması gerektiğini açık cümlelerle anlatan kısa bir karakter sayfası olarak yazın. Ses önemliyse bir veya iki örnek diyalog satırı verin. Modeller sıfatlardan somut örnekleri daha iyi takip eder; bu nedenle "Mara kısa, kuru cümlelerle cevap verir ve gergin olduğunda şaka yapar" gibi bir satır, "Mara zeki ve çekici" ifadesinden daha iyi çalışır.
Canlılığı ayarlamak için temperature kullanın. 0.9'a yakın değerler daha çeşitli ifadeler üretirken, 0.5'e yakın değerler karakteri daha istikrarlı tutar. Uygulamanız "User:" gibi bir konuşmacı etiketi kullanıyorsa ve modelin konuşmanın diğer tarafını yazmasını engellemek istiyorsanız bir stop dizisi ekleyin. Sıklık ve varlık cezaları uzun sohbetlerde tekrarlanan ifadeleri azaltabilir, ancak yüksek değerler diyalogun tuhaf hale gelmesine neden olabileceğinden bunları dikkatli bir şekilde artırın.
Modelin sadece istektekileri bildiğini unutmayın. Karakter, 200 mesaj önceki oyuncunun adını hatırlamalıysa, o mesajı pencerede tutun veya temel gerçekleri sistem mesajında saklayın. Bu nedenle, kendiniz güncellediğiniz bir hafıza listesi, devasa bir geçmişi göndermekten genellikle daha iyidir.
Deneme süresi bittiğinde bakiye yüklemek
Abonelik yoktur. Ön ödeme yaparsınız ve token başına harcamanız gerçekleşir. Bakiye yüklemeler $20 ile $500 arasında herhangi bir tam tutar alabilir ve daha büyük tutarlara bonus eklenir: $50'den itibaren +%5, $100'den itibaren +%10 ve $200'den itibaren +%15. Yani $50, $52,50 krediye dönüşür; $100, $110'a; $200 ise $230'a dönüşür. Kripto (TRC20 üzerinde USDT, Base üzerinde USDC) ile ödeme yapabilirsiniz.
Fiyatlandırma sayfası tam tabloyu içerir. Planlama için, aynı 1.500 giriş, 300 çıkış dönüşü $0,000375'e mal olur, bu nedenle $20 yaklaşık 53.000 böyle dönüşü karşılar. Uzun süreli rol yapma, geçmiş büyüdükçe dönüş başına daha fazla maliyet yaratır, bu nedenle yeniden gönderdiğiniz miktarı sınırlayın. Bağlam penceresi 100.000 token'dır, istem ve tamamlama birlikte, ancak bunu doldurmak istemezsiniz.
Anahtarı gerçek bir uygulamada güvende tutmak
Bir sohbet projesinde yapılan en yaygın hata, API'ye doğrudan tarayıcı kodundan istek yapmaktır. Tarayıcıya gönderilen her şey her ziyaretçi tarafından okunabilir; anahtar da dahil. Ön ucunuz ile API arasında küçük bir sunucu kullanın. Tarayıcı rotanıza bağlanır, rotanız Authorization: Bearer başlığını ekler ve isteği iletir.
- Anahtarı depoda değil, bir ortam değişkeninde veya gizli bilgi yöneticisinde saklayın.
- İlk commit'inizden önce
.envgirdisini.gitignoredosyasına ekleyin. - Geliştirme ortamındaki bir sızıntının üretim ortamını etkilememesi için ortam başına bir anahtar kullanın.
- Kontrolden çıkan döngüleri erken yakalamak için
X-Balance-USDbaşlığını izleyin. - HTTP 429 hatasında kısa bir bekleme süresiyle yeniden deneyin. Geçici bir aşırı yük yanıtı
Retry-After: 5içerebilir.
API'ye gönderilen istemler eğitim için kullanılmaz. Yine de, kendi tarafınızdaki bir günlükte saklanmasını istemediğiniz verileri göndermekten kaçının. Böyle bir API'nin ne yaptığını ve ne yapmadığını daha derinlemesine incelemek isterseniz, mitler ve gerçekler makalesi yaygın yanlış anlaşılmaları ele alır.