Snabbstart: integrera på några minuter

1. Installera din SDK

Börja med att installera det officiella biblioteket för ditt språk. De flesta utvecklare föredrar det standardpaketet eftersom det matchar gränssnittet de redan känner till. Kör pip install openai för Python eller npm install openai för Node.js. Du behöver bara ett SDK för att hantera alla begäranden.

2. Ange din bas-URL

Konfigurera din klient att peka mot vår specifika slutpunkt. Du måste överskriva standard bas-URL:n för att routa trafiken korrekt. Använd https://api.unsencoredai.com/v1 som din bas-URL. Skicka din API-nyckel i Authorization header. Denna konfiguration fungerar med alla standard OpenAI-kompatibla klienter.

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

3. Skicka din första begäran

Skicka en standardbegäran om chattkomplettering för att generera text. Modell-ID:t är uncensored. Du kan skicka systemprompter för att styra beteendet. API:et returnerar ett direkt text svar. Använd curl-kommandot nedan för att testa anslutningen omedelbart. Kontrollera ditt svar för choices array.

Copycurl https://api.unsencoredai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the version number"}]
  }'

4. Hantera streaming-svar

Aktivera strömning för lägre latens och realtidsutdata. Ställ stream: true i ditt begäran. API:et skickar bitar via Server-Sent Events. Du kan bearbeta varje token när den anländer. Detta är idealiskt för chattgränssnitt eller rollspels scenarier. Den sista biten innehåller användningsstatistik.

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)

5. Konfigurera parametrar

Justera temperature, top_p, och stop sekvenser. Dessa kontroller påverkar kreativitet och utdatalängd. Du kan också använda response_format för JSON-läge. Kontextrutan stöder 100,000 tokens totalt. Max utmatning är 16,000 tokens per begäran. Finjustera dessa inställningar för ditt specifika användningsfall.

6. Begränsningar, fel och kontext

Hantera fel på ett elegant sätt med standard HTTP-statuskoder. Ett 401-fel betyder att din API-nyckel är ogiltig. Ett 402-fel indikerar otillräcklig förbetald kredit. Ett 429-fel signalerar att du träffade gränsen på 300 förfrågningar per minut. Din kontextruta är 100,000 tokens. Förfrågningar över 8 MB kan misslyckas. Återbetalningar utfärdas inte för kredit, men fel är gratis.