Apertus ia API Documentation

1. Quickstart: Connect Your First Request

Bas-URL:en är https://api.apertusia.com/v1. Ange din API-nyckel i Authorization-huvudet. Modell-ID:t är uncensored. Denna konfiguration fungerar med alla OpenAI-kompatibla klienter.

Använd den här cURL-kommandot för att testa anslutningen omedelbart. Ersätt YOUR_API_KEY med din faktiska nyckel.

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

Autentiseringsfel returnerar 401. Otillräckligt saldo returnerar 402. Hastighetsbegränsningar returnerar 429.

2. Stödda parametrar: Temperatur, Top P och Seed

Styr slumpmässigheten med temperature, mångfalden med top_p och reproducerbarheten med seed. Dessa parametrar följer standardkonventioner från OpenAI. Ställ in temperature till 0.7 för en balanserad utdata eller 1.0 för högre kreativitet. Använd top_p för att begränsa urvalet till den högsta sannolikhetsmassan. Parametern seed säkerställer identiska utdata för felsökning.

Exempel på Python-snutt för 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-sända händelser

Aktivera strömning genom att ställa in stream: true. API:et returnerar bitar via Server-Sent Events. Varje bit innehåller delvis text och tokenanvändningsdata. Detta minskar den upplevda latensen för långa svar. Hantera SSE-händelser för att uppdatera ditt gränssnitt i realtid.

Node.js-exempel med det officiella 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. Funktionssamling och JSON-lägeskonfiguration

Använd response_format med {"type": "json_object"} för strikt JSON-utdata. Detta säkerställer strukturerad data för programmeringspipelines. Aktivera funktionsanrop genom att ange en tools-matris i begärans kropp. Modellen returnerar verktygsanrop i förväntat format. Använd tool_choice för att tvinga fram specifikt beteende.

5. Begränssningar för begärandefrekvens och begärandestorlek

Varje API-nyckel stödjer 300 anrop per minut. Samtidiga anrop är begränsade till 8 per nyckel. Den maximala storleken på begärans kropp är 8 MB. Kontextrutan rymmer totalt 100,000 tokens. Maximal utdata per anrop är upp till hela 100,000-token-rutan. Lämna max_tokens oinställt eller ange ett högt värde för att undvika avklippning. Fel förbrukar inte kredit. Återbetalningar utfärdas inte, men felpåfrestningar korrigeras via Support.

6. Autentisering och hantering av fel

Skapa din nyckel via kontrollpanelen. Använd Google-inloggning eller e-post. Nyckeln visas omedelbart. Lägg till den i Authorization: Bearer-huvudet. Ogiltiga nycklar returnerar 401. 429-fel indikerar att rate limit har uppnåtts. 402-fel betyder att ditt förbetala kredit är slut. Ladda upp med USDT eller USDC. Krediterna löper aldrig ut.

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)