Szybki start API i integracja

Bazowy URL i autoryzacja

Projekt Heretic dostarcza pojedynczy, hostowany punkt końcowy do generowania tekstu. Użyj https://api.hereticproject.com/v1 jako swój bazowy adres URL. Uwierzytelnianie opiera się na tokenie bearer przekazanym poprzez Authorization Nagłówek. Utwórz swój klucz, logując się za pomocą Google lub e-maila w panelu. System wydaje jeden aktywny klucz na konto; wygenerowanie nowego klucza unieważnia poprzedni natychmiast.

Płacisz tylko za zużyte tokeny. Błędy i odrzucenia nie obciążają Twojego kredytu prepaid. Nowe konto otrzymuje $0,50 kredytu próbnej ważnego przez siedem dni. Doładowujesz za pomocą USDT (TRC20) lub USDC (Base) w kwotach między $20 a $500.

Endpoint /v1/chat/completions

Wyślij wiadomości do standardowego punktu końcowego uzupełnień czatu. Identyfikator modelu to uncensored.Akceptuje listę obiektów wiadomości z rolami takimi jak system, user, lub assistant. Model nie odrzuca treści dla dorosłych w zakresie prawa, fikcyjnych ani kontrowersyjnych. Jest to model open-weight dostosowany do bezpośrednich odpowiedzi.

Żądania zwracają obiekt JSON zawierający wygenerowany tekst. Okno kontekstowe obsługuje łącznie 100,000 tokenów dla promptu i uzupełnienia. Odpowiedź jest ograniczona do 16,000 tokenów na żądanie, chyba że określisz niższy max_tokens wartości.

Copycurl https://api.hereticproject.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list dependencies for node project"}]
  }'

Integracja SDK Python

Użyj oficjalnej biblioteki Python OpenAI z niestandardowym URL bazowym. Ustaw api_key do swojego ciągu API. Skonfiguruj base_url wskazać na serwer projektu Heretic. Pozwala to na użycie znanych metod, takich jak chat.completions.create() bez istotnej zmiany struktury istniejącego kodu.

Zainstaluj bibliotekę za pomocą pip. Przekaż swoje dane uwierzytelniające bezpośrednio do inicjalizacji klienta. Biblioteka automatycznie obsługuje serializację. Podejście to działa zarówno w przepływach pracy synchronicznych, jak i asynchronicznych. Upewnij się, że obsługujesz potencjalne błędy sieciowe w sposób zgrany.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.hereticproject.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 SDK Node

SDK Node.js działa identycznie jak wersja Pythona. Zainicjuj klienta swoim kluczem API i poprawnym URL bazowym. Możesz wysyłać żądania completion używając tych samych sygnatur metod. Zapewnia to spójność w różnych częściach Twojego stosu technologicznego.

Obsłuż odpowiedzi asynchronicznie. SDK strumieniuje dane, jeśli użyjesz metody strumieniowania. W przeciwnym razie zwraca pełną odpowiedź JSON. Ta elastyczność obsługuje zarówno przetwarzanie wsadowe, jak i interfejsy w czasie rzeczywistym. Chroń swój klucz API w zmiennych środowiskowych.

Copyimport OpenAI from "openai";

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

Odpowiedzi strumieniowe (SSE)

Włącz strumieniowanie, ustawiając stream: true w Twoim żądaniu. Serwer wysyła Zdarzenia Wysyłane przez Serwer (SSE). Każdy chunk zawiera częściowe aktualizacje tekstu. Zmniejsza to postrzeganą latencję dla użytkowników końcowych. Dane dotyczące zużycia tokenów pojawiają się w ostatnim chunku strumienia.

Przetwarzaj każdy obiekt delta, aby zsumować pełną odpowiedź. Przestań nasłuchiwać, gdy strumień się zamknie lub wystąpi błąd. Metoda ta jest idealna dla interfejsów czatu. Pozwala użytkownikom widzieć formujące się myśli w czasie rzeczywistym. Nakłady są minimalne w porównaniu do pełnych odpowiedzi.

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)

Limity, Błędy i Kontekst

Szczegółowo przestrzegaj limitów szybkości, aby uniknąć przerw w usłudze. Masz do dyspozycji 300 żądań na minutę na klucz. Współbieżność ograniczona jest do 8 jednoczesnych żądań. Ciało żądania nie może przekraczać 8 MB. Przekroczenie tych limitów zwraca kod statusu 429. Poczekaj krótko przed ponowną próbą.

Niepowodzenia uwierzytelniania zwracają błąd 401. Dzieje się tak, jeśli klucz jest nieprawidłowy lub wygasł. Błąd 402 wskazuje na niewystarczające środki w koncie z góry opłaconym. Błędy przy pomyłkach zwrotu środków są obsługiwane na stronie Wsparcie. Kredyta nigdy nie wygasa. Model odmawia treści dotyczących małoletnich. Pozostała treść prawna jest akceptowana.