DeepSeek kullanıcıları için hızlı başlangıç
OpenAI uyumlu istemcinizi üç satırda sansürsüz DeepSeek API'mize entegre edin: base URL'yi güncelleyin, API anahtarını değiştirin ve kodunuzu koruyun. Bu rehber, model reddi olmadan standart SDK'ları kullanarak bağlantı kurmanın tam olarak nasıl yapılacağını gösterir.
Temel URL ve Kimlik Doğrulama
API'mizi kullanmak için istemcinizi https://api.deepseekapi.top/v1 adresine yönlendirin. Uç nokta yollarını değiştirmenize gerek yoktur; standart /v1/chat/completions beklediği gibi çalışır. Kimlik doğrulama, kayıt sırasında oluşturulan tek bir API anahtarına dayanır. Bu anahtarı Authorization başlığında Bearer belirteci olarak iletin. Anahtar eksik veya geçersizse sunucu 401 hatası döndürür. İlk isteğinizi yapmadan önce ortam değişkenlerinizin doğru ayarlandığından emin olun.
- Temel URL:
https://api.deepseekapi.top/v1 - Kimlik Doğrulama Başlığı:
Authorization: Bearer YOUR_API_KEY
curl https://api.deepseekapi.top/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."}]
}'
Chat Completions Uç Noktası
API'miz standart sohbet tamamlama isteklerini kabul eder. /v1/chat/completions uç noktasına uncensored model kimliği ile bir POST isteği gönderin. Model, metin girdisine yanıt verir ve resmi DeepSeek veya diğer büyük sağlayıcılarda görülen içerik filtrelerini uygulamadan metin çıktısı üretir. Bu durum onu yaratıcı yazarlık, rol yapma veya kısıtlamasız veri işleme için ideal kılar. Davranışı temperature ve top_p gibi parametrelerle kontrol edebilirsiniz. Yanıt, oluşturulan metni ve token kullanım istatistiklerini içerir.
Modelin GPT, Claude veya başka bir sağlayıcının modeli olmadığını unutmayın. Bağımsız, kısıtlamasız yasal kullanım için ayarlanmış açık ağırlıklı bir modeldir. Token maliyetleri için fiyatlandırma sayfasına bakın.
from openai import OpenAI
client = OpenAI(base_url="https://api.deepseekapi.top/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 SDK Entegrasyonu
Node.js geliştiricileri için süreç, standart OpenAI entegrasyonlarıyla aynıdır. İstemciyi özel temel URL'niz ve API anahtarınızla başlatın. Yapılandırmanızda modeli uncensored olarak ayarlayın. SDK, istek yaşam döngüsünü (yeniden denemeler ve hata yönetimi dahil) herhangi bir OpenAI uyumlu hizmet için yapacağı şekilde yönetir. Bu, mevcut kod tabanlarınızı minimum sürtünmeyle yeniden kullanmanızı sağlar. Tam uyumluluk için openai npm paketinin güncel bir sürümünü kullandığınızdan emin olun.
API, hem senkron hem de asenkron çağrıları destekler. Mesajları standart messages dizisi formatında iletebilirsiniz. Yanıt yapısı OpenAI API spesifikasyonuyla eşleşir, bu da geçişi kolaylaştırır.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.deepseekapi.top/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ışlı Yanıtlar
İsteğinizde stream: true ayarını yaparak akışı etkinleştirin. API, bir Server-Sent Events (SSE) akışı döndürür. Her parça kısmi bir yanıt içerir; bu da metnin oluşturulurken görüntülenmesine olanak tanır. Token kullanım verileri yalnızca akışın son parçasında yer alır, her parçada bulunmaz. Bu tasarım, doğru faturalandırma metriklerini sağlamaya devam ederken yük boyutunu azaltır. Kullanım verilerini almak için özel stream_options yapılandırmasına ihtiyacınız yoktur; bu bilgiler son parçada otomatik olarak sağlanır.
Kullanıcı arayüzünüzü gerçek zamanlı olarak güncellemek için akış olaylarını işleyin. Akış, model yanıtını tamamladığında veya bir limite ulaştığında sona erer.
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)
Fonksiyon Çağırma ve JSON Modu
API, tools ve tool_choice parametreleri aracılığıyla fonksiyon çağırma desteği sağlar. Fonksiyonlarınızı istekte tanımlayın, model yapılandırılmış araç çağrıları döndürür. response_format değerini {"type": "json_object"} olarak ayarlayarak sıkı JSON çıktısını zorlayabilirsiniz. Bu, ayrıştırma hataları olmadan yapılandırılmış veri oluşturmak için kullanışlıdır. Model, bu talimatları güvenilir bir şekilde izlemeye ayarlanmıştır.
Dinamik etkileşimler için fonksiyon çağırma ile akışı birleştirin. API, karmaşık çok adımlı iş akışları için çoklu dönüşler boyunca bağlamı korur. En iyi sonuçlar için fonksiyon tanımlarınızın net ve iyi yapılandırılmış olduğundan emin olun.
Limitler, Hatalar ve Bağlam Penceresi
Bağlam pencereniz, istem ve tamamlama birleşimi olarak 100.000 token'dır. Maksimum çıktı isteği başına 32.000 token'dır veya max_tokens ayarlamazsanız 2.048 token'dır. Hız limitleri dakikada 300 istek ve anahtar başına 8 eşzamanlı istektir. Bu değerleri aşarsanız 429 hatası alırsınız. 401 hatası geçersiz bir anahtarı, 402 hatası ise ön ödemeli kredinizin tükendiğini gösterir. Hatalar ve reddedilen istekler token tüketmez. İstekler 8 MB gövde ile sınırlıdır. Anahtarınızı hemen almak için Google veya e-posta ile kaydolun.
Sorular ve cevaplar
Bu resmi DeepSeek API mi?
Hayır. Bağımsız bir sağlayıcıyız ve OpenAI uyumlu bir arayüz üzerinden kendi sansürsüz modelimizi çalıştırıyoruz. Bu, GPT, Claude veya resmi DeepSeek hizmeti değildir.
402 veya 429 gibi hataları nasıl yönetirim?
402 hatası, ön ödemeli kredinizin tükendiğini gösterir; kart (Visa, Mastercard, Apple Pay, Google Pay) veya kripto (TRC20 üzerinde USDT, Base üzerinde USDC) ile bakiye yükleyin. 429 hatası, dakikada 300 istek olan hız limitine ulaştığınızı belirtir. Bekleyip tekrar deneyin veya kullanım şeklinizi yükseltin.
Deneme kredisi süresi doluyor mu?
Evet. Yeni hesaplar, 7 gün boyunca geçerli olmak üzere $0,50 deneme kredisi alır. Ön ödemeli krediler asla süresi dolmaz, ancak deneme kredileri dolabilir.
Anahtarınız tek bir formun uzağında
Bir hesap oluşturun, anahtarı kopyalayın, temel URL'yi değiştirin. Kurulumun tamamı budur.
Teknik özellikler
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 |
| Base URL | https://api.deepseekapi.top/v1 |
| Model kimliği | uncensored |
| Uç noktalar | POST /v1/chat/completions · GET /v1/models |
| Kimlik doğrulama | Authorization: Bearer YOUR_KEY |
| JSON modu | response_format: {"type": "json_object"} |
| Parametreler | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Fonksiyon çağırma | evet — tools, tool_choice; yanıtta tool_calls, akışta da; sonuçlar role: tool olarak |
| Maksimum çıktı | 100.000 token'lık pencerenin kalanına kadar; max_tokens isteğe bağlı (ayrı sınır yok) |
| Bağlam penceresi | 100.000 token (girdi + çıktı) |
| Akış | evet — server-sent events; son parça token kullanımını içerir |
| Eşzamanlılık | anahtar başına aynı anda 8 istek |
| Hız limiti | anahtar başına dakikada 300 istek |
| Yanıt başlıkları | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| İstek boyutu | en fazla 8 MB |
| Fiyat | 1M girdi token'ı $0,15 · 1M çıktı token'ı $0,50 |
| Faturalama | ön ödemeli kredi, gerçek kullanıma göre; hatalar ve retler ücretsiz |
| Geçerlilik | ödenen kredinin süresi dolmaz, abonelik yok |
| Ü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) |
| Yükleme | USDT (TRC20) veya USDC (Base), $20–$500 arası herhangi bir tam tutar |
| Bonus | $50'dan itibaren +%5, $100'dan itibaren +%10, $200'dan itibaren +%15 |
| 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 |