API-hurtigstart & integration

Base URL og autentificering

Heretic Project leverer ét enkelt, hosted endepunkt til tekstgenerering. Brug https://api.hereticproject.com/v1 som din base URL. Autentificeringen baseres på et bearer-token overført via Authorization header. Opret din nøgle ved at logge ind med Google eller e-mail på dashboardet. Systemet udsteder én aktiv nøgle pr. konto; generering af en ny nøgle ugyldiggør den forrige straks.

Du betaler kun for forbrugte tokens. Fejl og afvisninger belaster ikke din forudbetalte kredit. En ny konto modtager $0,50 i prøvekræditter, der er gyldige i syv dage. Du opdaterer ved hjælp af USDT (TRC20) eller USDC (Base) i beløb mellem $20 og $500.

Endpointet /v1/chat/completions

Send beskeder til standard chat-completions-endepunktet. Model-id er uncensored. Den accepterer en liste af message-objekter med roller som system, user, eller assistant. Modellen afviser ikke lovligt voksen-, fiktivt eller kontroversielt indhold. Det er en open-weight model, der er finjusteret til direkte svar.

Anmodninger returnerer et JSON-objekt, der indeholder den genererede tekst. Context-vinduet understøtter 100,000 tokens kombineret for prompt og completion. Outputtet er begrænset til 16,000 tokens pr. anmodning, medmindre du angiver en lavere max_tokens værdi.

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"}]
  }'

Python SDK-integration

Brug det officielle OpenAI Python-bibliotek med en tilpasset base-URL. Indstil api_key til din API-streng. Konfigurér base_url til at pege på Heretic Project-serveren. Dette giver dig mulighed for at bruge kendte metoder som chat.completions.create() uden at modificere din eksisterende kodestruktur betydeligt.

Installer biblioteket via pip. Overfør dine legitimationsoplysninger direkte til klientinitialiseringen. Biblioteket håndterer serialisering automatisk. Denne tilgang fungerer til både synkrone og asynkrone arbejdsgange. Sørg for at håndtere potentielle netværksfejl elegant.

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)

Node SDK-integration

Node.js SDK fungerer identisk som Python-versionen. Initialiser klienten med din API-nøgle og den korrekte base-URL. Du kan sende completion-anmodninger ved hjælp af de samme metodesignaturer. Dette sikrer konsistens på tværs af forskellige dele af din stack.

Håndter svar asynkront. SDK'et streamer data, hvis du bruger streaming-metoden. Ellers returneres det fulde JSON-respons. Denne fleksibilitet understøtter både batch-behandling og real-time grænseflader. Hold din API-nøgle sikker i miljøvariabler.

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);

Streaming-svar (SSE)

Aktivér streaming ved at indstille stream: true i din anmodning. Serveren sender Server-Sent Events (SSE). Hver chunk indeholder delvise tekstopdateringer. Dette reducerer den opfattede forsinkelse for slutbrugere. Tokenforbrugsdata vises i den sidste chunk af streamet.

Behandle hvert delta-objekt for at akkumulere det fulde svar. Stop med at lytte, når streamet lukker, eller der opstår en fejl. Denne metode er ideel til chatgrænseflader. Den gør det muligt for brugere at se tanker danne sig i realtid. Overheadet er minimal sammenlignet med fulde svar.

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)

Begrænsninger, fejl og kontekst

Respekter rate-limited for at undgå tjenesteafbrydelser. Du har tilladelse til 300 anmodninger i minuttet pr. nøgle. Konkurrencekapaciteten er begrænset til 8 samtidige anmodninger. Anmodningskroppen kan ikke overstige 8 MB. En overskridelse af disse grænser returnerer en 429-statuskode. Vent kort, før du prøver igen.

Autentificeringsfejl returnerer en 401-fejl. Dette sker, hvis nøglen er ugyldig eller udløbet. En 402-fejl indikerer utilstrækkelig forudbetalt kredit. Fejl i refusion håndteres via Support-siden. Kredit udløber aldrig. Modellen afviser indhold, der involverer mindreårige. Alt andet lovligt indhold accepteres.