API Documentatie

Basis-URL en authenticatie

Verbind je applicatie door te verwijzen naar ons toegewijde eindpunt en je unieke API-sleutel mee te sturen. De basis-URL voor alle verzoeken is https://api.apertusapp.com/v1. Je verkrijgt je sleutel direct na het aanmelden via Google of e-mail op de API-sleutel ophalen pagina. Voeg deze sleutel toe aan de Authorization header voor elk verzoek.

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

Elk account genereert één actieve sleutel. Als je een nieuwe sleutel genereert, wordt de vorige onmiddellijk ongeldig. Dit zorgt voor strakke controle over je toegang zonder abonnementslagen of inactieve kosten.

Eerste verzoek

Verstuur je eerste prompt naar het chat-completions-eindpunt om ruwe, ongefilterde tekst te ontvangen. Gebruik de model-ID uncensored toegang tot ons specifieke open-weight model dat is afgestemd op wettig volwassen en controversiële onderwerpen.

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)

De API accepteert standaard parameters zoals temperature en top_p. Fouten en weigeringen verbruiken geen tokens, dus u betaalt alleen voor wat het model daadwerkelijk bereikt. Deze aanpak houdt de kosten voorspelbaar in vergelijking met aggregators die rekenen voor routeringskosten.

Node SDK-integratie

Gebruik de officiële Node SDK om JSON-modus en function calling efficiënt af te handelen. Stel response_format naar {"type": "json_object"} voor gestructureerde uitvoer of definieer tools voor agent-achtig gedrag.

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

Het model ondersteunt toolaanroepen met tool_choice opties. Je kunt ook een seed voor deterministische resultaten. Deze flexibiliteit stelt je in staat complexe applicaties te bouwen zonder de OpenAI-compatible ecosystem te verlaten.

Streaming responses

Stream tokens in realtime met behulp van Server-Sent Events (SSE) voor ervaringen met lage latentie. Elke chunk bevat de gegenereerde tekst en de laatste chunk bevat totale tokengebruikstatistieken.

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 vermindert de waargenomen latentie voor eindgebruikers. Je kunt de stream onderbreken als de gebruiker van gedachten verandert. De API verwerkt het SSE-protocol automatisch, waardoor er minimaal code aan je kant nodig is.

Contextvenster en capaciteit

Het model ondersteunt een contextvenster van 100.000 tokens voor zowel invoer als uitvoer samen. U kunt maximaal 16.000 tokens per verzoek opgeven, of terugvallen op 2.048 tokens als u max_tokens.

Dit grote venster stelt je in staat uitgebreide documentanalyse of lange gespreksgeschiedenis te verwerken. Houd echter de verzoeklichamen onder de 8 MB. Het model is geen GPT of Llama; het is een distinct ongecensureerd AI-model geoptimaliseerd voor jouw specifieke use case.

Fouthantering en limieten

Verwerk standaard HTTP-fouten soepel om een robuuste applicatieflow te behouden. Een 401 fout wijst op een ongeldige of ontbrekende API-sleutel. Een 402 fout betekent dat je vooruitbetaalde tegoed op is. Een 429 fout signaleert dat je de limiet van 300 verzoeken per minuut of 8 gelijktijdige verzoeken hebt overschreden.

Krediet vervalt nooit, dus je kunt gebruik pauzeren en later hervatten. Fouten zoals dubbele afschrijvingen worden opgelost via de Support-pagina. Vooruitbetaald krediet wordt alleen in rekening gebracht voor daadwerkelijk tokenverbruik, wat zorgt voor transparante prijzen voor elke byte.