Przewodnik integracji: klucz API deepseek coder

Bazowy URL i autoryzacja

Twój klucz API uwierzytelnia każde żądanie. Ustaw podstawowy adres URL na https://api.deepseekcoderapikey.com/v1 w konfiguracji klienta. Ten adres URL obsługuje zarówno endpoint completions czatu, jak i models bez konieczności dodawania dodatkowych segmentów ścieżki. Otrzymujesz jeden klucz na konto, a wygenerowanie nowego natychmiast zastępuje poprzedni klucz.

Przechowuj klucz w zmiennej środowiskowej o nazwie DEEPSEEK_API_KEY lub przekaż go bezpośrednio do klienta Twojego SDK. Endpoint akceptuje standardowe nagłówki, więc możesz zmieniać dostawców, modyfikując tylko bazowy URL i wartość klucza. Podejście to działa z Cursor, rozszerzeniami VS Code oraz lokalnymi narzędziami deweloperskimi, które oczekują interfejsu kompatybilnego z OpenAI.

Uwierzytelnianie nie powiedzie się ze statusem 401, jeśli klucz jest nieobecny lub nieprawidłowy. Użyj

Copycurl https://api.deepseekcoderapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Convert this SQL query to python pandas syntax"}]
  }'

przykład, aby zweryfikować łączność przed integracją w logice swojej aplikacji.

Punkt końcowy Uzupełnień Czat (POST)

Wyślij wiadomości do POST /v1/chat/completions endpoint używając identyfikatora modelu uncensored. Ten endpoint przetwarza wejście tekstowe i zwraca wyjście tekstowe, obsługując zarówno odpowiedzi synchroniczne, jak i strumieniowe. Możesz skonfigurować zachowanie modelu za pomocą parametrów takich jak temperatura, top_p i sekwencje stop.

Okno kontekstowe pozwala na łącznie do 100 000 tokenów dla połączonego promptu i uzupełnienia. Jeśli nie określisz limitu max_tokens, model domyślnie przyjmuje 2 048 tokenów na żądanie. Użyj

Copyfrom openai import OpenAI

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

fragment, aby zobaczyć, jak zstrukturować standardowe żądanie czatu za pomocą oficjalnego Python SDK OpenAI.

Błędy takie jak niewystarczający kredyt zwracają kod statusu 402, podczas gdy niepoprawne żądania zwracają 400. Sprawdź ciało odpowiedzi, aby uzyskać szczegółowe komunikaty o błędach i szybko zdebugować strukturę ładunku.

Punkt końcowy Modeli (GET)

Wyświetl dostępne modele, wysyłając GET /v1/models żądanie. Ten endpoint zwraca listę obiektów modeli, w tym uncensored ID modelu. Możesz użyć tego punktu końcowego, aby zweryfikować, czy Twój klucz API jest ważny i czy usługa jest online, przed wykonaniem żądań o dużym zużyciu.

Odpowiedź zawiera metadane, takie jak identyfikator modelu, typ obiektu i informacje o własności. Użyj tych danych do dynamicznej konfiguracji aplikacji lub do logowania dostępnych modeli w celach debugowania. Endpoint nie wymaga ciała, tylko standardowego nagłówka uwierzytelniającego.

Integracja tej sprawdziany w sekwencji startowej zapewnia, że Twoja aplikacja zawodzi szybko, jeśli API jest niedostępne. Pomaga również zweryfikować, czy poprawny adres URL bazowy jest skonfigurowany przed przejściem do rzeczywistych uzupełnień czatu.

Odpowiedzi strumieniowe (SSE)

Włącz strumieniowanie, ustawiając stream ustaw na true w swoim żądaniu. API zwraca strumień zdarzeń wysłanych przez serwer (SSE), dostarczając tokeny w miarę ich generowania. Podejście to zmniejsza postrzeganą latencję dla asystentów kodujących i pozwala na aktualizacje interfejsu użytkownika w czasie rzeczywistym.

Każdy fragment zawiera częściową zawartość, a ostatni fragment zawiera całkowite statystyki zużycia tokenów. Dokładnie analizuj strumień SSE, aby obsłużyć przerwy w sieci i zbuforować częściowe tokeny. The

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)

przykład demonstruje, jak obsłużyć strumień w JavaScript.

Strumieniowanie jest idealne do generowania długiego kodu lub szczegółowych wyjaśnień. Zapewnia lepsze doświadczenie użytkownika w porównaniu do czekania na całą odpowiedź. Upewnij się, że Twój klient poprawnie obsługuje zdarzenie końca strumienia, aby sfinalizować odpowiedź.

Wywoływanie funkcji i tryb JSON

Użyj wywoływania funkcji, aby umożliwić modelowi wywoływanie zewnętrznych narzędzi. Zdefiniuj swoje funkcje w tools parameter i określ tool_choice do kontrolowania, kiedy model używa narzędzi. API obsługuje standardowe definicje narzędzi, umożliwiając integrację z własnymi usługami backendowymi.

Dla wyjść strukturalnych włącz tryb JSON, ustawiając response_format do json_object.To wymusza od modelu zwracanie formatu JSON, co jest przydatne do parsowania danych konfiguracyjnych lub odpowiedzi API. The

Copyimport OpenAI from "openai";

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

fragment pokazuje, jak skonfigurować tryb JSON w Node.js.

Połącz wywoływanie funkcji ze strumieniowaniem dla interaktywnego korzystania z narzędzi. Model może wywoływać wiele narzędzi w jednej turze, pozwalając na złożone wieloetapowe przepływy pracy. Upewnij się, że klient poprawnie obsługuje wyjścia narzędzi, aby zachować kontekst rozmowy.

Limity szybkości i ograniczenia

Twój klucz API jest ograniczony do 300 żądań na minutę i 8 żądań równoległych. Maksymalny rozmiar ciała żądania wynosi 8 MB. Jeśli przekroczysz te limity, API zwróci błąd 429 Too Many Requests. Zaimplementuj wykładnicze backoff w kliencie, aby obsłużyć limity szybkości w sposób elegancki.

Błędy takie jak 401 wskazują na nieprawidłowy klucz, podczas gdy 402 sygnalizuje niewystarczające środki. Zwroty środków nie są wydawane za kredyt, ale podwójne obciążenia można rozwiązać na stronie Wsparcie. Kredyty nigdy nie wygasają, więc możesz doładować konto, gdy będzie to wygodne.

Okno kontekstowe o rozmiarze 100,000 tokenów dotyczy łącznej liczby tokenów promptu i uzupełnienia. Monitoruj zużycie tokenów, aby mieścić się w budżecie. Skorzystaj z systemu kredytów z góry, aby płacić tylko za to, czego używasz, bez miesięcznych opłat czy subskrypcji.