Hızlı Başlangıç: apertus ai chat'i entegre edin

Önkoşullar ve Kurulum

Bir hesap oluşturarak ve API anahtarınızı alarak başlayın. Anahtar oluşturma sayfasında Google veya bir e-posta şifresi kullanarak kaydolun. Sistem anahtarınızı hemen gösterir, böylece gecikmeden kopyalayabilirsiniz. Kayıt için telefon numarası gerekmez. Yedi gün boyunca geçerli olan $0.50 deneme kredisi alırsınız, böylece fon eklemeden bağlantıyı test edebilirsiniz.

Ortam değişkeninizi veya SDK istemcinizi doğru temel URL'ye yönlendirin. Bu URL standart OpenAI kütüphaneleriyle çalışır. Yalnızca temel URL'nizi ve anahtarınızı değiştirin. Model kimliği "uncensored"dir. Bu tek uç nokta tüm metin tamamlamalarını yönetir. Yönlendirme yönetimine veya farklı modeller seçmeye gerek yoktur.

İstemci kütüphanenizin OpenAI Sohbet Tamamlama protokolünü desteklediğinden emin olun. Çoğu modern SDK kutudan çıkar çıkmaz çalışır. Ağınızın HTTPS çıkış isteklerine izin verdiğini doğrulayın. Hizmet standart JSON yüklerini kabul eder. Kimlik doğrulaması dışında özel başlıklara gerek yoktur.

API Anahtarları ile Kimlik Doğrulama

Her istek için API anahtarınızı Authorization başlığında iletin. Bearer şemasını anahtar dizenizin ardından kullanın. Hizmet, anahtarı hesabınızla doğrular. Geçersiz anahtarlar 401 Unauthorized hatası döndürür. Süresi dolmuş yetersiz bakiye 402 Payment Required yanıtını tetikler. İstekler başarısız olursa bakiyenizi panoda kontrol edin.

Anahtarınızı güvende tutun. Her hesapta bir aktif anahtar bulunur. Yeni bir anahtar oluşturmak öncekini geçersiz kılar. Anahtarınızı genel depolarda paylaşmayın. API anahtarı, kullanımınız için tek tanımlayıcıdır. Hız sınırları hesap yerine anahtar başına uygulanır.

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

Kimlik doğrulama statesizdir. Sunucu, her çağrıda jetonu kontrol eder. Anahtarınızı döndürürseniz, çalışan tüm istemcileri hemen güncelleyin. Başlığın eksik olması, anında reddedilmeyle sonuçlanır. Hata mesajı kimlik doğrulama hatasını açıkça belirtir.

İlk İsteğinizi Gönderme

Sohbet tamamlama uç noktasına bir POST isteği gönderin. Model kimliği "uncensored" ve mesaj geçmişinizi dahil edin. API bir metin yanıtı döndürür. Çıktıyı akış olarak alabilir veya tam tamamlamayı bekleyebilirsiniz. Her istek giriş ve çıkış belirteçlerini tüketir. Hatalar kredi ücretlendirmez. Reddiyeler ücretsizdir.

Copyfrom openai import OpenAI

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

Yanıt, kullanım istatistiklerini içerir. Ön ödemeli kredinizi yönetmek için token tüketimini izleyin. Model, yasal yetişkin kullanım için içerik reddi olmadan yanıt verir. Davranışı tanımlamak için sistem istemlerini gönderebilirsiniz. Kullanıcı mesajları konuşmayı yönlendirir. Bağlam penceresi toplamda 100,000 tokenı destekler.

Basit bir iki mesajlı alışverişle başlayın. Bu, bağlantıyı ve yanıt kalitesini doğrular. Yaratıcı veya hassas çıktılar için sıcaklık ve top_p değerlerini ayarlayın. API standart parametreleri destekler. Durdurma dizileri beklendiği gibi çalışır. Seed değerleri tekrarlanabilir sonuçlar sağlar.

SSE Üzerinden Akış Yanıtları

Akış özelliğini etkinleştirin ve stream parametresini true olarak ayarlayın. API, tek bir JSON nesnesi yerine Sunucu Tarafından Gönderilen Olaylar (SSE) döndürür. Her parça oluşturulan metnin bir bölümünü içerir. Akış bitene kadar parçaları okuyun. Son parça toplam token kullanımını içerir.

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)

Akış, algılanan gecikmeyi azaltır. Kullanıcılar metnin gerçek zamanlı olarak belirdiğini görür. Bu, sohbet arayüzleri için idealdir. Kısmi tokenları dikkatli bir şekilde yönetin. Parçaları birleştirerek tam yanıtı oluşturun. Oluşturma bittiğinde sunucu bağlantıyı kapatır.

Akış hatalarını izleyin. Ağ kesintileri akışı iptal edebilir. Gerekirse yeniden bağlanma mantığı uygulayın. API geçmişi yeniden göndermez. Akış başarısız olursa yeni bir istek başlatın. Son parçadaki token sayıları tüm üretimi yansıtır.

Parametreleri ve Modları İşleme

Üretimi kontrol etmek için standart parametreleri kullanın. Rastgelelik için sıcaklığı ayarlayın. Çekirdek örnekleme için top_p'yi ayarlayın. Üretimi erken durdurmak için durma dizilerini tanımlayın. Belirli çıktılar için bir tohum belirterek deterministik çıktılar elde edin. response_format'ı json_object olarak ayarlayarak JSON modunu etkinleştirin. Model, istendiğinde geçerli JSON döndürür.

Fonksiyon çağırma desteklenir. İstekte araçları tanımlayın. Model uygun olduğunda araç çağrıları döndürür. Araç argümanlarını kodunuzda ayrıştırın. Sohbeti sürdürmek için sonuçları geri iletin. Bu karmaşık ajan iş akışlarına olanak tanır.

Copyimport OpenAI from "openai";

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

max_tokens, tek bir yanıtın çıktı uzunluğunu sınırlar. Varsayılan değer 2,048 token'dır. İhtiyaç halinde daha yüksek bir değer ayarlayın. İstek başına kesin sınır 16,000 token'dır. Context penceresi 100,000 token'dır. Geçmiş uzunluğunuzu buna göre planlayın. Frequency ve presence cezaları tekrarları azaltmaya yardımcı olur.

Limitler ve Hataları Anlamak

Hız sınırları hizmet stabilitesini korur. Dakikada 300 istek gönderebilirsiniz. Eşzamanlılık ana başına sekiz eşzamanlı istekle sınırlıdır. İstek gövdeleri 8 MB'ı aşmamalıdır. Sınırları aşmak 429 Too Many Errors döndürür. Yeniden denemeden önce bekleyin.

Tanı için hata kodlarını kontrol edin. 401 geçersiz veya eksik anahtarı belirtir. 402 yetersiz ön ödemeli krediyi gösterir. Hizmeti devam ettirmek için kripto ile yükleyin. 429 hız sınırlamasını işaret eder. 400 kötü istek sözdizimini belirtir. Ayrıntılar için hata mesajını gözden geçirin.

Bağlam penceresi yönetimi kritik öneme sahiptir. İstem ve tamamlama belirteçlerini toplayın. 100.000 belirtecin oldukça altında kalın. Gerekirse eski mesajları kısaltın. API otomatik kısaltma yapmaz. Geçmiş uzunluğunu siz kontrol edersiniz. Verimli bağlam kullanımı maliyetleri düşürür.