Apertus ia API Documentation

1. Quickstart: Connect Your First Request

De base URL is https://api.apertusia.com/v1. Geef je API-sleutel op in de Authorization-header. De modelidentifier is uncensored. Deze setup werkt met elke OpenAI-compatible client.

Gebruik dit cURL-commando om de verbinding onmiddellijk te testen. Vervang YOUR_API_KEY door uw eigen sleutel.

Copycurl https://api.apertusia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 5 python libraries for web scraping"}]
  }'

Authenticatiefouten retourneren 401. Onvoldoende saldo retourneren 402. Snelheidslimieten retourneren 429.

2. Ondersteunde parameters: Temperature, Top P en Seed

Beheer willekeur met temperature, diversiteit met top_p en reproduceerbaarheid met seed. Deze parameters volgen de standaard OpenAI-conventies. Stel temperature in op 0.7 voor een evenwichtige output of 1.0 voor meer creativiteit. Gebruik top_p om het sampling te beperken tot de hoogste waarschijnlijkheidsmassa. Met de parameter seed worden identieke outputs gegarandeerd voor foutopsporing.

Voorbeeld Python-snippet voor lokale tests:

Copyfrom openai import OpenAI

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

3. Streamende antwoorden met Server-Sent Events

Schakel streaming in door stream: true in te stellen. De API retourneert chunks via Server-Sent Events. Elke chunk bevat gedeeltelijke tekst en tokenverbruiksgegevens. Dit vermindert de waargenomen latentie voor lange antwoorden. Verwerk SSE-gebeurtenissen om je UI in realtime bij te werken.

Node.js-voorbeeld met de officiële SDK:

Copyimport OpenAI from "openai";

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

4. Function Calling en JSON-modusconfiguratie

Gebruik response_format met {"type": "json_object"} voor strikte JSON-uitvoer. Dit zorgt voor gestructureerde data voor programmatische pipelines. Schakel function calling in door een tools-array in het request body op te geven. Het model zal tool calls retourneren in het verwachte formaat. Gebruik tool_choice om specifiek gedrag af te dwingen.

5. Snelheidsbeperkingen en beperkingen voor de grootte van verzoeken

Elke API-sleutel ondersteunt 300 verzoeken per minuut. Gelijktijdige verzoeken zijn beperkt tot 8 per sleutel. De maximale grootte van de request body is 8 MB. Het contextvenster biedt plaats aan 100,000 tokens in totaal. De maximale output per verzoek is tot het volledige venster van 100,000 tokens. Laat max_tokens ongespecificeerd of stel het hoog in om truncatie te voorkomen. Fouten verbruiken geen tegoed. Restituties worden niet uitgegeven, maar facturatiefouten worden gecorrigeerd via Support.

6. Authenticatie en foutafhandeling

Genereer je sleutel via het dashboard. Gebruik Google-inlog of e-mail. De sleutel verschijnt onmiddellijk. Voeg deze toe aan de Authorization: Bearer header. Ongeldige sleutels retourneren 401. 429-fouten geven aan dat de rate limit is bereikt. 402-fouten betekenen dat je vooruitbetaalde tegoed op is. Laad op met USDT of USDC. Credits vervallen nooit.

Streaming

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)