API-dokumentation: Quickstart Guide

Base URL og autentificering

Heretic AI API er fuldt ud OpenAI-kompatibel. Du interagerer med det ved at pege din klient mod vores base URL: https://api.hereticai.cc/v1. Autentifikation afhænger af en enkelt API-nøgle pr. konto, der genereres øjeblikkeligt ved tilmelding via Google eller e-mail. Send denne nøgle i Authorization header som en Bearer-token. Modelidentifikatoren er blot uncensored. Denne enkelt model håndterer alle dine anmodninger uden routing-kompleksitet. Fejl som 401 indikerer en ugyldig nøgle, mens 402 betyder, at du har brug for mere forudbetalt krypto-kredit.

Copycurl https://api.hereticai.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "generate twenty test cases"}]
  }'

Chat Completions Endpoint

Send tekstrequests ved hjælp af POST /v1/chat/completions endpoint. API'et forventer en standard messages-array, der indeholder din samtalehistorik eller prompt. Den returnerer genereret tekst i choices array. Dette er et rent utility-API: tekst ind, tekst ud. Du betaler kun for forbrugte tokens. Forudbetalt kredit udløber aldrig, og afvisninger eller fejl koster ikke tokens. Denne tilgang eliminerer abonnementslåsninger og uforudsigelige gratis niveauer.

Copyfrom openai import OpenAI

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

Streaming-svar (SSE)

Aktivér realtidsstreaming af tokens ved at indstille stream: true i din anmodning. API'et returnerer Server-Send Events (SSE) for hvert genereret token. Dette giver dig mulighed for at vise output progressivt, hvilket er afgørende for latensfølsomme applikationer. Tokenforbrugsstatistikker vises i den sidste chunk af streamen. Denne funktion virker sømløst med standard OpenAI SDK'er, der håndterer SSE automatisk. Det giver øjeblikkelig feedback uden at vente på den fulde færdiggørelse.

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)

Function Calling og værktøjer

API'en understøtter function calling med tools og tool_choice parametre. Definer dine værktøjs-skemaer i anmodningen, og modellen vil returnere strukturerede funktionskald, når det er passende. Dette muliggør komplekse arbejdsgange, hvor LLM'en afgør, hvilken handling der skal udføres næste gang. Du kan tvinge specifik værktøjsbrug eller lade modellen vælge frit. Denne funktion er essentiel til at bygge agentic applikationer, der interagerer med eksterne systemer eller databaser.

JSON-tilstand

Sikr deterministisk output ved at indstille response_format til {"type": "json_object"}. Modellen vil begrænse sit svar til gyldig JSON, hvilket er afgørende for programmatisk parsing. Dette reducerer behovet for efterbehandling med regex-fiks. Det garanterer, at outputtet kan konsumeres direkte af din kode. Dette er særligt nyttigt til struktureret dataudtrækning eller konfigurationsgenerering.

Parameters and Limits

Styr genereringen med standardparametre som temperature, top_p, og seed. Kontekstvinduet er 100.000 tokens for prompt plus completion. Maks output er 16.000 tokens pr. anmodning, eller 2.048 hvis max_tokens er ikke indstillet. Hastighedsbegrænsninger er 300 anmodninger i minuttet og 8 samtidige anmodninger pr. nøgle. Anmodningskroppen skal holdes under 8 MB. Disse grænser sikrer stabil høj volumen-brug til udviklere.

Node.js

Copyimport OpenAI from "openai";

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