Snelstart: integreer apertus ai chat

Vereisten en setup

Begin met het aanmaken van een account en het verkrijgen van uw API-sleutel. Meld u aan via Google of een e-mailwachtwoord op de pagina voor sleutelgeneratie. Het systeem toont uw sleutel onmiddellijk, zodat u deze zonder vertraging kunt kopiëren. Er is geen telefoonnummer nodig voor registratie. U ontvangt $0.50 aan proefkrediet dat zeven dagen geldig is, zodat u de verbinding kunt testen zonder geld toe te voegen.

Configureer uw omgevingsvariabele of SDK-client om naar de juiste basis-URL te wijzen. Deze URL werkt met standaard OpenAI-bibliotheken. Wijzig alleen de basis-URL en uw sleutel. De model-ID is "uncensored". Dit enkele eindpunt verwerkt alle tekstcompleties. U hoeft geen routing te beheren of verschillende modellen te selecteren.

Zorg ervoor dat uw clientbibliotheek het OpenAI Chat Completions-protocol ondersteunt. De meeste moderne SDK's werken direct. Verifieer of uw netwerk outbound HTTPS-verzoeken toestaat. De service accepteert standaard JSON-payloads. Er zijn geen speciale headers nodig naast authenticatie.

Authenticatie met API-sleutels

Voer uw API-sleutel in de Authorization-header in bij elk verzoek. Gebruik de Bearer-scheme gevolgd door uw sleutelreeks. De service valideert de sleutel tegen uw account. Ongeldige sleutels retourneren een 401 Unauthorized-fout. Verlopen of ontoereikende tegoeden triggeren een 402 Payment Required-respons. Controleer uw saldo in het dashboard als verzoeken mislukken.

Houd je sleutel veilig. Elk account heeft één actieve sleutel. Het genereren van een nieuwe sleutel maakt de vorige ongeldig. Deel je sleutel niet in openbare repositories. De API-sleutel is de enige identifier voor je gebruik. Snelheidslimieten gelden per sleutel, niet per account.

Copycurl https://api.apertusaichat.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set role to assistant"}]
  }'

Authenticatie is stateless. De server controleert het token bij elke aanroep. Als je je sleutel draait, update dan alle actieve clients direct. Het ontbreken van de header resulteert in directe afwijzing. De foutmelding geeft duidelijk de authenticatiefout aan.

Uw eerste verzoek verzenden

Stuur een POST-verzoek naar het chat-completies-eindpunt. Voeg de model-ID "uncensored" en je berichtgeschiedenis toe. De API retourneert een tekstantwoord. Je kunt de uitvoer streamen of wachten op de volledige voltooiing. Elk verzoek verbruikt input- en outputtokens. Fouten kosten geen tegoed. Weigeringen zijn gratis.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apertusaichat.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 respons bevat gebruikscijfers. Volg het tokenverbruik om je vooruitbetaalde tegoed te beheren. Het model beantwoordt zonder inhoudelijke weigeringen voor wettelijk volwassen gebruik. Je kunt systeemberichten verzenden om het gedrag te definiëren. Gebruikersberichten sturen het gesprek. Het contextvenster ondersteunt in totaal 100,000 tokens.

Begin met een eenvoudige tweegespreksuitwisseling. Dit verifieert connectiviteit en responskwaliteit. Pas temperatuur en top_p aan voor creatieve of precieze outputs. De API ondersteunt standaardparameters. Stopvolgorde werkt zoals verwacht. Seed-waarborgen zorgen voor reproduceerbare resultaten.

Streaming-responsen via SSE

Schakel streaming in door de stream-parameter in te stellen op true. De API retourneert Server-Sent Events (SSE) in plaats van een enkel JSON-object. Elke chunk bevat een deel van de gegenereerde tekst. Lees chunks totdat de stream eindigt. De laatste chunk bevat het totale tokengebruik.

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. Gebruikers zien tekst in realtime verschijnen. Dit is ideaal voor chatinterfaces. Verwerk gedeeltelijke tokens zorgvuldig. Voeg chunks samen om het volledige antwoord te vormen. De server sluit de verbinding wanneer de generatie klaar is.

Monitor streamfouten. Netwerkonderbrekingen kunnen de stream onderbreken. Implementeer reconnectielogica indien nodig. De API stuurt geschiedenis niet opnieuw. Start een nieuw verzoek als de stream faalt. Tokenaantallen in de laatste chunk reflecteren de volledige generatie.

Parameters en modi verwerken

Gebruik standaard parameters om de generatie te beheren. Stel temperature in voor willekeur. Pas top_p aan voor nucleus sampling. Definieer stop-reeksen om de generatie vroegtijdig te stoppen. Geef een seed door voor reproduceerbare uitvoer. Schakel de JSON-modus in door response_format in te stellen op json_object. Het model retourneert geldige JSON wanneer dit wordt gevraagd.

Function calling wordt ondersteund. Definieer tools in het verzoek. Het model retourneert toolaanroepen wanneer dit gepast is. Parseer de tool-argumenten in uw code. Geef resultaten terug om het gesprek voort te zetten. Dit maakt complexe agent-workflows mogelijk.

Copyimport OpenAI from "openai";

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

Max tokens beperken de uitvoerlengte. De standaardwaarde is 2.048 tokens. Stel een hogere waarde in indien nodig. De harde limiet per verzoek is 16.000 tokens. Het contextvenster is 100.000 tokens. Plan de lengte van je geschiedenis daarop af. Frequentie- en aanwezigheidsstraffen helpen herhaling te verminderen.

Limieten en fouten begrijpen

Rate limits beschermen de stabiliteit van de service. Je kunt 300 verzoeken per minuut verzenden. Concurrentie is beperkt tot acht gelijktijdige verzoeken per sleutel. Requestbody's mogen niet groter zijn dan 8 MB. Het overschrijden van limieten retourneert een 429 Too Many Errors. Wacht voordat je opnieuw probeert.

Controleer foutcodes voor diagnostiek. 401 betekent ongeldige of ontbrekende sleutel. 402 geeft aan dat er onvoldoende vooruitbetaald krediet is. Laad op via crypto om de service te hervatten. 429 signaleert snelheidsbeperking. 400 duidt op een foutieve aanvraagsyntaxis. Lees de foutmelding voor meer details.

Context windowbeheer is cruciaal. Tel de prompt- en completion-tokens op. Blijf ruim onder de 100.000 tokens. Knip oude berichten indien nodig. De API knipt niet automatisch. Jij bepaalt de lengte van de geschiedenis. Efficiënt contextgebruik verlaagt de kosten.