Snabbstart: Integrera apertus ai chat

Förutsättningar och installation

Skapa ett konto och hämta din API-nyckel. Registrera dig med Google eller ett e-postlösenord på sidan för nyckelgenerering. Systemet visar din nyckel omedelbart, så du kan kopiera den utan dröjsmål. Inget telefonnummer krävs för registreringen. Du får $0.50 i provkredit som är giltig i 7 dagar, så du kan testa anslutningen utan att lägga till medel.

Konfigurera din miljövariabel eller SDK-klient att peka mot rätt bas-URL. Denna URL fungerar med standard OpenAI-bibliotek. Ändra bara bas-URL:en och din nyckel. Modell-ID:t är "uncensored". Denna enda slutpunkt hanterar alla textkompletteringar. Du behöver inte hantera routing eller välja mellan olika modeller.

Se till att ditt klientbibliotek stöder OpenAI Chat Completions-protokollet. De flesta moderna SDK:er fungerar direkt. Verifiera att ditt nätverk tillåter utgående HTTPS-begäranden. Tjänsten accepterar standard JSON-last. Inga speciella headrar krävs utöver autentisering.

Autentisering med API-nycklar

Skicka ditt API-nyckel i Authorization-huvudet för varje begäran. Använd Bearer-schemat följt av din nyckelsträng. Tjänsten validerar nyckeln mot ditt konto. Ogiltiga nycklar returnerar ett 401 Unauthorized-fel. Utgångna eller otillräckliga medel utlöser ett 402 Payment Required-svar. Kontrollera din balans i kontrollpanelen om begäranden misslyckas.

Håll din nyckel säker. Varje konto har en aktiv nyckel. Att generera en ny nyckel gör att den tidigare blir ogiltig. Dela inte din nyckel i offentliga arkiv. API-nyckeln är den enda identifieraren för din användning. Hastighetsbegränsningar gäller per nyckel, inte per konto.

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

Autentiseringen är stateless. Servern kontrollerar token vid varje anrop. Om du roterar din nyckel, uppdatera alla körande klienter omedelbart. Utbliven header resulterar i omedelbar avvisning. Felmeddelandet anger tydligt autentiseringsfelet.

Skicka din första förfrågan

Skicka en POST-begäran till chat-completions-slutpunkten. Inkludera modell-ID:t "uncensored" och din meddelandehistorik. API:et returnerar ett text-svar. Du kan strömma utdata eller vänta på hela slutförandet. Varje begäran förbrukar in- och utdatatokens. Fel tar inte ut kredit. Avslag är 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)

Svaret inkluderar användningsstatistik. Spåra tokenförbrukning för att hantera ditt förbetalda kredit. Modellen svarar utan innehållsrefus för laglig vuxenanvändning. Du kan skicka systemprompter för att definiera beteende. Användarmeddelanden driver samtalet. Kontextrutan stödjer totalt 100 000 tokens.

Börja med en enkel tvåmeddelande-utbyte. Detta verifierar anslutning och svarskvalitet. Justera temperatur och top_p för kreativa eller precisa utdata. API:et stöder standardparametrar. Stop-sekvenser fungerar som förväntat. Seed-värden säkerställer reproducerbara resultat.

Strömningsresponser via SSE

Aktivera strömning genom att ställa in stream-parametern till true. API:et returnerar Server-Sent Events (SSE) istället för ett enda JSON-objekt. Varje chunk innehåller en del av den genererade texten. Läs chunks tills strömmen slutar. Den sista chunken innehåller total tokenanvändning.

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)

Strömning minskar den upplevda latensen. Användare ser text dyka upp i realtid. Detta är idealiskt för chattgränssnitt. Hantera delvis tokens noggrant. Klistra ihop bitar för att bilda hela svaret. Servern stänger anslutningen när genereringen är klar.

Övervaka strömningsfel. Nätverksavbrott kan avbryta strömmen. Implementera anslutningslogik vid behov. API:t skickar inte tillbaka historik. Starta en ny begäran om strömmen misslyckas. Tokenräkningar i den sista biten speglar hela genereringen.

Hantering av parametrar och lägen

Använd standardparametrar för att styra genereringen. Ställ in temperatur för slumpmässighet. Justera top_p för kärnprovtagning. Definiera stoppsekvenser för att avbryta genereringen i förtid. Ange en seed för deterministiska utdata. Aktivera JSON-läge genom att ställa in response_format till json_object. Modellen returnerar giltig JSON när det begärs.

Function calling stöds. Definiera verktyg i begäran. Modellen returnerar verktygsanrop när det är lämpligt. Parsa verktygsargumenten i din kod. Skicka tillbaka resultat för att fortsätta samtalet. Detta möjliggör komplexa agentflöden.

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 begränsar längden på output. Standard är 2 048 tokens. Ange ett högre värde vid behov. Den hårda gränsen per begäran är 16 000 tokens. Kontextfönstret är 100 000 tokens. Planera längden på din historik därefter. Frekvens- och närvaropenaliteter hjälper till att minska repetition.

Förstå gränser och fel

Rate limits skyddar tjänstestabiliteten. Du kan skicka 300 förfrågningar per minut. Samtidighet är begränsad till åtta parallella förfrågningar per nyckel. Begärande kroppar får inte överstiga 8 MB. Att överskrida gränserna returnerar ett 429 Too Many Errors-fel. Vänta innan du upprepar.

Kontrollera felkoder för diagnostik. 401 betyder ogiltig eller saknad nyckel. 402 indikerar otillräckligt förbetalt kredit. Ladda upp via crypto för att återuppta tjänsten. 429 signalerar rate limiting. 400 betyder dålig begärandesyntax. Granska felmeddelandet för detaljer.

Hantering av kontextfönstret är avgörande. Summera prompt- och completion-token. Håll dig långt under 100 000 token. Klipp bort gamla meddelanden vid behov. API:et klipper inte automatiskt. Du styr längden på historiken. Effektiv kontextanvändning minskar kostnaderna.