getdeepseekapi.comDokumentacja
API DeepSeek: pierwsze zapytanie w pięć minut
Otrzymaj pierwszą odpowiedź w pięć minut, wskazując istniejącemu klientowi kompatybilnemu z OpenAI nasz bazowy URL i uwierzytelniając się wygenerowanym kluczem.
Bazowy URL i uwierzytelnianie
Nasze API korzysta ze standardowego interfejsu OpenAI, więc wystarczy zmienić dwie wartości w konfiguracji klienta. Ustaw bazowy URL na https://api.getdeepseekapi.com/v1 i użyj klucza API z strony Pobierz klucz API. Nie potrzebujesz numeru telefonu ani karty kredytowej. Otrzymasz $0,50 kredytu próbnego ważnego przez 7 dni.
Konto pozwala na użycie tylko jednego aktywnego klucza. Obrót klucza natychmiast unieważnia poprzedni. Upraszcza to zarządzanie sekretami w środowiskach deweloperskich i produkcyjnych bez konieczności używania złożonych zakresów uprawnień.
Wyślij uzupełnienie czatu
Wyślij standardowe zapytanie POST do /v1/chat/completions, aby otrzymać odpowiedź tekstową. Endpoint przyjmuje tablicę messages zawierającą twój prompt systemowy i zapytanie użytkownika, wraz z identyfikatorem model ustawionym na uncensored. Ten model działa na naszych własnych serwerach GPU i jest dostrojony do odpowiadania bez odrzucania treści, przeznaczony do użytku przez dorosłych.
Upewnij się, że ciało zapytania nie przekracza 8 MB. Nieprawidłowy lub wygasły klucz zwraca błąd 401. Wyczerpanie kreditu zwraca błąd 402 wymagający doładowania. Możesz dodać środki od $10 za pomocą kryptowalut (USDT lub USDC).
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."}]
}'
Zainstaluj i użyj SDK Pythona
Użycie oficjalnej biblioteki OpenAI Pythona to najszybszy sposób integracji. Zainstaluj pakiet przez pip, a następnie skonfiguruj klienta z własnym bazowym URL i kluczem API. Parametr model musi być ustawiony na uncensored, aby połączyć się z naszą instancją.
Ta metoda działa z dowolnym SDK kompatybilnym z OpenAI, w tym używanym w Node.js lub Go. Klient obsługuje serializację i ponawianie prób automatycznie. Identyfikator modelu to nie nazwa dostawcy (jak GPT-4), lecz specyficzny identyfikator naszego modelu bez cenzury.
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)
Integracja z Node.js
W środowiskach JavaScript zainstaluj SDK OpenAI i skonfiguruj je podobnie jak w przykładzie Pythona. Ustaw baseUrl na nasz endpoint i podaj klucz API. SDK Node.js obsługuje zarówno wzorce synchroniczne, jak i asynchroniczne.
Podczas konstruowania zapytania określ model: 'uncensored' w parametrach. Zapewnia to wysyłanie żądań do właściwego endpointu modelu. SDK obsługuje strumieniowanie i odpowiedzi niestrumieniowe jednolicie, pozwalając na zamianę implementacji bez zmiany logiki zapytania.
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);
Włącz strumieniowanie (SSE)
Ustaw parametr stream na true, aby otrzymać odpowiedź Server-Sent Events (SSE). Serwer wysyła serię cząstek zawierających fragmenty wygenerowanego tekstu. Zmniejsza to postrzeganą latencję długich odpowiedzi i pozwala wyświetlać tokeny w miarę ich generowania.
Upewnij się, że kod klienta poprawnie obsługuje zdarzenie zakończenia strumienia. Strumieniowanie nie zmienia cen ani liczenia tokenów; płacisz za 1M tokenów dla danych wejściowych i wyjściowych. Całkowite okno kontekstu jest ograniczone do 100 000 tokenów dla połączonego promptu i uzupełnienia.
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)
Limity, błędy i okno kontekstu
Twój klucz API jest ograniczony do 300 zapytań na minutę. Przekroczenie tego progu zwraca błąd 429 wskazujący na limit zapytań. Ciało każdego zapytania nie może przekraczać 8 MB. Okno kontekstu obsługuje 100 000 tokenów dla sumy promptu i uzupełnienia, więc musisz uwzględnić długość obu przy projektowaniu aplikacji.
Typowe błędy to 401 dla nieprawidłowych kluczy, 402 dla niewystarczającego kredytu i 429 dla limitów zapytań. Możesz wygenerować klucz ponownie w dowolnym momencie w ustawieniach konta, co natychmiast unieważnia stary klucz. Jest to przydatne przy podejrzeniu wycieku lub rotacji poświadczeń między środowiskami.
Parametry API
Wszystkie rzeczywiste limity i funkcje API w jednym miejscu — sprawdź je przed doładowaniem.
| Element | Wartość |
|---|---|
| Format API | zgodne z OpenAI: działa każdy SDK OpenAI — zmień base URL i klucz |
| Endpointy | POST /v1/chat/completions · GET /v1/models |
| Uwierzytelnianie | Authorization: Bearer YOUR_KEY |
| ID modelu | uncensored |
| Base URL | https://api.getdeepseekapi.com/v1 |
| Okno kontekstu | 100 000 tokenów (wejście + odpowiedź) |
| Parametry | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Tryb JSON | response_format: {"type": "json_object"} |
| Strumieniowanie | tak — server-sent events; ostatni fragment zawiera zużycie tokenów |
| Maks. odpowiedź | do reszty okna 100 000 tokenów; max_tokens opcjonalne (bez osobnego limitu) |
| Wywoływanie funkcji | tak — tools, tool_choice; odpowiedź zawiera tool_calls, także w strumieniu; wyniki jako role: tool |
| Limit zapytań | 300 zapytań na minutę na klucz |
| Rozmiar zapytania | do 8 MB |
| Równoległe zapytania | do 8 jednocześnie na klucz |
| Nagłówki odpowiedzi | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Ważność | opłacony kredyt nie wygasa, bez subskrypcji |
| Doładowanie | USDT (TRC20) lub USDC (Base), dowolna pełna kwota od $10 do $500 |
| Darmowy kredyt | $0,50 na 7 dni, bez karty · Klucz próbny: 2 równoległe żądania, 60 na minutę; pełne limity (8 i 300) po pierwszym doładowaniu |
| Cena | $0,25 za 1 mln tokenów wejścia · $1,00 za 1 mln tokenów wyjścia |
| Rozliczenie | przedpłacony kredyt według rzeczywistego zużycia; błędy i odmowy są darmowe |
| Bonus | +5% od $50, +10% od $100 |
| Logowanie | Google albo e-mail i hasło |
| Treści | treści dla dorosłych dozwolone; treści seksualne z udziałem nieletnich są odrzucane |
| Klucze | jeden aktywny klucz na konto; nowy zastępuje stary |
Kody błędów
Błędy wracają jako JSON ze stałym type; nieudane i odrzucone zapytania są bezpłatne.
| Kod | Typ | Znaczenie |
|---|---|---|
400 | bad_request | błędny JSON, puste wiadomości, zły parametr lub za długi kontekst |
401 | missing_key · invalid_key · key_revoked | brak klucza, zły klucz lub klucz zastąpiony nowym |
402 | no_credit | brak kredytu — doładuj, działa od razu |
403 | content_blocked | treści seksualne z nieletnimi — odmowa, bez opłaty |
404 | not_found | nieznany endpoint |
413 | request_too_large | treść większa niż 8 MB |
429 | rate_limited · concurrency | ponad 300/min lub 8 równolegle — odczekaj i ponów |
503 | upstream_busy | model zajęty — ponów za kilka sekund |
Pytania i odpowiedzi
Jaki jest rozmiar okna kontekstu?
Okno kontekstu wynosi 100 000 tokenów, obliczanych jako suma tokenów promptu wejściowego i tokenów odpowiedzi. Nie jest to 100 000 tokenów wyłącznie dla danych wejściowych.
Czy usługa obsługuje wywoływanie funkcji?
Tak, endpoint <code>/v1/chat/completions</code> obsługuje wywoływanie narzędzi i funkcji. Możesz zdefiniować narzędzia w zapytaniu, a model zwróci dla nich argumenty.
Jak obsłużyć błąd 402?
Błąd 402 oznacza, że saldo przedpłaconego kredytu wynosi zero. Możesz doładować konto od $10, używając kryptowalut (USDT lub USDC). Kredyty nigdy nie wygasają.
Twój klucz jest o jeden formularz stąd
Utwórz konto, skopiuj klucz, zmień bazowy URL. To cała konfiguracja.