Karakter api Entegrasyon Hızlı Başlangıcı

SDK'yı yükleyin

Diliniz için resmi istemci kütüphanesini yükleyerek başlayın. Bu, sağladığımız OpenAI-uyumlu uç nokta ile uyumluluğu sağlar. Kütüphane, sizin için seri hale getirme ve yeniden deneme mantığını yönetir.

Python için pip kullanın. Node.js için npm kullanın. Bu adım birkaç saniye sürer ve ardından gelen kod örnekleri için ortamı kurar.

Temel URL'nizi Yapılandırın

SDK istemcinizi sansürsüz modele erişmek için uç noktamıza işaretleyin. Temel URL HTTPS://api.apicharacter.com/v1'dir. Bu, yapılandırmanızdaki varsayılan OpenAI URL'sinin yerini alır.

Bu değişiklik olmadan istekler başarısız olur veya yanlış servise çarpar. Bunu istemci örneğinizi başlatırken yalnızca bir kez ayarlamanız yeterlidir.

API Anahtarınızı Ayarla

Anahtarınızı ortam değişkenine veya istemci yapılandırmasına enjekte edin. Ön ödemeli kredi kullanımınızı izlemek için her istek için kimlik doğrulaması gereklidir. Anahtarınız uncensored LLM uç noktasına erişim sağlar.

Bu değeri güvende tutun. Hesap için tek kimlik doğrulamanız olarak işlev görür. Temel erişim için telefon numarası veya ek doğrulama gerekmez.

İlk İsteğinizi Yapın

Bağlantıyı doğrulamak için basit bir sohbet tamamlama isteği gönderin. Model kimliği "uncensored"dir. Bu, uygulamanızı geliştirmeden önce kimlik doğrulamanızın ve temel URL'nizin doğru olduğunu doğrular.

Standart bir cURL isteği için aşağıdaki örneği görün.

Copycurl https://api.apicharacter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "set my name to Alex"}]
  }'

Akış Yanıtlarını Yönetin

Sohbet arayüzlerinizde daha düşük gecikme için akışı etkinleştirin. İsteğinizde stream parametresini true olarak ayarlayın. SDK, tokenları oluşturulduklarında iletecektir.

Bu, duyarlı kullanıcı deneyimleri için kritiktir. Kısmi parçaları Sunucu Tarafından Gönderilen Olaylar (Server-Sent Events) aracılığıyla geldikçe işlersiniz.

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)

Limitler, Hatalar ve Bağlam

Servis kesintilerinden kaçınmak için kısıtlamalarınızı anlayın. 100.000 tokenlık bir bağlam penceresi alırsınız. Aksi belirtilmedikçe maksimum çıktı 16.000 token'dır.

Hız sınırı dakikada 300 istek ile sınırlıdır. 401 hatası geçersiz anahtar anlamına gelir. 402 sıfır kredi anlamına gelir. 429 hız sınırına ulaştığınızı gösterir. Üretim ölçeklendirmesi için bunları göz önünde bulundurun.

Python

Copyfrom openai import OpenAI

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