API-dokumentaatio

Todennus ja base URL

API vaatii yhden API-avaimen todennukseen. Saat tämän avaimen välittömästi rekisteröitymisen jälkeen Google-tilillä tai sähköpostiosoitteella. Lisää se Authorization header Bearer-tokenina. Base URL on https://api.topuncensored.com/v1. Tämä URL toimii minkä tahansa OpenAI-yhteensopivan SDK:n tai asiakaskirjaston kanssa.

• Käytä otsikkoa: Authorization: Bearer YOUR_API_KEY
• Aseta asiakasohjelmasi base URL tarjotulle päätepisteelle.

Tämä konfiguraatio varmistaa, että voit vaihtaa kirjastoja muuttamatta ydintä.

Copycurl https://api.topuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of ten distinct UI layout patterns."}]
  }'

Chat Completions Endpoint

Lähetä tekstipromptteja osoitteeseen /v1/chat/completions päätepiste. Mallin tunnus on uncensored. Tämä päätepiste käsittelee vakiintunutta viestien muotoilua. Se palauttaa tekstimuotoiset vastaukset suoraan. Ei ylimääräisiä kerroksia tai kääreitä. Hallitset 100 000 tokenin kontekstiikkunaa. Alle 8 Mt:n pyynnöt toimivat luotettavasti. Käytä tätä suoraan tekstinluontia varten.

Rakenna pyyntösi järjestelmäkehotteella ja käyttäjäviestillä. Malli vastaa suodattamatta laillista aikuis sisältöä. Virheet kuten puuttuvat avaimet palauttavat 401. Loppuiko luottosaldo? Saat 402-virheen. Nämä ovat selkeitä signaaleja.

Streamausvastaukset

Ota streamaus käyttöön asettamalla stream: true. Saat tekstipaloja niiden tuotannon aikana. Tämä vähentää koettua viivettä pitkissä tulosteissa. Viimeinen palikka sisältää token-käyttötilastot. Käytä tätä reaaliaikaisiin näyttöihin tai progressiiviseen renderöintiin. Se on tehokas suurten volyymien sovelluksissa.

Jäsennä jokaista lohkoa rakentaaksesi lopullisen vastauksesi. Tämä menetelmä käsittelee suuria tulosteita sujuvasti. API tukee standardia Server-Sent Events -tekniikkaa. Tämä on suositeltu lähestymistapa interaktiivisiin sovelluksiin.

Copyfrom openai import OpenAI

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

Työkalukutsu ja JSON-tila

Käytä funktiokutsuja rakenteisiin vuorovaikutuksiin. Määrittele työkalut pyyntöön. Malli palauttaa rakenteisia argumentteja. Aseta response_format vastaan {"type": "json_object"} tiukan JSON-tuloksen varmistamiseksi. Tämä varmistaa ennustettavat dataformatit. Yhdistä nämä ominaisuudet vahvoihin integraatioihin. Saat tarkan hallinnan lähtörakenteesta.

Työkalukutsu toimii standardin OpenAI-skeeman kanssa. JSON-tila pakottaa validin JSON:n. Käytä näitä API-integraatioihin tai datan erotteluun. Tämä joustavuus tukee monimutkaisia työvuoroja.

Copyimport OpenAI from "openai";

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

Parameters and Limits

Säädä temperature, top_p, ja stop sekvenssit. Aseta max_tokens arvoon 16 000. Oletus on 2 048, jos se jätetään pois. Hallitse toistoa parametrilla presence_penalty ja frequency_penalty. Käytä seed deterministisiin tuloksiin. Nämä parametrit hienosäätävät generointilaatua. Sinulla on täysi hallinta tulostyylissä.

Pyyntörajoitukset ovat 300 pyyntöä minuutissa. Samanaikaisten pyyntöjen maksimimäärä on 8. Nämä rajat varmistavat vakaan suorituskyvyn. Seuraa käyttöä ohjauspaneelin kautta. Säädä parametreja optimoidaksesi ne tiettyyn käyttötarkoitukseesi.

Virheet ja kontekstiaukko

Käsittele virheet joustavasti. 401 tarkoittaa virheellistä avainta. 402 tarkoittaa riittämätöntä krediittiä. 429 merkitsee nopeusrajoituksia. Kontekstiikkuna on yhteensä 100 000 tokeniä. Tulon maksimimäärä on 16 000 tokeniä. Hallitse tokenejä järkevästi. Virheet eivät kuluta krediittejä. Tämä säästää rahaa vianetsinnän aikana. Käytä viimeistä osaa käyttötilastoihin.

Seuraa tokenkäyttöä. Vältä nopeusrajojen ylittymistä. Yritä uudelleen eksponentiaalisella viiveellä. Tämä varmistaa luotettavan toiminnan. API on suunniteltu kestävyyttä silmällä pitäen. Käsittele virheet osana normaalia virtaa.

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)