Integroi uncensored-ai-API nopeasti
Aloita uncensored AI -API:n käyttö minuuteissa osoittamalla olemassa oleva OpenAI-yhteensopiva asiakasohjelmistosi base URL -osoitteeseemme. Tämä quickstart-opas kattaa todennuksen, keskustelujen päättelyn, streamauksen ja työkalukutsujen käytön konkreettisilla esimerkeillä.
Todennus ja base URL
Kyllä, voit autentikoida välittömästi käyttämällä dashboardilla annettua base URL -arvoa. Palvelumme käyttää vakioituja API-avainotsikoita, jotka ovat yhteensopivia minkä tahansa OpenAI SDK:n kanssa. Saat avaimesi välittömästi rekisteröitymisen jälkeen Google- tai sähköpostitunnuksella. Alkuperäiseen asennukseen ei tarvita puhelinnumeroa.
Aseta base_url vastaan https://api.isgrokuncensored.com/v1. Syötä avin Authorization header. Järjestelmä varmentaa tunnistetiedot ennen tokenien käsittelyä. Virheet kuten 401 viittaavat virheelliseen tai puuttuvaan avaimen. Tarkista dashboardista, jos avain epäonnistuu.
Chat completions endpoint
Lähetä POST-pyyntö osoitteeseen /v1/chat/completions saadaksesi tekstivastauksia. Päätepiste hyväksyy standardit viestitaulukot ja palauttaa tuotetun tekstin. Se ei tue kuvia, ääntä tai embeddingejä. Käytä mallitunnusta uncensored kaikkiin pyyntöihin. Tämä varmistaa, että käytät oikeaa avointa painotusmallia.
Syötetokenit maksavat 0,15 $ miljoonaa kohti, kun taas tulostokenit maksavat 0,50 $ miljoonaa kohti. Esimaksuluotto vähentää vain todellisesta käytöstä. Virheet ja hylkäykset eivät kuluta saldoasi. Voit lähettää enintään 8 Mt pyyntöruumiin kerrallaan. Tämä raja kattaa useimmat vakiotekstivaihtoehdot.
Virtaavat vastaukset ja tokenien käyttö
Ota streamaus käyttöön asettamalla stream vastaan true pyynnössäsi. Saat Server-Sent Events -tapahtumavirran (SSE) reaaliaikaiseen tokenitoimitukseen. Viimeinen lohko sisältää kokonaistoken-käyttötilastot. Tämä mahdollistaa kustannusten seurannan reaaliajassa. Se on olennaista responsiivisten chat-käyttöliittymien rakentamisessa.
Jäsennä SSE-tapahtumia päivittääksesi käyttöliittymääsi vaiheittain. Malli tuottaa tekstiä jatkuvasti, kunnes kontekstiikkuna täyttyy tai lopetussekvenssi laukeaa. Maksimi tuotos on 16,000 tokenia per pyyntö. Sinun on määritettävä max_tokens ylittää oletusarvoisen 2 048 tokenin määrän. Tämä estää odottamattomat laskut pitkistä vastauksista.
Function calling ja JSON-tila
Käytä tools parametri, joka ottaa käyttöön funktiokutsuominaisuudet. Määrittele työkaluskeemasi pyynnön ruumiissa. Malli palauttaa rakenteelliset argumentit funktioillesi. Tämä toimii saumattomasti standardien OpenAI-yhteensopivien asiakkaiden kanssa. Voit myös pakottaa JSON-tulosteen käyttämällä response_format. Tämä on hyödyllistä rakenteellisen datan jäsentämisessä.
Aseta response_format vastaan {"type": "json_object"} saadaksesi puhtaata JSONia. Tämä tila poistaa keskustelun täytetekset. Se on ihanteellinen ohjelmallisiin integraatioihin. Voit yhdistää työkalut ja JSON-tilin monimutkaisiin työvuoroihin. API käsittelee jäsentämisen sisäisesti. Sinun tarvitsee vain validoida tulosteen rakenne.
Mallin parametrit: lämpötila ja top_p
Säädä temperature hallitsemaan satunnaisuutta. Korkeammat arvot tuottavat luovempia tuloksia. Matalammat arvot tekevät vastauksista deterministisempiä. Oletusarvo on yleensä 1,0. Voit asettaa sen välille 0 ja 2. Käytä top_p ytimenäytteistykseen. Tämä rajoittaa harkittujen tokenien todennäköisyysmassaa. Se toimii lämpötilan kanssa parantaakseen tulosten laatua.
Muut tuetut parametrit sisältävät stop sekvenssit, seed toistettavuudelle, ja rangaistukset kuten presence_penalty. Nämä mahdollistavat generointiprosessin hienosäädön. Voit kokeilla erilaisia yhdistelmiä. API kunnioittaa kaikkia OpenAI-standardiparametreja. Tämä varmistaa helpon siirtymisen muilta tarjoajilta. Testaa eri arvoja löytääksesi parhaan sovellustapaukseesi.
Rajoitukset, virheet ja kontekstiikkuna
Konteksti-ikkuna tukee yhteensä 100 000 tokenia. Tämä sisältää sekä prompt- että completion-tokenit. Voit lähettää suuria asiakirjoja analysoitavaksi. Nopeusrajoitus sallii 300 pyyntöä minuutissa avainta kohti. Samanaikaisuus on rajoitettu 8 samanaikaiseen pyyntöön. Näiden rajojen ylitys palauttaa virhekoodin 429. Yritä uudelleen eksponentiaalisella taaksepäinpyrkimisellä.
Käsittele virheet joustavasti koodissasi. 402-virhe tarkoittaa, että esimaksukrediittisi on loppu. Lisää krediittejä kryptomaksuilla jatkaaksesi palvelua. 401-virhe tarkoittaa autentikointiongelmaa. Tarkista avaimen voimassaolo. API ei veloita epäonnistuneista pyynnöistä, jotka johtuvat validointivirheistä. Tämä suojaa saldoasi satunnaisilta lisäveloituksilta.
cURL
curl https://api.isgrokuncensored.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Return the current UTC timestamp"}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.isgrokuncensored.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
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.isgrokuncensored.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
stream = 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)Usein kysytyt kysymykset
Mikä on perus-URL sensuroimattomalle AI-API:lle?
Perus-URL on HTTPS://api.isgrokuncensored.com/v1. Sinun täytyy asettaa tämä OpenAI-yhteensopivaan SDK-määritykseen. Se korvaa oletus-OpenAI-päätepisteen. Tämä varmistaa, että pyynnöt menevät palvelimillemme. URL-tuki sekä suoratoisto- että suoratoistottomia pyyntöjä. Käytä sitä kaikkiin chat-päivityksiin.
Miten käsittelemme suoratoistovastauksia suodattamattoman LLM:n kanssa?
Aseta stream-parametri arvoksi true pyynnössäsi. Saat Server-Sent Eventsin (SSE) sisältäen osittaista tekstiä. Jäsennä jokainen lohko päivittääksesi käyttöliittymääsi. Viimeinen lohko sisältää token-käyttötiedot. Tämä mahdollistaa tuotetun tekstin reaaliaikaisen näyttämisen. Se on tehokas suurille vastauksille.
Mitä tapahtuu, jos ylityt nopeusrajan?
Saat statuskoodin 429. API sallii 300 pyyntöä minuutissa per avain. Samanaikaisuus on rajoitettu 8 samanaikaiseen pyyntöön. Toteuta eksponentiaalinen viive asiakasohjelmassasi. Tämä estää palvelimen kuormittamisen. Toista pyyntö lyhyen viiveen jälkeen. API ei veloita nopeusrajoitettuja pyyntöjä, jos ne epäonnistuvat validaatiossa.
Hanki API-avaimesi nyt
Rekisteröidy, kopioi avaimesi ja päivitä base URL. Se on kaikki mitä tarvitset konfigurointiin.