API-dokumentaatio & Quickstart

Todennus & Base URL

Aloita jokainen pyyntö osoittamalla asiakasohjelmasi HTTPS://api.uncensoredia.com/v1 ja liitä avaimesi. Valtuutus käyttää standardia Bearer mekanismin, joten liitä yksinkertaisesti tokeni, jonka sait rekisteröitymisen jälkeen Google- tai sähköpostitunnuksella. Päätepiste on täysin openai-yhteensopiva API compliant, meaning you only need to swap the base URL and API key in your existing configuration. You do not need to manage complex routing layers or proxy headers. Just ensure your Authorization header sisältää ainutlaatuisen tokenisi. Tämä asennus takaa, että pyyntösi saapuvat omistettuun epäsuodatettuun malliin ilman välillistä suodatusta. Jos saat 401 virhe, varmista, että avaimesi on aktiivinen ja oikein muotoiltu.

Chat Completions Endpoint

Lähetä viestit osoitteeseen POST /v1/chat/completions vastaanottaaksesi tekstimuotoisia vastauksia reaaliajassa. Tämä yksittäinen päätepiste hoitaa kaikki luontitarpeesi yksinkertaisista syötteistä monivaiheisiin keskusteluihin. Voit hallita tulosteen pituutta ja satunnaisuutta parametreilla kuten max_tokens, temperature, ja top_p. Malli tukee valtavaa 100 000 tokenin context window, allowing you to feed in extensive documentation or long conversation histories. You can send up to 16,000 tokens in the response. If you omit max_tokens, oletusraja on 2 048 tokenia. Tämä päätepiste ei tue kuvien tai äänen tuottamista. Se on tiukasti teksti sisään, teksti ulos. Käytä seuraavaa curl-komentoa testataksesi yhteyttäsi välittömästi.

Python SDK -integraatio

Käytä virallista OpenAI:n Python-kirjastoa API:iin minimaalisilla koodimuutoksilla. Sinun tarvitsee vain ohittaa base_url ja api_key asiakasohjelmiston määrityksissä. Tämä lähestymistapa varmistaa, että olemassa oleva logikkasi vastauksien, virheiden ja uudelleenyritysten käsittelyyn pysyy ennallaan. Kirjasto hoitaa automaattisesti JSON-serialisoinnin ja streamauksen, jos otat sen käyttöön. Tämä menetelmä on ihanteellinen palvelinten taustaprosesseja tai skriptejä varten, jotka tarvitsevat käsitellä suuria tekstimääriä. uncensored-malli vastaa vakioihin keskustelulopetuspyyntöihin vakimatta mukautettua jäsentämislogiikkaa. Määritä asiakasohjelmistosi kerran ja käytä sitä koko sovelluksessasi. Tässä on esimerkki asiakasohjelmiston alustamisesta ja yksinkertaisen pyynnön lähettämisestä.

Node.js SDK:n määritys

Integroi API JavaScript- tai TypeScript-sovelluksiin käyttämällä @anthropic-ai/sdk tai virallinen openai pakka. Aseta baseURL päätepisteeseemme ja anna API-avaimesi. Tämä mahdollistaa tuttujen menetelmien käytön, kuten chat.completions.create() suoraan. SDK käsittelee HTTP-pyyntöjä ja jäsentää JSON-vastaukset puolestasi. Voit helposti käsitellä virheitä kuten 402 (riittämätön saldo) tai 429 (nopeusrajoitus) sovelluksesi logiikassa. Tämä asennus on täydellinen web-palvelimille, bottien tai mihin tahansa Node.js-ympäristöön. Sensuroimaton malli toimii saumattomasti standardin pyyntömuodon kanssa. Määritä asiakas varmistaaksesi yhteensopivuuden API:n odotusten kanssa.

Streamausvastaukset

Ota käyttöön reaaliaikainen tokenitoimitus asettamalla stream: true pyynnössäsi. API palauttaa Server-Sent Events (SSE) -streamin, joka mahdollistaa tekstin näyttämisen sen generoitumisen aikana. Tämä parantaa käyttökokemusta chatliittymissä ja vähentää koettua viivettä. Jokainen osio sisältää osittaisen vastauksen, ja viimeinen osio sisältää tokenien käyttötilastot. Voit käsitellä näitä osioita vaiheittain rakentaaksesi koko vastauksen. Tämä ominaisuus on olennaista sovelluksille, jotka vaativat välitöntä palautetta. uncensored-malli tukee streamausta kaikissa pyyntotyypeissä. Käsittele streamitapahtumat päivittääksesi käyttöliittymääsi tehokkaasti. Käytä tätä koodia streamauksen toteuttamiseen asiakkaassasi.

Nopeusrajoitukset & kontekstirajoitukset

API asettaa tiukat rajat varmistamaan vakaan suorituskyvyn kaikille käyttäjille. Voit lähettää enintään 300 pyyntöä minuutissa per key and have 8 samanaikaista pyyntöä aktiivinen milloin tahansa. Maksimi pyyntökehikon koko on 8 Mt. Jos ylität nämä rajat, saat 429 status-koodi. Varmista, että käsittelet uudelleenyritykset eksponentiaalisella viiveellä välttääksesi näiden rajojen ylittämisen toistuvasti. Kontekstiluukku on 100 000 tokenia, mutta maksimitulostus on 16 000 tokenia. Jos tarvitset enemmän tulostusta, säädä max_tokens parametri. Virheet kuten 401 (virheellinen avain) ja 402 (ei saldoa) ovat välittömiä eivätkä kuluta tokenimäärääsi. Hallinnoi kvoottasi huolellisesti välttääksesi palvelukatkoksia suurten generaatiotehtävien aikana.

cURL

Copycurl https://api.uncensoredia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json with key status true"}]
  }'

Python

Copyfrom openai import OpenAI

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

Virtaus

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)