Hurtig start: Integrer apertus ai chat

Forudsætninger og opsætning

Start med at oprette en konto og få din API-nøgle. Tilmeld dig med Google eller en e-mailadgangskode på siden til nøglegenerering. Systemet viser din nøgle med det samme, så du kan kopiere den uden forsinkelse. Intet telefonnummer er påkrævet for tilmelding. Du modtager $0.50 i prøvecredit, der er gyldig i syv dage, så du kan teste forbindelsen uden at tilføje midler.

Konfigurer din miljøvariabel eller SDK-klient til at pege på den korrekte base URL. Denne URL fungerer med standard OpenAI-biblioteker. Ændr kun base URL og dit nøgle. Model-ID er "uncensored". Dette enkelt endpoint håndterer alle tekstkompletteringer. Du behøver ikke at administrere routing eller vælge forskellige modeller.

Sørg for, at dit klientbibliotek understøtter OpenAI Chat Completions-protokollen. De fleste moderne SDK'er fungerer ud af boksen. Verificer, at dit netværk tillader udgående HTTPS-anmodninger. Tjenesten accepterer standard JSON-payloads. Der er ikke brug for specielle hoveder ud over autentificering.

Autentificering med API-nøgler

Indtast din API-nøgle i Authorization-headeren for hver anmodning. Brug Bearer-skemaet efterfulgt af din nøglestreng. Tjenesten validerer nøglen mod din konto. Ugyldige nøgler returnerer en 401 Unauthorized-fejl. Udløbne eller utilstrækkelige midler udløser en 402 Payment Required-svar. Tjek din saldo i dashboardet, hvis anmodninger fejler.

Hold din nøgle sikker. Hver konto har én aktiv nøgle. Generering af en ny nøgle ugyldiggør den tidligere. Del ikke din nøgle i offentlige arkiver. API-nøglen er den eneste identifikator for dit forbrug. Satsgrænser gælder per nøgle, ikke 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"}]
  }'

Autentificeringen er stateless. Serveren tjekker tokenet ved hvert kald. Hvis du roterer din nøgle, skal du opdatere alle kørende klienter øjeblikkeligt. Manglende header resulterer i øjeblikkelig afvisning. Fejlmeddelelsen angiver tydeligt autentificeringsfejlen.

Send din første anmodning

Send en POST-anmodning til chat-completions-endepunktet. Inkluder model-ID'et "uncensored" og din beskedhistorik. API'et returnerer en tekstrespons. Du kan streame outputtet eller vente på den fulde færdiggørelse. Hver anmodning forbruger input- og output-tokens. Fejl koster ikke kredit. Afvisninger er 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 indeholder forbrugsstatistikker. Sporing af tokenforbrug til styring af din forudbetalte kredit. Modellen svarer uden indholdsafvisninger til lovligt voksenbrug. Du kan sende systemprompter for at definere adfærd. Brugermeddelelser driver samtalen. Kontekstvinduet understøtter i alt 100,000 tokens.

Start med en simpel to-budskabsudveksling. Dette verificerer forbindelsen og svar kvaliteten. Juster temperatur og top_p for kreative eller præcise output. API'et understøtter standardparametre. Stopsekvenser fungerer som forventet. Seed-værdier sikrer reproducerbare resultater.

Streaming-svar via SSE

Aktivér streaming ved at indstille stream-parameteren til true. API'et returnerer Server-Sent Events (SSE) i stedet for et enkelt JSON-objekt. Hver chunk indeholder en del af den genererede tekst. Læs chunks, indtil streamen slutter. Den sidste chunk inkluderer totalt tokenforbrug.

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 reducerer den opfattede forsinkelse. Brugere ser tekst, der vises i realtid. Dette er ideelt til chatgrænseflader. Håndter delvise tokens omhyggeligt. Sammenkæd chunks for at danne det fulde svar. Serveren lukker forbindelsen, når genereringen er færdig.

Overvåg stream-fejl. Netværksafbrydelser kan afbryde streamen. Implementér forretningslogik, hvis det er nødvendigt. API'et gen sender ikke historik. Start en ny anmodning, hvis streamen fejler. Tokenantal i den sidste chunk afspejler hele genereringen.

Håndtering af parametre og tilstande

Brug standard parametre til at kontrollere generering. Indstil temperature for tilfældighed. Juster top_p for nucleus sampling. Definér stop-sekvenser for at afslutte genereringen tidligt. Send en seed for deterministiske output. Aktiver JSON-tilstand ved at indstille response_format til json_object. Modellen returnerer gyldig JSON, når der bedes om det.

Function calling understøttes. Definer værktøjer i anmodningen. Modellen returnerer værktøjskald, når det er passende. Parse værktøjsargumenterne i din kode. Send resultater tilbage for at fortsætte samtalen. Dette muliggør komplekse agent-arbejdsgange.

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ænser outputlængden. Standard er 2.048 tokens. Indstil en højere værdi, hvis det er nødvendigt. Den hårde grænse pr. anmodning er 16.000 tokens. Kontekstvinduet er 100.000 tokens. Planlæg din historiklængde derefter. Frekvens- og tilstedeværelsesstraffe hjælper med at reducere gentagelser.

Forståelse af begrænsninger og fejl

Rate limits beskytter tjenestestabiliteten. Du kan sende 300 anmodninger per minut. Concurrent er begrænset til otte samtidige anmodninger per nøgle. Anmodningskroppe må ikke overstige 8 MB. Hvis du overskrider grænserne, returneres en 429 Too Many Errors. Vent med at gentage.

Tjek fejlkode til diagnosticering. 401 betyder ugyldig eller manglende nøgle. 402 indikerer utilstrækkelig forudbetalt kredit. Tilføj kredit via crypto for at genoptage tjenesten. 429 signalerer rate-begrænsning. 400 angiver dårlig forespørgselssyntaks. Gennemgå fejlmeddelelsen for detaljer.

Håndtering af kontekstvinduet er afgørende. Tæl prompt- og completion-tokens. Hold dig langt under 100.000 tokens. Forkort gamle beskeder ved behov. API't forkorter ikke automatisk. Du styrer længden af historikken. Effektiv brug af kontekst reducerer omkostningerne.