OpenAI Uyumlu API Dokümantasyonu

Kimlik Doğrulama ve Base URL Kurulumu

API anahtarınız sunucularımıza yapılan her isteği doğrular. Google veya bir e-posta adresiyle kayıt olun ve anahtarınızı panodan kopyalayın. Ortam değişkeniniz olarak DEEPSEEK_API_KEY ve istemcinizi https://api.keyapideepseek.com/v1. Bu temel URL, standart herhangi bir OpenAI-uyumlu kütüphaneyle çalışır.

Copycurl https://api.keyapideepseek.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check the system health and confirm uptime status"}]
  }'

Kurulumunuzu mevcut modelleri listelemekle doğrulayabilirsiniz. Yanıt, anahtarınızın geçerli ve aktif olduğunu onaylar. Bu adım, istek göndermeden önce entegrasyonunuzun doğru uncensored endpoint'ine işaret ettiğini sağlar.

Sohbet Tamamlamaları Uç Noktası

The POST /v1/chat/completions uç nokta, isteminizi kabul eder ve model yanıtını döndürür. Mesajları, sistem talimatlarınızı ve sıcaklık gibi parametreleri içeren bir JSON gövdesi gönderirsiniz. Model kimliği her zaman uncensored. Bu tek model, yönlendirme karmaşası olmadan tüm metin üretimi ihtiyaçlarınızı karşılar.

Copyfrom openai import OpenAI

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

Python SDK HTTP isteklerini otomatik olarak yönetir. Anahtarınızı ve temel URL'yi istemci kurucusuna iletirsiniz. Kodun geri kalanı standart OpenAI desenlerini yansıtır. Bu, daha sonra tedarikçileri değiştirdiğinizde tüm uygulama mantığınızı yeniden yazmadan geçiş yapmanızı sağlar.

Akış Yanıtları ve Token Kullanımı

Ayarlayarak akışı etkinleştirin stream: true istek içinde. API, parçaların Sunucu Tarafı Olayları (SSE) akışını döndürür. Her parça kısmi metin ve kullanım istatistikleri içerir. Son parça, istek için toplam token sayıları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. Tokenlar geldikçe görüntüleyebilirsiniz. Bu, uzun formatlı oluşturma veya etkileşimli sohbet arayüzleri için kritiktir. Ön ödemeli kredi tüketiminizi doğru izlemek için son parçadaki token kullanımını izleyin.

JSON Modu ve Fonksiyon Çağırma

response_format'i json_object olarak ayarlayarak yapılandırılmış çıktı zorunlu kılın. response_format için {"type": "json_object"}. Model serbest metin yerine geçerli JSON döndürür. Bu, API entegrasyonları veya veri çıkarma görevleri için idealdir. Araç kullanımı için prompt'unuzda fonksiyon tanımlamaları da tanımlayabilirsiniz.

Model destekler tool_choice parametreler. Belirli işlevleri zorlayabilir veya modelin karar vermesine izin verebilirsiniz. Bu esneklik, karmaşık ajanlar oluşturmanızı sağlar. İstemci kodunuzdaki ayrıştırma hatalarından kaçınmak için işlev şemalarınızın kesinlikle yazımlı olduğundan emin olun.

Saniye Başına İstek Limitleri ve Eşzamanlılık

Her API anahtarı dakikada 300 istekle sınırlıdır. Eşzamanlı olarak en fazla 8 aktif istek yapabilirsiniz. Maksimum istek gövdesi boyutu 8 MB'tır. Bu limitler kötüye kullanımı önler ve tüm kullanıcılar için kararlı performans sağlar. Bu limitleri aşmanız durumunda 429 hatası döndürülür.

İstemci kodunuzda üstel geri çekilme uygulayın. Başarısız istekleri kısa bir gecikmeden sonra yeniden deneyin. Bu, geçici ağ sorunlarını zarifçe yönetir. Ön ödemeli krediniz yalnızca başarılı tamamlamalar için tahsil edilir, hız sınırına takılan yeniden denemeler için değil.

Hata Yönetimi ve Reddetmeler

Bir 401 hatası, anahtarınızın geçersiz veya süresi dolmuş olduğunu gösterir. Bir 402 hatası, yetersiz ön ödemeli kredi olduğunu gösterir. Bir 429 hatası, hız sınırına ulaştığınızı gösterir. Model, reşit olmayanlarla ilgili cinsel içerik içeren istekleri reddeder. Diğer tüm yasal yetişkin içeriğe izin verilir.

Detaylı mesajlar için hata yanıt gövdesini kontrol edin. Entegrasyon sorunlarını halletmek için bu hataları günlüğe kaydedin. Başarısız istekler için krediniz tüketilmez. Bu şeffaf faturalandırma modeli, gizli ücretler olmadan maliyetleri doğru bir şekilde tahmin etmenize yardımcı olur.

Node.js

Copyimport OpenAI from "openai";

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