Nasıl DeepSeek API'yi Entegre Et

Önkoşullar: Ortam Kurulumu

Geliştirme ortamınızda gerekli SDK'nın yüklü olduğundan emin olarak başlayın. Python veya Node.js gibi bir dil çalışma zamanına ve API kimlik bilgilerinizi güvenli bir şekilde depolamak için bir yola ihtiyacınız vardır. Bu kurulum, herhangi bir başka OpenAI-uyumlu hizmeti kullanmakla aynıdır.

Satıcıya özgü sürücüler kurmanıza gerek yoktur. Proxy tüm model çıkarımını yönetir, bu nedenle makinenizin yalnızca HTTP istekleri göndermesi ve JSON yanıtlarını ayrıştırması yeterlidir. Bu, bağımlılık yükünü azaltır ve projenizi hafif tutar.

Resmi SDK'nın Kurulması

Kimlik doğrulama ve seri hale getirmeyi otomatik olarak yönetmek için tercih ettiğiniz dil için resmi SDK'yı yükleyin. Python için pip install openai. Node.js için npm install openai. Bu kütüphane altta yatan HTTP bağlantılarını yönetir.

SDK, JSON yüklerini oluşturma karmaşıklığını soyutlar. Odaklanabileceğiniz şey, prompt'unuzu tanımlamak ve döndürülen token'ları işlemektir. Bu standartlaşma, yalnızca temel URL'yi değiştirerek sağlayıcıları daha sonra değiştirmenizi sağlar.

Copyfrom openai import OpenAI

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

Temel URL ve Anahtar Yapılandırması

SDK istemcinizi vekil temel URL'ye işaretleyin ve API anahtarınızı ekleyin. Bu yapılandırma adımı trafiyi standart OpenAI sunucularından uzaklaştırır. Şunu ayarlamanız gerekir base_url için https://api.deepseekpago.com/v1.

Anahtarınızı api_key parametresi. Bu anahtar, sitede kaydolduğunuzda oluşturulur. İsteklerinizi doğrular ve ön ödemeli kredi kullanımınızı izler. Bu yapılandırma olmadan istekleriniz 404 veya 401 hatasıyla başarısız olur.

İlk İsteğinizi Yapmak

Bağlantıyı ve model davranışını doğrulamak için basit bir metin tamamlama isteği gönderin. Model kimliğini uncensored proxy üzerinde çalışan özgün modele erişim. Bu model, yasal yetişkin kullanımı için içerik reddetmeleri olmadan yanıt verecek şekilde ayarlanmıştır.

İstek gövdesi şunları içerir: messages dizi ve model Tanımlayıcı. Yanıt, oluşturulan metni içerir content alanı. Bu, entegrasyonunuzun uncensored modelle doğru çalıştığını doğrular.

Copycurl https://api.deepseekpago.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of top five open source llms"}]
  }'

Akış Yanıtlarının Etkinleştirilmesi

Ayarlayarak akışı etkinleştirin stream: true istekinizde. Bu, tek bir JSON nesnesi yerine Sunucu Tarafından Gönderilen Olaylar (SSE) döndürür. Jetonlar oluşturuldukça alınır; bu da son kullanıcılar için algılanan gecikmeyi azaltır.

Parçaları yineleyerek akışı işleyin. Son parça toplam token kullanımını içerir. Bu, tam yanıt tamamlanmadan gerçek zamanlı olarak maliyetleri izlemenize olanak tanır.

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ı

Modelin yapılandırılmış çıktılar oluşturmasına izin vermek için istek gövdesinde araçları tanımlayın. İşlev tanımlarının bir listesini tools parametresi. Model, uygun olduğunda düz metin yerine bir işlev çağrısı döndürecektir.

Bu özellik, OpenAI fonksiyon çağırma API'siyle aynı şekilde çalışır. Kodu çalıştırmak veya veritabanlarını güncellemek için uygulama mantığınıza entegre edebilirsiniz. Proxy, bu standart protokolü herhangi bir değişiklik olmadan destekler.

Copyimport OpenAI from "openai";

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

JSON Çıktı Formatı Uygulanıyor

Modelin geçerli JSON döndürmesini sağlayarak response_format için {"type": "json_object"}. Verileri uygulamanıza ayrıştırmak için bu faydalıdır. Son işleme için regex desenleri ihtiyacını azaltır.

Model bu kısıtlamayı kesinlikle kabul eder. Çıktı geçerli JSON değilse istek başarısız olabilir. Bu, otomatik sistemlerle entegrasyon sırasında hattınızın sağlam kalmasını sağlar. Yaratıcılığı kontrol etmek için sıcaklık ve top_p'yi de ayarlayabilirsiniz.

Hataları ve Hız Limitlerini İşleme

API, anahtar başına dakikada 300 istek sınırı uygular. Bunu aşarsanız 429 hatası alırsınız. Anahtar başına ayrıca 8 eşzamanlı istek yapabilirsiniz. Hizmet kesintilerinden kaçınmak için bu sınırlara saygı gösterin.

Hatalar bir hata kodu ve mesajı içeren standart JSON nesneleri olarak döndürülür. Bunları kodunuzda zarifçe ele alın. 429 veya 503 yanıtları gibi geçici hatalar için üstel geri çekilme ile yeniden deneme mantığı önerilir.

Token Kullanımının İzlenmesi

Ön ödemeli kredi kullanımınızı token sayılarını izleyerek takip edin. Akış yanıtındaki son parça şunu içerir usage nesne. Bu, girdi ve çıktı token sayılarını gösterir.

Fiyatlar 1M giriş token'ı başına $0.15 ve 1M çıktı token'ı başına $0.50'dir. Hatalar ücretsizdir. Maliyetleri yerel olarak token sayılarını bu oranlarla çarparak hesaplayabilirsiniz. Bu, kripto yüklemenizi bütçelendirmenize yardımcı olur.