Apertus ia API Documentation

1. Quickstart: Connect Your First Request

Base-URL'en er https://api.apertusia.com/v1. Angiv din API-nøgle i Authorization-headeren. Modelidentifikatoren er uncensored. Denne opsætning fungerer med enhver OpenAI-kompatibel klient.

Brug denne cURL-kommando til at teste forbindelsen med det samme. Erstat YOUR_API_KEY med din faktiske nøgle.

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

Autentikeringsfeil returnerer 401. Utilstrækkelige midler returnerer 402. Rate limits returnerer 429.

2. Understøttede parametre: Temperatur, Top P og Seed

Styr tilfældighed med temperature, diversitet med top_p og reproducerbarhed med seed. Disse parametre følger standard OpenAI-konventioner. Indstil temperature til 0,7 for en afbalanceret output eller 1,0 for højere kreativitet. Brug top_p til at begrænse stikprøvetagning til den øverste sandsynlighedsmasse. seed-parameteren sikrer identiske outputs til fejlfinding.

Eksempel på Python-udsnit til lokal testning:

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. Streaming-svar med Server-sendte begivenheder

Aktivér streaming ved at indstille stream: true. API'et returnerer chunks via Server-Sent Events. Hver chunk indeholder delvis tekst og tokenforbrugsdata. Dette reducerer den opfattede latens for lange svar. Håndter SSE-events for at opdatere dit UI i realtid.

Node.js-eksempel med det officielle 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. Konfiguration af funktionssamtaler og JSON-tilstand

Brug response_format med {"type": "json_object"} for streng JSON-output. Dette sikrer struktureret data til programmeringspipelines. Aktiver funktionssamtale ved at angive en tools-array i request-body. Modellen vil returnere værktøbskald i det forventede format. Brug tool_choice til at tvinge specifik adfærd.

5. Ratebegrænsninger og begrænsninger for forespørgselstørrelse

Hver API-nøgle understøtter 300 anmodninger i minuttet. Samtidige anmodninger er begrænset til 8 pr. nøgle. Den maksimale størrelse for anmodningskroppen er 8 MB. Kontekstvinduet rummer i alt 100,000 tokens. Maks output pr. anmodning er op til det fulde 100,000-token vindue. Lad max_tokens være uindstillet, eller indstil det højt, for at undgå afkortning. Fejl forbruger ikke kredit. Refunderinger udstedes ikke, men faktureringsfejl rettes via Support.

6. Autentificering og fejlhåndtering

Generer din nøgle via dashboardet. Brug Google-login eller e-mail. Nøglen vises øjeblikkeligt. Inkluder den i Authorization: Bearer-headeren. Ugyldige nøgler returnerer 401. 429-fejl indikerer, at rate limit er udtømt. 402-fejl betyder, at din forudbetalte kredit er udtømt. Opfyld med USDT eller USDC. Kreditter udløber aldrig.

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)