Szybki start: Integracja API DeepSeek Coder

Bazowy URL i autoryzacja

Twój klucz API uwierzytelnia każde żądanie do naszego hostowanego endpointu. Użyj adresu bazowego https://api.coderdeepseek.cc/v1 z dowolnym SDK OpenAI lub klientem HTTP. Identyfikator modelu to ściśle uncensored. Działa na naszych własnych serwerach i nie jest odsprzedażą modelu innego dostawcy. Po rejestracji za pomocą Google lub e-maila otrzymujesz natychmiastowy klucz API. Przechowuj ten klucz bezpiecznie, ponieważ kontroluje on Twoje prepaydowane środki.

Uwierzytelnianie opiera się na Authorization Nagłówek. Przekaż swój klucz jako token Bearer. Każde żądanie musi zawierać ten nagłówek, aby uniknąć 401 błąd. Nie używamy parametrów zapytania do uwierzytelniania. To zapewnia czyste nagłówki i kompatybilność ze standardowym oprogramowaniem pośredniczącym.

Wysyłanie żądań: Chat Completions

Endpoint uzupełnień czatu przetwarza Twoje prompty i zwraca wyjścia tekstowe. Wyślij żądanie POST do /v1/chat/completions. Dołącz nazwę modelu, tablicę wiadomości oraz żądane parametry. System przetwarza tekst wejściowy i zwraca tekst wyjściowy. Możesz kontrolować format odpowiedzi oraz kryteria zatrzymania. Działa zarówno dla prostych zapytań, jak i złożonych zadań programistycznych.

Użyj poniższego polecenia curl, aby przetestować połączenie. Zastąp YOUR_API_KEY z Twoim rzeczywistym kluczem. Żądanie używa uncensored identyfikator modelu. Potwierdza to, że Twoja autoryzacja i saldo kredytu są aktywne.

Copycurl https://api.coderdeepseek.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the current version of the library"}]
  }'

Sprawdź, czy odpowiedź zawiera choices tablicę. Każda opcja zawiera wiadomość z wygenerowaną zawartością. Sprawdź usage obiekt po liczby tokenów. Pomaga to w dokładnym monitorowaniu wydatków.

Integracja SDK Python

Zintegruj interfejs API ze swoimi projektami Python za pomocą oficjalnego pakietu OpenAI. Ustaw adres bazowy na nasz punkt końcowy. Zainicjuj klienta swoim kluczem API. Pozwala to na korzystanie z znanych metod, takich jak chat.completions.create. SDK automatycznie serializuje dane JSON i obsługuje żądania HTTP.

Skonfiguruj model na uncensored. Przekaz swoje wiadomości w standardowym formacie. SDK obsługuje wszystkie nasze funkcje, w tym wywoływanie funkcji i tryb JSON. Możesz ustawić parametry takie jak temperatura i top_p bezpośrednio. Ułatwia to migrację z innych dostawców.

Copyfrom openai import OpenAI

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

Obsługuj wyjątki dla błędów sieciowych lub nieprawidłowych żądań. Sprawdź kod statusu, jeśli parsujesz surową odpowiedź. Zapewnia to solidną obsługę błędów w Twojej aplikacji. SDK abstrahuje większość złożoności.

Integracja SDK Node

Użyj SDK OpenAI dla Node.js, aby zintegrować się z projektami JavaScript lub TypeScript. Zainstaluj pakiet i skonfiguruj URL bazowy. Zachowuje to kompatybilność z istniejącą strukturą kodu. Możesz używać tych samych metod co w Pythonie. SDK obsługuje zarówno CommonJS, jak i moduły ES.

Ustaw model na uncensored. Przekaz swoje wiadomości i parametry. SDK obsługuje żądania strumieniowe i niestrumieniowe. Możesz przechwytywać błędy i logować je odpowiednio. Zapewnia to stabilność Twojej aplikacji pod obciążeniem.

Copyimport OpenAI from "openai";

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

Przetestuj swoją integrację prostym promptem. Zweryfikuj, czy odpowiedź odpowiada Twoim oczekiwaniom. Sprawdź użycie tokenów w obiekcie odpowiedzi. Pomaga to śledzić koszty i wydajność. SDK ułatwia szybkie iteracje.

Odpowiedzi strumieniowe i zużycie tokenów

Włącz strumieniowanie, ustawiając stream: true w Twoim żądaniu. API zwraca strumień zdarzeń wysłanych przez serwer (SSE). Otrzymujesz fragmenty tekstu w miarę ich generowania. Zmniejsza to postrzeganą opóźnienie dla długich odpowiedzi. Ostatni fragment zawiera całkowite zużycie tokenów.

Przetwarzaj zdarzenia SSE, aby wyodrębnić zawartość. Połącz fragmenty, aby utworzyć kompletną odpowiedź. Monitoruj usage obiekt w ostatnim cząstkowym pakiecie. Daje to dokładne liczby tokenów do rozliczeń. Strumieniowanie jest idealne dla aplikacji w czasie rzeczywistym.

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)

Obsługuj przerwy w sieci w sposób elegancki. Połącz się ponownie, jeśli strumień się rozłączy. API nie ponownie wysyła poprzednich fragmentów. Musisz zrekonstruować pełny tekst po stronie klienta. Zapewnia to płynne doświadczenie użytkownika.

Limity, Błędy i Okno Kontekstu

Nasze API narzuca ścisłe limity, aby zapewnić stabilność. Możesz wysyłać 300 żądań na minutę na klucz. Do 8 żądań może działać jednocześnie. Rozmiar ciała żądania nie może przekraczać 8 MB. Przekroczenie tych limitów skutkuje 429 błąd limitu szybkości. Obsłuż te błędy za pomocą wykładniczego backoffu.

Okno kontekstowe wynosi 100 000 tokenów. Obejmuje ono zarówno prompt, jak i uzupełnienie. Maksymalna liczba tokenów wyjściowych to 16 000 na żądanie. Jeśli nie ustawisz max_tokens, domyślnie wynosi 2,048. A 401 błąd oznacza, że Twój klucz jest nieprawidłowy. A 402 błąd oznacza, że nie masz kredytu. Doładuj poprzez kryptowalutę, aby kontynuować korzystanie z usługi.