Ucensureret API-hurtigstartsguide

Autentificering og Base URL

Start med at pege dit SDK mod vores base URL og overføre din nøgle i autorisationsheaderen. Vi tilbyder en direkte service med én model uden proxy-routinggebyrer. Brug standard Authorization: Bearer skema til at autentificere anmodninger. Din nøgle genereres øjeblikkeligt efter tilmelding via Google eller e-mail. Sørg for at erstatte pladsholder-nøglen i din klientkonfiguration med den, der vises på dit dashboard. Base URL'en er https://api.uncensoredmodelsollama.com/v1. Dette endpoint understøtter standard OpenAI-kompatible klienter, hvilket giver dig mulighed for at skifte udbyder uden at omskrive din applikationslogik. Hold din nøgle sikker, da den giver adgang til din forudbetalte kreditbalance.

Chat Completions Endpoint

Send tekstrequests til /v1/chat/completions endpoint til at generere svar. Dette endpoint håndterer standard samtalehistorikker og systemprompter. Du skal angive model-ID'et som uncensored i request-kroppen. API-et returnerer JSON-formaterede svar, der indeholder den genererede tekst og token-brugsstatistik. Fejl som utilstrækkelig kredit eller ugyldige nøgler returneres med passende HTTP-statuskoder. Brug dette endpoint til alle standard tekstgenereringsopgaver. Det understøtter ikke embeddings, billeder eller fine-tuning. Hold din payload under 8 MB for at sikre pålidelig behandling. Modellen behandler input- og output-tokens inden for et delt kontekstvindu.

Streaming-svar

Aktivér streaming ved at indstille stream parameter til true i din request. API'et returnerer Server-Sent Events (SSE) indeholdende inkrementelle chunks af tekst. Denne tilgang reducerer den opfattede forsinkelse for brugere, der venter på lange outputs. Du modtager token-forbrugsinformation i den sidste chunk af streamen. Implementer en stream-handler i din klient til at behandle disse begivenheder effektivt. Streaming er ideelt til chatgrænseflader og realtidsapplikationer. Sørg for, at din klientbibliotek understøtter SSE-parsing for at håndtere den kontinuerlige datastrøm korrekt. Det samlede context-vindue forbliver 100,000 tokens uanset streaming-tilstand.

Function Calling og JSON-tilstand

Brug den tools parameter til at aktivere funktion-kald-funktionalitet. Definér dine funktioner i request-kroppen for at tillade, at modellen returnerer struktureret data. Indstil response_format til {"type": "json_object"} for streng JSON-output. Denne funktion er nyttig til at udtrække data eller generere strukturerede payloads. Modellen understøtter værktøjsvalgparametre til at kontrollere funktionskaldadfærd. Brug disse funktioner til at integrere API'et i automatiserede arbejdsgange. Sørg for, at dine funktionsdefinitioner matcher det forventede input-schema for pålidelige resultater. API'et returnerer værktøjskald i standard OpenAI-format for nem parsing.

Parameters and Rate Limits

Juster genereringsadfærd ved hjælp af parametre som temperature, top_p, og seed. Indstil max_tokens for at begrænse outputlængden, med en standardværdi på 2.048, hvis den udelades. API'et har en rate limit på 300 anmodninger i minuttet per nøgle. Samtidige anmodninger er begrænset til 8 per nøgle. Hvis du overskrider disse grænser, returnerer API'et en 429-statuskode. Anmodninger opkræves baseret på faktisk tokenforbrug, mens fejl og afvisninger er gratis. Kredit udløber ikke, og forudbetalte beløb er gennemsigtige. Håndtér dine nøgler omhyggeligt, da hver konto kun understøtter én aktiv nøgle ad gangen.

Begrænsninger, fejl og kontekst

Kontekstvinduet understøtter 100.000 tokens til kombineret input og output. Anmodninger, der overstiger 8 MB body-grænsen, vil fejle. Almindelige fejl inkluderer 401 for ugyldige nøgler og 402 for utilstrækkelig kredit. Håndter disse fejl pænt i din applikationslogik. API'et afviser anmodninger, der indeholder seksuelt indhold med mindreårig, uanset andre indstillinger. andet indhold forbliver uncensureret til lovligt voksenbrug. Overvåg dit tokenforbrug for at undgå uventede omkostninger. Det forudbetalte kreditsystem sikrer, at du kun betaler for det, du bruger. Der er ingen abonnementsgebyrer eller skjulte omkostninger ved din integration.

cURL

Copycurl https://api.uncensoredmodelsollama.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List all available models in the ollama library."}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Streaming

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)