Przewodnik integracji dla programistów

Bazowy URL i autoryzacja

Zacznij od wskazania klienta na nasz adres bazowy i podania klucza API w nagłówku autoryzacji. Działa to z dowolnym SDK kompatybilnym z OpenAI, ponieważ ściśle przestrzegamy standardowego protokołu. Wygeneruj swój klucz natychmiast za pomocą Google lub e-mail na stronie Uzyskaj klucz API; nie jest wymagany numer telefonu. Chroń swój klucz i używaj jednego aktywnego klucza na konto, ponieważ wygenerowanie nowego zastępuje poprzedni.

Uwierzytelnianie jest proste. Wyślij swój klucz w Authorization nagłówek dla każdego żądania. Nasz system weryfikuje klucz przed przetwarzaniem tokenów, zapewniając, że kredyt zużywają tylko autoryzowane konta. Błędy, takie jak brak klucza, natychmiast zwracają status 401.

Pierwsze żądanie

Standardowe żądanie chat completion, aby przetestować łączność i jakość odpowiedzi. To proste wywołanie weryfikuje poprawność klucza i poprawnie obciąża Twoje konto. ID modelu to uncensored, który obsługuje wejście i wyjście tekstu bez odmów treści dla prawnego użytku dorosłego. Zastąp symbol zastępczy swoim rzeczywistym kluczem i promptem systemowym.

Copycurl https://api.deepseekapicost.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "calculate total monthly cost for 1 million tokens"}]
  }'

To polecenie curl demonstruje minimalną strukturę wymaganą. Możesz dostosować messages tablicę, aby uwzględnić kontekst lub instrukcje. Odpowiedź zwraca wygenerowany tekst w content pole. Sprawdź statystyki użycia w nagłówkach odpowiedzi, aby monitorować zużycie tokenów.

SDK Python

Użyj oficjalnej biblioteki Pythona OpenAI do integracji naszego API w swoich skryptach lub aplikacjach. Ustaw base_url i api_key atrybuty przed wykonaniem wywołań. To podejście zapewnia kompatybilność z istniejącymi bazami kodu, które już używają modeli OpenAI. Możesz przełączać się między dostawcami, zmieniając tylko dwie linie konfiguracji.

Copyfrom openai import OpenAI

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

Powyższy fragment kodu Pythona pokazuje, jak zainicjować klienta i wysłać żądanie. Biblioteka automatycznie obsługuje serializację JSON i parsowanie odpowiedzi. Możesz uzyskać dostęp do obiektu odpowiedzi, aby wyodrębnić treść, statystyki użycia i powody zakończenia. Metoda ta jest idealna dla usług backendowych lub potoków przetwarzania danych.

SDK Node

Zintegruj nasze API z aplikacjami Node.js za pomocą openai pakiet npm. Skonfiguruj klienta z naszym URL bazowym i swoim kluczem API tak, jak zrobiłbyś to dla OpenAI. Pozwala to na użycie tej samej struktury kodu zarówno do testów, jak i produkcji. SDK obsługuje operacje asynchroniczne dla żądań nieblokujących.

Copyimport OpenAI from "openai";

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

Ten przykład Node.js demonstruje wysyłanie żądania uzupełnienia czatu. The await słowo kluczowe zapewnia, że odpowiedź jest w pełni otrzymana przed kontynuowaniem. Możesz obsłużyć błędy za pomocą bloków try-catch, aby zgrabnie zarządzać problemami sieciowymi lub limitami API. Obiekt odpowiedzi zawiera wygenerowany tekst oraz szczegóły dotyczące zużycia tokenów.

Strumieniowanie

Włącz strumieniowanie, aby otrzymywać odpowiedzi token po tokenie dla lepszego doświadczenia użytkownika w interfejsach czatu. Ustaw stream ustaw na true w swoim żądaniu. API zwraca fragmenty tekstu w miarę ich generowania, pozwalając na wyświetlanie wyniku w czasie rzeczywistym. Zmniejsza to znacząco postrzeganą latencję dla użytkowników końcowych.

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)

Powyższy kod strumieniowy przetwarza każdy fragment po jego otrzymaniu. Możesz natychmiast dołączać zawartość do elementu interfejsu użytkownika. Ostatni fragment zawiera statystyki zużycia tokenów. Funkcja ta jest obsługiwana przez wszystkie klienty zgodne z OpenAI, które poprawnie obsługują odpowiedzi SSE.

Limity, Błędy i Okno Kontekstu

Nasze API narzuca ścisłe limity, aby zapewnić uczciwe użytkowanie i stabilność systemu. Masz prawo do 300 żądań na minutę i 8 żądań współbieżnych na klucz. Każde ciało żądania nie może przekraczać 8 MB. Jeśli przekroczysz te limity, API zwróci kod statusu 429. Poczekaj kilka sekund i ponów żądanie. Błędy, takie jak nieprawidłowe klucze, zwracają kod 401, a niewystarczające środki zwracają kod 402.

Okno kontekstowe obsługuje do 100 000 tokenów łącznie dla wejścia i wyjścia. Maksymalna odpowiedź na żądanie to 16 000 tokenów, lub 2 048, jeśli nie określisz max_tokens. To duże okno pozwala Ci przetwarzać długie dokumenty lub utrzymywać obszerną historię rozmów bez obcinania. Błędy i odrzucenia nie zużywają kredytu, więc płacisz tylko za rzeczywiste użycie.