Geliştiriciler için Entegrasyon Kılavuzu

Temel URL ve Kimlik Doğrulama

İstemcinizi temel URL'mize yönlendirin ve yetkilendirme başlığında API anahtarınızı sağlayın. Bu, standart protokolü tam olarak takip ettiğimiz için herhangi bir OpenAI uyumlu SDK ile çalışır. Anahtarınızı Get API key sayfasında Google veya e-posta ile anında oluşturun; telefon numarası gerekmez. Anahtarınızı güvende tutun ve hesap başına tek bir aktif anahtar kullanın, çünkü yeni bir tane oluşturmak eskisini yerini alır.

Kimlik doğrulama basittir. Anahtarınızı şurada gönderin Authorization header'ı her istek için kullanın. Sistem, tokenları işlemeden önce anahtarı doğrular, yalnızca yetkili hesapların krediyi tükettiğini sağlar. Eksik anahtar gibi hatalar hemen bir 401 durumu döndürür.

İlk İstek

Bağlantıyı ve yanıt kalitesini test etmek için standart bir chat completion isteği gönderin. Bu basit çağrı, anahtarınızı doğrular ve hesabınıza kredileri doğru şekilde yükler. Model kimliği uncensored, hukuki yetişkin kullanımı için içerik reddetmeleri olmadan metin giriş ve çıkışını işler. Yer tutucuyu gerçek anahtarınız ve sistem prompt'unuzla değiştirin.

Copycurl https://api.deepseekapicost.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "calculate total monthly cost for 1 million tokens"}]
  }'

Bu curl komutu, gereken minimum yapıyı gösterir. Değiştirebilirsiniz messages kullanım durumunuza uyması için dizi. content alanı. Token tüketiminizi izlemek için yanıt başlıklarındaki kullanım istatistiklerini kontrol edin.

Python SDK

API'mizi betiklerinize veya uygulamalarınıza entegre etmek için resmi OpenAI Python kütüphanesini kullanın. Set the base_url ve api_key çağrı yapmadan önce öznitelikleri. Bu yaklaşım, zaten OpenAI modelleri kullanan mevcut kod tabanlarıyla uyumluluğu sağlar. Yapılandırmanızda yalnızca iki satırı değiştirerek sağlayıcılar arasında geçiş yapabilirsiniz.

Copyfrom openai import OpenAI

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

Yukarıdaki Python kod parçacığı, istemcinin nasıl başlatılacağını ve isteğin nasıl gönderileceğini gösterir. Kütüphane JSON serileştirmesini ve yanıt ayrışmasını otomatik olarak yönetir. İçeriği, kullanım istatistiklerini ve bitiş nedenlerini çıkarmak için yanıt nesnesine erişebilirsiniz. Bu yöntem arka uç hizmetleri veya veri işleme hatları için idealdir.

Node SDK

API'mizi Node.js uygulamalarına entegre edin openai istemciyi base URL'imiz ve API anahtarınızla OpenAI için yapacağınız gibi yapılandırın. Bu, hem test hem de üretim için aynı kod yapısını kullanmanıza olanak tanır. SDK, engelleme olmayan istekler için asenkron işlemleri destekler.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.deepseekapicost.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 Node.js örneği, bir sohbet tamamlama isteği göndermeyi gösterir. Bu await anahtar, yanıtın devam etmeden önce tamamen alınmasını sağlar. Ağ sorunlarını veya API sınırlarını zarifçe yönetmek için hata işleme için try-catch blokları kullanabilirsiniz. Yanıt nesnesi oluşturulan metni ve token kullanım ayrıntılarını içerir.

Akış

Sohbet arayüzlerinde daha iyi kullanıcı deneyimi sağlamak için token bazlı yanıtlar almak üzere akış özelliğini etkinleştirin. stream stream parametresini isteğinizde true olarak ayarlayın. API, oluşturulurken metin parçalarını döndürerek çıktıyı gerçek zamanlı olarak görüntülamanıza olanak tanır. Bu, son kullanıcılar için algılanan gecikmeyi önemli ölçüde azaltı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)

Yukarıdaki akış kodu, her parçayı geldiği anda işler. İçeriği hemen bir UI öğesine ekleyebilirsiniz. Son parça, toplam token kullanım istatistiklerini içerir. Bu özellik, SSE yanıtlarını doğru şekilde işleyen tüm OpenAI-uyumlu istemciler tarafından desteklenir.

Limitler, Hatalar ve Bağlam Penceresi

API'miz, adil kullanım ve sistem kararlılığını sağlamak için sıkı limitler uygular. Dakikada 300 istek ve anahtar başına 8 eş zamanlı istek yapmanıza izin verilir. Her istek gövdesi 8 MB'ı aşmamalıdır. Bu limitleri aşarsanız API, 429 durum kodunu döndürür. Birkaç saniye bekleyin ve isteğinizi yeniden deneyin. Geçersiz anahtarlar gibi hatalar 401 döndürür ve yetersiz kredi 402 döndürür.

Bağlam penceresi hem girdi hem de çıktı için toplam 100.000 token destekler. İsteği başına maksimum çıktı 16.000 token'dır veya belirtmezseniz 2.048 max_tokens. Bu büyük pencere, uzun belgeleri işlemenize veya kapsamlı bir sohbet geçmişini korumanıza olanak tanır. Hatalar ve reddi işlemler kredinizi tüketmez, bu nedenle yalnızca gerçek kullanım için ödeme yaparsınız.