Pika-aloitusopas

Asennus ja kokoonpano

Aloita asentamalla virallinen SDK kielellesi. Asiakasohjelman tarvitsee vain API-avaimesi ja oikean perus-URLin ohjataksesi pyynnöt palvelimillemme. Tämä asennus toimii minkä tahansa vakiokäyttöliittymän kanssa.

Määritä ympäristömuuttujat tai välitä ne suoraan asiakasrakentajalle. Sinun ei tarvitse hallita monimutkaista reititykselogiikkaa tai vaihtaa useiden mallien välillä. Yksi uncensored-malli käsittelee kaikki pyynnöt.

• Asenna paketti paketinhallintasi kautta.
• Aseta API-avain hallintapaneelista.
• Osoita asiakas API-päätepisteeseen.

Ensimmäisen pyynnön tekeminen

Lähetä POST-pyyntö chat completions -päätepisteeseen asettamalla mallin ID arvoksi "uncensored". Tämä palauttaa suoran tekstivastauksen mallilta ohittaen standardit sisältösuodattimet. Voit lähettää yksinkertaisia prompteja tai monimutkaisia järjestelmäohjeita.

API hyväksyy standardiparametreja kuten temperature ja top_p. Käytä seuraavaa cURL-komentoa varmistaaksesi yhteyden ja vastauksen laadun välittömästi.

Copycurl https://api.chatbotunrestricted.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fetch current temperature in Tokyo."}]
  }'

Tämä vastaus vahvistaa, että malli on aktiivinen ja valmis tuotantoliikenteelle.

Striimitettyjen vastausten käsittely

Ota käyttöön streamaus asettamalla stream-parametri arvoksi true. API palauttaa server-sent events (SSE) -virran, joka toimittaa tokenit niiden tuotannon aikana. Tämä vähentää pääkäyttäjien havaitsemaa viivettä merkittävästi.

Jäsennä SSE-osia päivittääksesi käyttöliittymääsi reaaliajassa. Lopullinen osa sisältää pyynnön kokonaistokenkäytön. Tämä lähestymistapa on välttämätön chat-käyttöliittymissä, joissa käyttäjät odottavat välitöntä palautetta.

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)

Varmista, että asiakasohjelmistosi käsittelee streamin päättymistapahtuman oikein.

Työkalujen ja funktiokutsujen käyttö

Määritä työkalut pyyntöön, jotta malli voi tuottaa rakenteellista dataa. Välitä työkelumääritykset tools-taulukossa ja määritä tool_choice automaattista valintaa varten. Malli palauttaa funktiokutsut vastauksen sisällössä.

Jäsennä toimintokutsun argumentit ja suorita ne koodissasi. Anna sitten tulokset takaisin mallille seuraavassa viestissä. Tämä kierto mahdollistaa monimutkaiset monivaiheiset työvuorot ilman ulkoista jäsennyslogiikkaa.

Copyimport OpenAI from "openai";

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

Validoi aina ulostuloschema ennen suorittamista.

Tokenien ja rajoitusten hallinta

Kontekstiikkuna tukee 100 000 tokenia sekä promptille että täydennykselle yhteensä. Jokainen pyyntö voi tuottaa jopa 16 000 tokenia, tai 2 048 jos max_tokens jätetään määrittämättä. Seuraa käyttöäsi vastauksen token-lukujen kautta.

Nopeusrajoitukset sallivat 300 pyyntöä minuutissa ja 8 samanaikaista pyyntöä per avain. Näiden rajojen ylitys laukaisee virhekoodin 429. Pidä avaimesi ainutlaatuisena tiliä kohden välttääksesi rajojen jakamisen.

Virheet kuten 401 viittaavat virheelliseen avaimen, kun taas 402 tarkoittaa, että tarvitset lisää rahaa. Hylkäykset vähäisistä sisältörikkomuksista ovat ilmaisia eivätkä kuluta tokenia.

Virheenkäsittely ja vianmääritys

Käsittele HTTP-virheet sujuvasti sovelluksesi logiikassa. 401-tila tarkoittaa, että API-avaimesi on virheellinen tai vanhentunut. Tarkista ohjauspaneelista, että avain on voimassa.

Tila 402 osoittaa riittämätöntä esimaksukreditiittiä. Lisää rahaa USDT:llä tai USDC:llä jatkaaksesi palvelua. Virhe 429 ilmoittaa, että olet ylittänyt nopeusrajoituksen. Odota ja yritä uudelleen eksponentiaalisella taaksepäin hylkäyksellä.

Virheelliset pyynnön rungot palauttavat 400-virheen. Varmista, että JSON-rakenteesi vastaa API-määritystä. Nämä virheet ovat ilmaisia eivätkä vähennä saldoasi.

Python

Copyfrom openai import OpenAI

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