Dolphin sansürsüz API Dokümantasyon

Önkoşullar ve Ortam Kurulumu

İstek yapmadan önce ortamınızda gerekli bağımlılıkların yüklü olduğundan emin olun. Panomuzdan aktif bir API anahtarına ve Python veya Node.js gibi desteklenen bir çalışma zamanına ihtiyacınız olacaktır. API'miz, istekleri varsayılan OpenAI uç noktası yerine belirli bir temel URL'ye göndermenizi gerektirir.

API anahtarınızı güvende tutun ve ortam değişkeninde saklayın. Bu, anahtarın kod depolarınızda yanlışlıkla açığa çıkmasını önler. Google veya e-posta ile kaydolduktan sonra hemen yeni bir anahtar oluşturabilirsiniz.

Karmaşık yönlendirme yapılandırmanıza veya belirli modeller seçmenize gerek yoktur. Uç nokta, doğrudan metin çıktısı için tasarlanmış tek bir sansürsüz büyük dil modelini sunar.

Resmi OpenAI SDK'sının Kurulması

Kimlik doğrulama ve istek biçimlendirmesini otomatik olarak yönetmek için resmi SDK paketini yükleyin. Bu kütüphane hem Python hem de Node.js ortamlarını tutarlı arayüzlerle destekler.

Python kullanıcıları için kütüphaneyi sanal ortamınıza eklemek üzere standart pip install komutunu çalıştırın. Node.js geliştiricileri eşdeğer paketi yüklemek için npm kullanmalıdır.

SDK, JSON yük yapısını sizin için yönetir, bu nedenle yalnızca prompt içeriği ve sıcaklık veya top_p gibi parametrelere odaklanmanız yeterlidir.

Kurulumu betiğinizde veya modülünüzde kütüphaneyi içe aktararak doğrulayabilirsiniz. Bu, istemcinin sunucularımıza bağlanmaya hazır olduğunu sağlar.

Temel URL ve API Anahtarı Yapılandırması

SDK istemcinizi istekleri sansürsüz altyapımıza yönlendirmek için özel temel URL'mize işaretleyin. Kullanın https://api.dolphinuncensored.com/v1 uç noktanız olarak.

API anahtarınızı yetkilendirme başlığında (authorization header) veya istemci yapılandırma nesnesinde ayarlayın. İstemci, bu anahtarı otomatik olarak her isteye ekleyecektir.

Yapılandırmanızda model kimliğini "uncensored" olarak belirtin. Bu, sunucuya oluşturma için hangi model sürümünün kullanılacağını bildirir.

İlk Sohbet Tamamlama İsteğinizi Yapmak

Bağlantıyı doğrulamak ve bir yanıt almak için basit bir mesaj gönderin. Bu, anahtarınızın geçerli olduğunu ve uç noktanın erişilebilir olduğunu doğrular.

Sistem prompt'u ve kullanıcı mesajı ile chat-completions endpoint'ini kullanın. Yanıt, content alanında oluşturulan metni içerecektir.

Akış (Streaming) ve Token Kullanımını Anlamak

Tam yanıtı beklemek yerine oluşturulurken tokenlar almak için akış özelliğini etkinleştirin. Bu, uzun çıktılar için algılanan gecikmeyi iyileştirir.

API, son akış parçasında kullanım istatistiklerini döndürür. Faturalandırma şeffaflığı için giriş ve çıkış token sayılarını takip edebilirsiniz.

İstek gövdenizde stream parametresini true olarak ayarlayın. Son metni oluşturmak veya gerçek zamanlı işlemek için parçalar üzerinden yineleme yapın.

Hataları ve Reddleri İşleme

API anahtarınızın doğru ve süresi geçmemiş olduğunu doğrulayarak HTTP 401 hatalarını yönetin. 402 hatası, yetersiz ön ödemeli krediyi gösterir; devam etmek için kripto ile kredi yükleyin.

Bir 429 durumu, dakikada 300 istek hız sınırına ulaştığınızı gösterir. Tekrar denemeden önce kısa bir süre bekleyin veya eşzamanlılığınızı azaltın.

Model, çocuklarla ilgili cinsel içerik içeren istekleri reddeder; bu kesin bir sınırdır. Diğer tartışmalı veya yetişkin konuları genellikle kabul edilir. Hatalar ve reddetmeler token kredinizi tüketmez.

cURL

Copycurl https://api.dolphinuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch the list of installed python packages"}]
  }'

Python

Copyfrom openai import OpenAI

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

Akış

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)