Hurtig start: integrer på få minutter

1. Installer din SDK

Start med at installere det officielle bibliotek til dit sprog. De fleste udviklere foretrækker standardpakken, fordi den matcher det interface, de allerede kender. Kør pip install openai til Python eller npm install openai til Node.js. Du har kun brug for ét SDK til at håndtere alle anmodninger.

2. Indstil din base-URL

Konfigurer din klient til at pege på vores specifikke endpoint. Du skal overskrive standard base URL'en for at rute trafikken korrekt. Brug https://api.unsencoredai.com/v1 som din base URL. Overfør din API-nøgle i Authorization header. Denne opsætning fungerer med ethvert standard OpenAI-kompatibelt klient.

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. Send din første anmodning

Send en standard chat-completionsanmodning for at generere tekst. Model-ID'et er uncensored. Du kan sende system prompts for at vejlede adfærden. API'et returnerer et direkte tekst svar. Brug curl-kommandoen nedenfor til at teste forbindelsen straks. Tjek dit svar for 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. Håndter streaming-svar

Aktivér streaming for lavere forsinkelse og realtidsoutput. Indstil stream: true i din anmodning. API'et sender chunks via Server-Sent Events. Du kan behandle hvert token, når det ankommer. Dette er ideelt til chatgrænseflader eller rollespils-scenarier. Den sidste chunk indeholder forbrugsstatistikker.

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. Konfigurer parametre

Juster temperature, top_p, og stop sekvenser. Disse kontroller påvirker kreativitet og outputlængde. Du kan også bruge response_format til JSON-tilstand. Context-vinduet understøtter 100.000 tokens i alt. Maks output er 16.000 tokens per anmodning. Finjuster disse indstillinger til dit specifikke brugstilfælde.

6. Begrænsninger, fejl og kontekst

Håndter fejl elegant ved hjælp af standard HTTP-statuskoder. En 401-fejl betyder, at din API-nøgle er ugyldig. En 402-fejl indikerer utilstrækkelig forudbetalt kredit. En 429-fejl signalerer, at du har ramt grænsen på 300 anmodninger i minuttet. Din kontekstvindu er 100.000 tokens. Anmodninger over 8 MB kan mislykkes. Refunderinger udstedes ikke for kredit, men fejl er gratis.