API-dokumentaatio rajoittamattomiin chat-täydennyksiin

Pika-aloitus: Yhdistä Pythonilla tai JavaScriptillä

Yhdistä API -palveluun päivittämällä base URL - ja asettamalla API-avaimesi. Päätepiste hyväksyy vakiokirjastoja chat-completion-pyyntöjä ja palauttaa tekstiä. Sinun ei tarvitse asentaa mukautettuja kirjastoja, jos käytät virallisia OpenAI SDK -kirjastoja, koska käyttöliittymä vastaa niiden spesifikaatiota täsmälleen.

Aloita yksinkertaisella HTTP-pyynnöllä yhteystestaukseen. Käytä alla olevaa curl-komentoa lähettääksesi peruspromptin kohteeseen uncensored malli. Korvaa YOUR_API_KEY hallintapaneelissa luodulla avaimella.

Copycurl https://api.aiplayrolebest.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set the character persona to a grumpy detective"}]
  }'

Python-kehittäjille prosessi on lähes identtinen. Alusta asiakas ohjelmalla avaimellasi ja oikealla base URLilla. Tämä varmistaa, että kaikki pyynnät ohjataan suodattamattomille palvelimillemme säilyttäen yhteensopivuuden olemassa olevan työkalukirjaston kanssa.

Copyfrom openai import OpenAI

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

JavaScript-käyttäjät voivat saavuttaa saman tuloksen Node SDK:lla. Aseta baseURL ominaisuutta päätepisteeseemme. Tämä lähestymistapa mahdollistaa API:n integroinnin web-palvelimille tai backend-palveluille vähäisillä koodimuutoksilla.

Copyimport OpenAI from "openai";

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

Todennus ja API-avainten hallinta

Todennus perustuu yhteen avaimeseen, joka välitetään otsikkotietoina. Lähetä tämä avain Authorization header jokaista pyyntöä varten. Jos avain puuttuu tai on virheellinen, API palauttaa 401-virheen välittömästi. Tämä varmistaa turvallisen pääsyn esimaksattuun luottoosi.

Luo avimesi hallintapaneelista. Avain näytetään luomisen yhteydessä kerran. Säilytä se turvallisesti ympäristömuuttujissasi. Älä jaa sitä julkisesti. Jokaisessa tilissä voi olla vain yksi aktiivinen avain kerralla. Uuden avaimen luominen mitätöi vanhan avaimen välittömästi.

Käytä avainta pyynnöissäsi näin: Authorization: Bearer YOUR_API_KEY. Tämä vakiintunut otsikkomuoto toimii kaikkien suurimpien SDK:iden kanssa. Pidä avain kätevänä nopeaa iterointia varten kehityksen aikana.

Chat Completions endpoint parameters

Lähetä pyynnöt kohteeseen /v1/chat/completions päätepiste. Sisällytä viestitaulukkosi (messages array) ja aseta malli kohtaan uncensored. Voit säätää parametreja kuten temperature ja top_p hallita luovuutta. Korkeammat arvot tuottavat monipuolisempia vastauksia.

Aseta max_tokens rajoittamaan tulosteen pituutta. Oletus on 2 048 tokenia, jos sitä ei määritetä. Malli tukee 100 000 tokenin konteksttilaajuutta promptille plus täydennykselle. Tämä mahdollistaa pitkät keskustelut ilman katkeilua. Säädä presence_penalty ja frequency_penalty vähentääksesi toistoa roolipelinäkymissä.

Käytä stop parametri keskeyttämään generaatio tiettyjen lausekkeiden kohdalla. Tämä auttaa pakottamaan dialogin rakenteen. The seed parametri varmistaa toistettavat tulokset testausta varten. Nämä työkalut antavat sinulle tarkan hallinnan mallin käyttäytymiselle.

Virtaavat vastaukset ja käyttödata

Ota streamaus käyttöön asettamalla stream: true pyynnössäsi. API palauttaa tekstiosia niiden luomisen aikana. Tämä vähentää havaittua viivettä pääkäyttäjille. Jokainen osa sisältää osittaista tekstiä ja metatietoja.

Käyttödata ilmestyy viimeisessä palautuksessa. Tämä sisältää syöte- ja tulostustokenien määrät. Tarkista usage kenttä viimeisessä vastausobjektissa. Tämä mahdollistaa tarkan laskutuksen tarkistamisen ilman erillisiä API-pyyntöjä. Seuraa tokenien kulua reaaliajassa.

Käsittele streamin päätyminen huolellisesti. Varmista, että käsittelet kaikki lohkot ennen yhteyden sulkemista. Viimeinen lohko sisältää täydelliset käyttötilastot. Nämä tiedot ovat olennaisia kustannusten ja suorituskyvyn seurannassa tuotantosovelluksissa.

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)

Virheenkäsittely ja nopeusrajoitukset

API rajoittaa 300 pyyntöä minuutissa per avain. Samanaikaiset pyynnöt on rajoitettu kahdeksaan per avain. Pyyntörungon koko ei saa ylittää 8 Mt. Näiden rajojen ylitys palauttaa 429-virheen. Toteuta eksponentiaalinen backoff käsitelläksesi tilapäisiä piikkejä.

Yleiset virheet sisältävät 401 virheellisille avaimille ja 402 riittämättömälle krediitille. 402-vastaus tarkoittaa, että esimaksattu saldosi on loppu. Lisää tilillesi krediittejä jatkaaksesi palvelua. Virheet eivät kuluta tokeneita, joten uudelleenyrittäminen virheen korjaamisen jälkeen on ilmaista.

Tarkista vastausruumis yksityiskohtaisista virheilmoituksista. API palauttaa JSON-objektin, jossa on virhetyyppi ja viesti. Käytä tätä tietoa vianmääritykseen nopeasti. Oikea virheenkäsittely varmistaa sujuvan kokemuksen käyttäjillesi ruuhkan aikana.

JSON-tila ja funktiokutsujen opas

Käytä JSON-tilaa asettamalla response_format vastaan {"type": "json_object"}. Tämä pakottaa mallin tuottamaan kelvollista JSONia. Erinomainen rakenteisen datan erotteluun tai API-vastauksiin. Varmista, että promptisi kuvaa halutun skeeman selkeästi.

Function calling -toiminnolla malli voi kutsua työkaluja. Määritä työkalut pyynnön runkossa. Malli palauttaa työkalukutsuja tarvittaessa. Käsittele nämä kutsut sovelluksesi logiikassa. Tämä mahdollistaa monivaiheisten työvuokojen toteuttamisen.

Yhdistä JSON-tila funktiokutsuihin vahvoihin integraatioihin. Vahvista JSON-tuloste asiakaspään puolella. Käytä tool_choice parametri, joka ohjaa, milloin funktioita kutsutaan. Tämä joustavuus tukee monenlaisia sovellusarkkitehtuureita. Varmista, että työkalusi on hyvin määritelty optimaalisen suorituskyvyn varmistamiseksi.

Mallin tiedot ja kontekstiluukun rajat

The uncensored malli tukee 100,000 tokenin kontekstiikkunaa. Tämä sisältää sekä syötteeseen promptin että tulosteen täydennyksen. Maksimi tuloste on 16,000 tokenia pyyntöä kohti. Tämä mahdollistaa laajat roolipeliskenaariot ilman lauseen keskeytymistä.

Malli on avoin painoinen ja hienosäädetty rajoittamattomaan sisältöön. Se ei kieltäydy laillisista aikuis aiheista. Se ei ole GPT, Claude tai mikään muu toimittajan malli. Pyynnöt käsitellään omistautuneilla palvelimillamme. Tämä varmistaa johdonmukaisen suorituskyvyn ja matalan viiveen.

Seuraa kontekstin käyttöä pysyäksesi rajojen sisällä. API seuraa tokenien käyttöä tarkasti. Virheet ja hylkäykset eivät kuluta tokenia. Tämä läpinäkyvä laskutusmalli auttaa sinua ennakoimaan kustannuksia. Suunnittele kontekstiluikkusi maksimoidaksesi arvon.