Dokumentacja API dla programistów

Bazowy URL i autoryzacja

Zacznij od zmiany podstawowego URL na nasz dedykowany endpoint i przekazania klucza API w nagłówku Authorization. Nie używamy standardowego podstawowego URL OpenAI; musisz wskazać swoje SDK na https://api.deepseektokenplan.com/v1. Zapewnia to, że Twoje żądania są kierowane przez naszą infrastrukturę modeli bez cenzury, a nie przez zewnętrzny serwer proxy. Identyfikator modelu podany w ciele żądania to "uncensored", co aktywuje odpowiednie wagi na naszych serwerach. Autoryzacja opiera się na prostym schemacie tokena Bearer, który działa z dowolną biblioteką kliencką kompatybilną z OpenAI. Twój klucz jest generowany natychmiast po rejestracji za pomocą Google lub e-maila, bez konieczności podawania numeru telefonu. Przechowuj ten klucz w bezpiecznym miejscu, ponieważ jest on bezpośrednio powiązany z saldem Twoich środków prepay.

Pierwsze żądanie

Wyślij standardowe żądanie chat completions za pomocą cURL, aby zweryfikować konfigurację i dostępność modelu. To proste żądanie POST demonstruje, jak API akceptuje Twój systemowy prompt i wiadomość użytkownika. Możesz dostosować parametry temperature i top_p, aby kontrolować kreatywność. Odpowiedź zwraca wygenerowany tekst wraz ze statystykami zużycia tokenów dla przejrzystości rozliczeń. Upewnij się, że ciało żądania zawiera prawidłowy identyfikator modelu i klucz API w nagłówku. Ta metoda działa zarówno w przypadku generowania tekstu, jak i wywoływania funkcji. Użyj tego polecenia, aby potwierdzić łączność przed integracją z aplikacją. Punkt końcowy obsługuje tryby streamingowe i niestreamingowe równie dobrze.

Integracja SDK Python

Użyj oficjalnej biblioteki Pythona OpenAI do interakcji z naszym API, konfigurując base URL i klucz API. Zainicjuj klienta swoimi poświadczeniami i wywołaj metodę chat completions z pożądanym ID modelu. To podejście pozwala wykorzystać istniejące bazy kodu, które zostały zbudowane dla OpenAI, bez dużego refaktoryzowania. Możesz strumieniować odpowiedzi lub otrzymać pełny tekst naraz. Biblioteka automatycznie obsługuje serializację JSON i żądania HTTP. Skonfiguruj ustawienia timeout i retry zgodnie z potrzebami dla Twojego konkretnego przypadku użycia. Ta metoda jest idealna dla usług backendowych i potoków przetwarzania danych. Upewnij się, że zaktualizujesz base URL tak, aby wskazywał na nasz konkretny punkt końcowy.

Integracja SDK Node

Zintegruj API do swoich aplikacji JavaScript lub TypeScript za pomocą pakietu Node OpenAI. Ustaw base URL i klucz API w konfiguracji klienta przed wykonaniem jakichkolwiek żądań. Ta konfiguracja pozwala na użycie znanych metod takich jak chat.completions.create() z naszym uncensored modelem. Możesz przekazać parametry takie jak temperatura i sekwencje stop, aby dostroić wynik. SDK efektywnie obsługuje odpowiedzi strumieniowe dla aplikacji w czasie rzeczywistym. Użyj tej metody dla serwerów WWW lub narzędzi wiersza poleceń. Upewnij się, że zaimportujesz niezbędne moduły i poprawnie skonfigurujesz zmienne środowiskowe. Ta metoda obsługuje zarówno wzorce żądań synchronicznych, jak i asynchronicznych.

Strumieniowanie i tokeny

Włącz strumieniowanie, aby otrzymywać częściowe odpowiedzi w miarę ich generowania, co poprawia doświadczenie użytkownika dla interfejsów czatu. API używa Server-Sent Events (SSE) do dostarczania tokenów w czasie rzeczywistym. Możesz śledzić zużycie tokenów w ostatniej cząstce strumienia do dokładnych rozliczeń. Funkcja ta jest obsługiwana przez wszystkie główne SDK i może być zaimplementowana ręcznie, jeśli jest to konieczne. Strumieniowanie zmniejsza postrzeganą latencję dla długich odpowiedzi. Ustaw stream parametru do true w ciele żądania. API zwraca statystyki użycia w ostatnim zdarzeniu, pozwalając na odliczenie poprawnej kwoty od Twojego kredytu wstępnie opłaconego. Ta metoda jest niezbędna dla aplikacji wymagających natychmiastowej informacji zwrotnej.

Limity i obsługa błędów

Monitoruj swoje limity szybkości i obsługuj błędy z gracją, aby zapewnić stabilne połączenie. API pozwala na 300 żądań na minutę na klucz i 8 żądań równoległych. Każde ciało żądania nie może przekraczać 8 MB. Jeśli wyślesz nieprawidłowy klucz, otrzymasz błąd 401 Unauthorized. Błąd 402 oznacza niewystarczający kredyt płatny z góry, wymagający doładowania kryptowalutą. Błąd 429 oznacza przekroczenie limitu szybkości; poczekaj i spróbuj ponownie. Okno kontekstowe ma 100 000 tokenów dla polecenia i uzupełnienia łącznie. Maksymalne wyjście to 16 000 tokenów, chyba że określisz niższą max_tokens wartości. Zawsze sprawdzaj kod stanu i ciało odpowiedzi, aby uzyskać szczegółowe komunikaty o błędach.

cURL

Copycurl https://api.deepseektokenplan.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 50 million tokens"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Strumieniowanie

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)