API Dokumentation

Base URL og autentificering

Forbind din applikation ved at pege på vores dedikerede endpoint og sende din unikke API-nøgle. Base URL til alle anmodninger er https://api.apertusapp.com/v1. Du opnår din nøgle straks efter tilmelding via Google eller e-mail på Få API-nøgle side. Inkluder denne nøgle i Authorization header til hver anmodning.

Copycurl https://api.apertusapp.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run curl test with empty headers"}]
  }'

Hver konto genererer én aktiv nøgle. Hvis du genererer en ny nøgle, bliver den tidligere nøgle øjeblikkelig ugyldig. Dette sikrer stram kontrol over din adgang uden abonnementstier eller inaktive gebyrer.

Første anmodning

Send din første prompt til chat-completions endpoint for at modtage rå, ufiltreret tekst. Brug model-ID uncensored til at få adgang til vores specifikke open-weight model indstillet til lovlig voksen og kontroversielle emner.

Copyfrom openai import OpenAI

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

API'en accepterer standardparametre som temperature og top_p. Fejl og afvisninger forbruger ikke tokens, så du betaler kun for det, der faktisk når modellen. Denne tilgang holder omkostningerne forudsigelige sammenlignet med aggregators, der opkræver for rutningsoverhead.

Node SDK-integration

Brug det officielle Node SDK til at håndtere JSON-tilstand og funktionkald effektivt. Indstil response_format til {"type": "json_object"} til strukturerede outputs eller definere værktøjer til agent-lignende adfærd.

Copyimport OpenAI from "openai";

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

Modellen understøtter tool calls med tool_choice muligheder. Du kan også indstille en seed til deterministiske resultater. Denne fleksibilitet giver dig mulighed for at bygge komplekse applikationer uden at forlade det OpenAI-kompatible økosystem.

Streamingrespons

Stream tokens i realtid ved hjælp af Server-Sendte Begivenheder (SSE) til lav-latens brugeroplevelser. Hver chunk indeholder den genererede tekst, og den sidste chunk indeholder samlede tokenforbrugsstatistikker.

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)

Streaming reducerer opfattet latens for slutbrugere. Du kan afbryde streamen, hvis brugeren skifter mening. API'et håndterer SSE-protokollen automatisk og kræver minimal kode fra din side.

Kontekstvindue og kapacitet

Modellen understøtter et kontekstvindue på 100.000 tokens for både input og output tilsammen. Du kan angive op til 16.000 tokens pr. request, eller falde tilbage til 2.048 tokens, hvis du udelader max_tokens.

Dette store vindue muliggør omfattende dokumentanalyse eller lange samtalehistorier. Hold dog anmodningskroppe under 8 MB. Modellen er ikke GPT eller Llama; det er en distinkt ukensureret AI-model optimeret til dit specifikke brugstilfælde.

Fejlhåndtering og begrænsninger

Håndter standard HTTP-fejl pænt for at opretholde robust applikationsflow. En 401 fejl indikerer en ugyldig eller manglende API-nøgle. En 402 fejl betyder, at din forudbetalte kredit er opbrugt. En 429 fejl signalerer, at du har overskredet 300 forespørgsler i minuttet eller 8 samtidige forespørgsler.

Kredit udløber aldrig, så du kan pause forbruget og genoptage det senere. Fejl som dobbeltopkrævninger rettes via Support-siden. Forudbetalt kredit opkræves kun for faktisk tokenforbrug, hvilket sikrer gennemsigtig prissætning for hver byte.