Dolphin AI Entegrasyon Kılavuzu

Önkoşullar: SDK ve API anahtarı kurulumu

Diliniz için resmi SDK'yı yükleyin. Kontrol panelimizde e-posta veya Google girişi ile bir hesap oluşturun. API anahtarınızı hemen oluşturun. Telefon numarası gerekmez. Anahtar ekranda bir kez görünür. Güvenli bir şekilde saklayın. Ödeme yönteminizi saklamıyoruz. Kripto yüklemeler USDT veya USDC ile yapılır. Bakiye süresi dolmaz. Hatalar ücretsizdir. Sadece kullanılan token'lar için ödeme yaparsınız.

Temel URL'yi ve başlıkları yapılandırma

İstemcinizi temel URL'mize yönlendirin. Yetkilendirme başlığını anahtarınızla ayarlayın. Model kimliğini "uncensored" olarak kullanın. Bu, sansürsüz modelimize ulaşmanızı sağlar. Bu GPT veya Claude değildir. Uç nokta standart sohbet tamamlamalarını kabul eder. Başlıklar API anahtarını içermelidir. Diğer alanlar isteğe bağlıdır. Sıcaklık ve top_p beklendiği gibi çalışır. Standart OpenAI parametrelerini destekliyoruz. Limitler için belgelere bakın.

Copycurl https://api.dolphinllmmodel.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the max token limit for this endpoint?"}]
  }'

İlk sohbet tamamlama isteğinizi gönderme

Mesajlarınızla bir POST isteği gönderin. Bağlam için sistem istemini dahil edin. Kullanıcı mesajı içeriğini tanımlayın. Model bir metin yanıtı döndürür. Maksimum belirteçleri belirtebilirsiniz. Varsayılan çıktı 2.048 belirteçtir. Gerekirse daha yüksek limitler ayarlayın. Bağlam penceresi 100,000 belirteçtir. Giriş ve çıkış bu limiti paylaşır. İsteminizin sığdığından emin olun. Hatalar standart JSON kodları döndürür. Hatalar için yanıt gövdesini kontrol edin.

Copyfrom openai import OpenAI

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

Gerçek zamanlı yanıtlar için akış (streaming) özelliğini etkinleştirin

İsteğinizde streaming değerini true olarak ayarlayın. API chunk'ları SSE aracılığıyla döndürür. Her chunk kısmi metin içerir. Token'ları geldikçe işleyin. Bu, algılanan gecikmeyi azaltır. Hemen geri bildirim alırsınız. Son chunk token kullanımını içerir. Maliyet takibi için kullanımı izleyin. Streaming tüm parametrelerle çalışır. Araçlar ve JSON modu da akış yapar. Bağlantı kopmalarını zarif bir şekilde yönetin. Akış başarısız olursa yeniden bağlanın.

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)

Araçlar ve fonksiyon çağırma kullanımı

İsteğinizde fonksiyon şemalarını tanımlayın. Bunları API'ye araç olarak geçirin. Model araç çağrıları döndürür. Yürütme için argümanları ayrıştırın. Sonuçları modele yeniden gönderin. Bu karmaşık iş akışlarını mümkün kılar. Destek standart OpenAI formatındadır. Araç seçimi otomatik olabilir. Belirli araçları zorlayabilirsiniz. JSON modu araçlarla da çalışır. Şemanızın geçerli olduğundan emin olun. Geçersiz şemalar hatalara neden olur. Önce basit fonksiyonlarla test edin.

Copyimport OpenAI from "openai";

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

Hız sınırlarını ve hataları işleme

Dakikada 300 istek sınırı uygularız. Eşzamanlı istekler sekizle sınırlıdır. İstek gövdeleri 8 MB'ın altında olmalıdır. 401 hatası geçersiz bir anahtar anlamına gelir. Kimlik doğrulama başlığınızı kontrol edin. 402 hatası kredinin tükendiğini gösterir. Devam etmek için kripto ile yükleyin. 429, hız sınırına ulaştığınızı belirtir. Geri çekilme ile bekleyin ve yeniden deneyin. Hatalar ücretsizdir. Yalnızca tamamlanan tokenlar kredi tüketir. Bağlam toplam 100.000 token'dır.