Dolphin AI API Hızlı Başlangıç

Temel URL & Kimlik Doğrulama

Başlamak için temel URL'nizi ve API anahtarınızı istemci yapılandırmanızda ayarlayın. Tüm istekler Authorization header benzersiz anahtarınızı kullanarak. Hizmetimiz, openrouter dolphin AI model varyantıdır, bu uç nokta için OpenRouter'da bir hesaba ihtiyacınız yoktur. Anahtarınızı panelden alın ve ortam değişkenlerinize ekleyin.

• Temel URL: https://api.openrouterdolphinai.com/v1
• Başlık: Authorization: Bearer YOUR_API_KEY

Bu yapı, tam uç nokta yapısını taklit ettiğimiz için herhangi bir standart OpenAI SDK'sı ile çalışır. Yalnızca sohbet tamamlamalar (chat completions) uç noktasıyla etkileşim kurarsınız; bu da entegrasyonunuzu metin üretimine odaklanarak basit ve odaklı tutar.

İlk İstek

Basit kullanarak metin üretmek için ilk mesajınızı gönderin POST model kimliği her zaman yöntem. uncensored, kısıtlanmamış diyalog için özelleştirilmiş özel kısıtlanmamış varyantı almanızı sağlar. Bu tek modeli doğrudan barındırdığımız için karmaşık yönlendirme parametrelerini belirtmenize gerek yoktur.

Bağlantınızı hemen test etmek için aşağıdaki curl komutunu kullanın:

Copycurl https://api.openrouterdolphinai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the syntax error in this python function"}]
  }'

İçerik içeren bir JSON yanıtı alırsanız anahtarınız aktiftir ve krediler doğru şekilde düşülmüştür. 401 gibi hatalar geçersiz bir anahtarı, 402 ise kripto ile bakiye yüklemeniz gerektiğini gösterir. Bu doğrudan yaklaşım, çok modellerli yönlendiricilerin değişkenliğini önler.

Python SDK Entegrasyonu

Resmi OpenAI Python kütüphanesini kullanarak base URL'mizi işaret ederek hızlıca entegre edin. Bu, tanınmış yöntemleri kullanmanıza olanak tanır. chat.completions.create() tüm mantığınızı yeniden yazmadan. Kütüphane serileştirmeyi otomatik olarak halleder, böylece HTTP detaylarına değil, istem tasarımı odaklanabilirsiniz.

İstemciyi temel URL ve anahtarınızla yapılandırın:

Copyfrom openai import OpenAI

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

Bağlam penceresinin 100,000 token olduğunu unutmayın, bu nedenle önemli bir konuşma geçmişini iletebilirsiniz. SDK, tokenizasyonu ve iletimi verimli şekilde yönetir, böylece istemleriniz gereksiz üst bilgi veya biçimlendirme hataları olmadan modele ulaşır.

Node SDK Kullanımı

Node geliştiriciler aynı sonuçları kullanarak elde edebilir openai npm paketi. Python sürümünde olduğu gibi, isteklerin doğrudan sansürsüz modele gitmesini sağlamak için varsayılan base URL'i özel sunucularımıza işaret edecek şekilde geçersiz kılmanız gerekir. Bu, isteklerin üçüncü taraf hız sınırlarına veya yönlendirme gecikmelerine takılmadan doğrudan sansürsüz modele ulaşmasını sağlar.

İstemciyi doğru uç nokta ile başlatın:

Copyimport OpenAI from "openai";

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

Bu desen hem senkron çağrılar hem de async/await desenleri için çalışır. Yanıtları akış halinde alabilir veya aynı fonksiyon çağrısı içinde doğrudan JSON modunu isteyebilirsiniz; bu da temel kimlik doğrulama kurulumunuzu değiştirmeden farklı uygulama mimarileri için esneklik sağlar.

Akış Yanıtları

Şu ayarlayarak gerçek zamanlı metin üretimi etkinleştirin stream: true istem parametrelerinizde. API, belirteçler oluşturulurken görüntülemenize olanak tanıyan bir Sunucu Tarafından Gönderilen Etkinlikler (SSE) akışı döndürür. Bu, kullanıcılar için algılanan gecikmeyi azaltır ve deneyimi tam bir yanıt için beklemekten çok daha hızlı hale getirir.

Son metni biriktirmek için akışı kodunuzda işleyin:

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)

Her bir parça, son parçada token kullanım verisi içerir, bu da maliyetleri doğru bir şekilde izlemenizi sağlar. Akış, anında geri bildirimin kullanıcı katılımını artırdığı sohbet arayüzleri için idealdir. Kullanıcı yeni bir mesaj gönderirse akışı istediğiniz zaman durdurabilirsiniz ve kısmi yanıtlarda kredi tasarrufu sağlayabilirsiniz.

Limitler, Hatalar & Bağlam

Uygulamanızda beklenmeyen kesintilerden kaçınmak için teknik sınırları anlayın. API'miz her istek için toplam istem ve tamamlama dahil olmak üzere 100.000 tokenlık bir bağlam penceresi uygular. 16.000 token çıktı limitini aşarsanız üretim durur, bu nedenle ayarlayın max_tokens maliyetleri kontrol etmek için buna göre.

Yaygın HTTP durum kodları arasında geçersiz anahtarlar için 401, yetersiz kredi için 402 ve hız sınırları için 429 yer alır. Anahtar başına dakikada 300 istekle sınırlısınız. Bu kısıtlamalar, tüm kullanıcılar arasında adil kullanım sağlar. Kullanın 429 istemci kodunuzda üstel geri çekilme (exponential backoff) uygulamak için hata, yoğun trafik dönemlerinde sorunsuz çalışma sağlamak için.