API-dokumentation för obegränsade chattkompletteringar

Snabbstart: Anslut med Python eller JavaScript

Anslut till API:t genom att uppdatera din bas-URL och ange din API-nyckel. Slutpunkten accepterar standard chat-completion-begäranden och returnerar text. Du behöver inte installera anpassade bibliotek om du använder officiella OpenAI SDK:er, eftersom gränssnittet matchar deras specifikation exakt.

Börja med en enkel HTTP-förfrågan för att verifiera anslutningen. Använd curl-kommandot nedan för att skicka en grundläggande prompt till uncensored modellen. Ersätt YOUR_API_KEY med nyckeln som genererats på ditt dashboard.

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

För Python-utvecklare är processen nästan identisk. Initiera klienten med din nyckel och korrekt bas-URL. Detta säkerställer att alla begäranden dirigeras genom våra icke-censurerade servrar samtidigt som kompatibiliteten med befintlig verktygslåda upprätthålls.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.aiplayrolebest.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)

JavaScript-användare kan uppnå samma resultat med Node SDK. Ställ in baseURL egenskap till vår slutpunkt. Detta tillvägagångssätt gör att du kan integrera API:et i webbservern eller backend-tjänster med minimala kodändringar.

Copyimport OpenAI from "openai";

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

Autentisering och hantering av API-nycklar

Autentiseringen bygger på en enda API-nyckel som skickas i headern. Skicka denna nyckel i Authorization header för varje begäran. Om nyckeln saknas eller är ogiltig returnerar API:et ett 401-fel omedelbart. Detta säkerställer säker åtkomst till ditt förbetala kredit.

Generera din nyckel på kontrollpanelen. Nyckeln visas en gång vid skapandet. Förvara den säkert i dina miljövariabler. Dela den inte offentligt. Varje konto stöder en aktiv nyckel i taget. Att generera en ny nyckel ogiltigförklarar den tidigare omedelbart.

Använd nyckeln i dina begäran så här: Authorization: Bearer YOUR_API_KEY. Detta standardhuvudformat fungerar med alla stora SDK:er. Ha din nycker redo för snabb iteration under utvecklingen.

Parametrar för slutpunkten för chattkomplettering

Skicka begäran till /v1/chat/completions endpoint. Inkludera din messages-array och ange modellen till uncensored. Du kan justera parametrar som temperature och top_p för att styra kreativitet. Högre värden ger mer varierade svar.

Ställ in max_tokens att begränsa utdatalängd. Standardvärdet är 2 048 tokens om det inte anges. Modellen stöder en kontextruta på 100 000 tokens för prompt plus komplettering. Detta möjliggör långa konversationer utan trunkering. Justera presence_penalty och frequency_penalty för att minska repetition i rollspelscenario.

Använd den stop parameter för att avbryta genereringen vid specifika fraser. Detta hjälper till att upprätthålla dialogstruktur. The seed parameter säkerställer reproducerbara utdata för testning. Dessa verktyg ger dig exakt kontroll över modellens beteende.

Strömsvaren och användningsdata

Aktivera strömning genom att ställa in stream: true i ditt begäran. API:et returnerar textbitar när de genereras. Detta minskar den upplevda latensen för slutanvändare. Varje bit innehåller delvis text och metadata.

Användningsdata visas i den sista chunken. Detta inkluderar antal tokens för in- och utdata. Kontrollera usage field in the last response object. This allows accurate billing verification without separate API calls. Track token consumption in real-time.

Hantera strömavbrott noggrant. Se till att du bearbetar alla bitar innan du stänger anslutningen. Den sista biten innehåller komplett användningsstatistik. Denna data är viktig för övervakning av kostnader och prestanda i produktionsapplikationer.

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)

Felfhantering och hastighetsbegränsningar

API:et begränsar till 300 förfrågningar per minut per nyckel. Samtidiga förfrågningar är begränsade till åtta per nyckel. Förfrågningskroppen får inte överstiga 8 MB. Att överskrida dessa gränser returnerar ett 429-fel. Implementera exponentiell backoff för att hantera tillfälliga toppar.

Vanliga fel inkluderar 401 för ogiltiga nycklar och 402 för otillräcklig kredit. Ett 402-svar indikerar att din förbetalda balans är slut. Ladda upp ditt konto för att återuppta tjänsten. Fel konsumerar inte tokens, så att försöka igen efter att ha åtgärdat problemet är gratis.

Kontrollera svarsbodyn för detaljerade felmeddelanden. API:t returnerar ett JSON-objekt med en feltyp och ett meddelande. Använd denna information för att felsöka problem snabbt. Korrekt felhantering säkerställer en smidig upplevelse för dina användare under perioder med hög trafik.

JSON-läge och funktionsanrop-guide

Använd JSON-läge genom att ställa in response_format för {"type": "json_object"}. Detta tvingar modellen att returnera giltig JSON. Idealiskt för extrahering av strukturerad data eller API-svar. Se till att din prompt beskriver önskad schema tydligt.

Function calling gör att modellen kan anropa verktyg. Definiera verktyg i request body. Modellen returnerar verktygsanrop när det är lämpligt. Hantera dessa anrop i din applikationslogik. Detta möjliggör komplexa flerstegsarbetsflöden.

Kombinera JSON-läge med funktionsanrop för robusta integrationer. Validera JSON-utdata på klienten. Använd tool_choice parameter för att styra när funktioner anropas. Denna flexibilitet stöder olika applikationsarkitekturer. Se till att dina verktyg är väldefinierade för optimal prestanda.

Modellinformation och begränsningar för kontextfönster

The uncensored modellen stödjer ett kontextfönster på 100 000 tokens. Detta inkluderar både inmatningsprompten och utmatningskompletteringen. Maximal utmatning är 16 000 tokens per begäran. Detta möjliggör omfattande rollspels-scenarier utan att avbryta mitt i en mening.

Modellen har öppna vikter och är justerad för obegränsat innehåll. Den vägrar inte lagliga vuxna ämnen. Det är inte GPT, Claude eller någon annan leverantörs modell. Förfrågningar bearbetas på våra dedikerade servrar. Detta säkerställer konsekvent prestanda och låg latens.

Övervaka kontextanvändningen för att hålla dig inom gränserna. API:t spårar tokenanvändningen noggrant. Fel och avslag förbrukar inte tokens. Detta transparenta faktureringsmodell hjälper dig att förutse kostnader. Planera dina kontextfönster för att maximera värdet.