getdeepseekapi.comDokümantasyon
DeepSeek API: İlk istek beş dakikada
Mevcut OpenAI uyumlu istemcinizi temel URL'mize yönlendirerek ve kayıt sırasında oluşturulan anahtarla kimlik doğrulayarak ilk yanıtınızı beş dakika içinde alın.
Temel URL ve Kimlik Doğrulama
API'miz standart OpenAI arayüzünü takip eder, bu nedenle istemci yapılandırmanızda yalnızca iki değeri değiştirmeniz yeterlidir. Temel URL'yi https://api.getdeepseekapi.com/v1 olarak ayarlayın ve API anahtarını al sayfasında hesabınızı oluşturduktan sonra görüntülenen API anahtarını kullanın. Başlamak için telefon numarası veya kredi kartı gerekmez; yedi gün boyunca geçerli olan $0,50 deneme kredisi alırsınız.
Her hesap için aynı anda yalnızca bir aktif anahtar izin verilir. Anahtarınızı döndürürseniz, önceki anahtar hemen iptal edilir. Bu, karmaşık izin kapsamlarına gerek kalmadan geliştirme ve üretim ortamları arasında gizli anahtar yönetimini basitleştirir.
Bir Sohbet Tamamlama İsteği Gönderme
Standart bir POST isteği göndererek /v1/chat/completions uç noktasına erişin ve metin yanıtı alın. Uç nokta, sistem isteminizi ve kullanıcı sorgunuzu içeren bir messages dizisi ile model tanımlayıcısını uncensored olarak ayarlanmış şekilde kabul eder. Bu model kendi GPU sunucularımızda çalışır ve yasal yetişkin kullanım için içerik reddetmeleri olmadan yanıt verecek şekilde ayarlanmıştır.
İstek gövdenizin 8 MB altında kaldığından emin olun. Anahtar geçersiz veya süresi dolmuşsa sunucu 401 hatası döndürür. Ön ödemeli krediniz tükendiğinde, bakiye yüklemeniz gerektiren bir 402 hatası alırsınız. Fon ekleme işlemlerini kripto (USDT veya USDC) ile başlangıç $10'dan itibaren yapabilirsiniz.
curl https://api.getdeepseekapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
Python SDK'sını Yükleme ve Kullanma
Resmi OpenAI Python kütüphanesini kullanmak entegrasyon için en hızlı yoldur. Paketi pip aracılığıyla yükleyin, ardından istemciyi özel temel URL'niz ve API anahtarınızla yapılandırın. model parametresinin uncensored olarak ayarlanması, özel örneğimizle iletişim kurduğunuzdan emin olmanızı sağlar.
Bu yaklaşım Node.js veya Go için kullanılanlar dahil olmak üzere herhangi bir OpenAI uyumlu SDK ile çalışır. İstemci seri hale getirme ve yeniden denemeleri otomatik olarak yönetir. Model kimliğinin GPT-4 gibi bir satıcı adı olmadığını, bizim sansürsüz modelimiz için özel bir tanımlayıcı olduğunu unutmayın.
from openai import OpenAI
client = OpenAI(base_url="https://api.getdeepseekapi.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 Entegrasyonu
JavaScript ortamları için OpenAI SDK'sını yükleyin ve Python örneğine benzer şekilde yapılandırın. baseUrl parametresini uç noktamıza ayarlayın ve API anahtarınızı sağlayın. Node SDK hem senkron hem de asenkron kalıpları destekler.
İsteği oluştururken parametrelerde model: 'uncensored' belirtin. Bu, istemcinin doğru model uç noktasına istek göndermesini sağlar. SDK, akışlı ve akışsız yanıtları eşit şekilde yönetir; bu da çekirdek istek mantığını değiştirmeden uygulamaları değiştirmenize olanak tanır.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.getdeepseekapi.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ış (SSE) Etkinleştirme
Sunucu Tarafından Gönderilen Olaylar (SSE) yanıtı almak için stream parametresini true olarak ayarlayın. Sunucu, oluşturulan metnin bir bölümünü içeren bir dizi parça gönderir. Bu, uzun yanıtlar için algılanan gecikmeyi azaltır ve istemcinin token'ları üretildikçe göstermesine olanak tanır.
İstemci kodunuzun akış sonlandırma olayını düzgün şekilde işlediğinden emin olun. Akış, fiyatlandırmayı veya token saymayı değiştirmez; hala girdi ve çıktı için 1M token başına ücretlendirilirsiniz. Toplam bağlam penceresi, birleştirilmiş istem ve tamamlama için 100.000 token ile sınırlı kalır.
stream = 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)
Limitler, Hatalar ve Bağlam Penceresi
API anahtarınız dakikada 300 isteğe sınırlıdır. Bu eşiği aşarsanız sunucu bir hız limiti gösteren 429 hatası döndürür. Her istek gövdesi 8 MB'ı geçmemelidir. Bağlam penceresi, istem ve tamamlamanın toplamı için 100.000 token destekler; bu nedenle uygulamanızı tasarlarken hem girdi hem de çıktı uzunluklarını hesaba katmalısınız.
Yaygın hatalar arasında geçersiz anahtarlar için 401, yetersiz ön ödemeli kredi için 402 ve hız limitleri için 429 bulunur. API anahtarınızı hesap ayarlarınızdan istediğiniz zaman yeniden oluşturabilirsiniz; bu, eski anahtarı hemen geçersiz kılar. Sızıntı şüpheleniyorsanız veya ortamlar arasında kimlik bilgilerini döndürmeniz gerekirse bu kullanışlıdır.
API özellikleri
Kredi yüklemeden önce kontrol edebilmeniz için API'nin gerçek limitleri ve özellikleri tek yerde.
| Öğe | Değer |
|---|---|
| Biçim | OpenAI uyumlu: herhangi bir OpenAI SDK'sı base URL ve anahtarı değiştirerek çalışır |
| Uç noktalar | POST /v1/chat/completions · GET /v1/models |
| Kimlik doğrulama | Authorization: Bearer YOUR_KEY |
| Model kimliği | uncensored |
| Base URL | https://api.getdeepseekapi.com/v1 |
| Bağlam penceresi | 100.000 token (girdi + çıktı) |
| Parametreler | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| JSON modu | response_format: {"type": "json_object"} |
| Akış | evet — server-sent events; son parça token kullanımını içerir |
| Maksimum çıktı | 100.000 token'lık pencerenin kalanına kadar; max_tokens isteğe bağlı (ayrı sınır yok) |
| Fonksiyon çağırma | evet — tools, tool_choice; yanıtta tool_calls, akışta da; sonuçlar role: tool olarak |
| Hız limiti | anahtar başına dakikada 300 istek |
| İstek boyutu | en fazla 8 MB |
| Eşzamanlılık | anahtar başına aynı anda 8 istek |
| Yanıt başlıkları | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Geçerlilik | ödenen kredinin süresi dolmaz, abonelik yok |
| Yükleme | USDT (TRC20) veya USDC (Base), $10–$500 arası herhangi bir tam tutar |
| Ücretsiz deneme | $0,50, 7 gün, kart gerekmez · Deneme anahtarı: 2 paralel istek, dakikada 60; ilk yüklemeden sonra tam limitler (8 ve 300) |
| Fiyat | 1M girdi token'ı $0,25 · 1M çıktı token'ı $1,00 |
| Faturalama | ön ödemeli kredi, gerçek kullanıma göre; hatalar ve retler ücretsiz |
| Bonus | $50'dan itibaren +%5, $100'dan itibaren +%10 |
| Giriş | Google veya e-posta ve şifre |
| İçerik | yetişkin içeriğe izin var; reşit olmayanları içeren cinsel içerik reddedilir |
| Anahtarlar | hesap başına bir aktif anahtar; yenisi eskisinin yerini alır |
Hata kodları
Hatalar sabit bir type ile JSON olarak döner; başarısız veya reddedilen istekler ücretlendirilmez.
| Kod | Tür | Anlamı |
|---|---|---|
400 | bad_request | geçersiz JSON, boş mesajlar, hatalı parametre veya bağlam çok uzun |
401 | missing_key · invalid_key · key_revoked | anahtar yok, yanlış veya değiştirilmiş |
402 | no_credit | kredi bitti — yükleyin, hemen devam eder |
403 | content_blocked | reşit olmayanları içeren cinsel içerik — reddedildi, ücret yok |
404 | not_found | bilinmeyen uç nokta |
413 | request_too_large | gövde 8 MB'tan büyük |
429 | rate_limited · concurrency | dakikada 300 veya aynı anda 8 aşıldı — bekleyip tekrar deneyin |
503 | upstream_busy | model meşgul — birkaç saniye sonra tekrar deneyin |
Sorular ve cevaplar
Bağlam penceresi boyutu nedir?
Bağlam penceresi 100.000 token'dır; girdi istem token'ları ve çıktı tamamlama token'larının toplamı olarak hesaplanır. Bu, yalnızca girdi için ayrılmış 100.000 token anlamına gelmez.
Bu hizmet fonksiyon çağırma'yı destekliyor mu?
Evet, <code>/v1/chat/completions</code> uç noktası fonksiyon ve fonksiyon çağırma'yı destekler. İsteğinizde fonksiyonları tanımlayabilir, model bunlar için yapılandırılmış argümanlar döndürür.
402 hatasını nasıl yönetirim?
402 hatası, ön ödemeli kredi bakiyenizin sıfır olduğunu gösterir. Hesabınızı kripto (USDT veya USDC) kullanarak başlangıç $10'dan itibaren yükleyebilirsiniz. Krediler asla sona ermez.
Anahtarınız tek bir formun uzağında
Bir hesap oluşturun, anahtarı kopyalayın, temel URL'yi değiştirin. Kurulumun tamamı bu kadar.