Vaiheittainen integraatio uncensored.com LLM API -palveluun

Edellytykset: SDK ja ympäristön määritys

Asenna haluamasi kielen SDK kommunikoidaksesi päätepisteen kanssa. Useimmat kehittäjät käyttävät virallista OpenAI-SDK:ta Pythonille, Node.js:lle tai Go:lle. Tämä toimii, koska API noudattaa vakioista OpenAI chat-completions-skeemaa.

Varmista, että ympäristössäsi on Python 3.8+ tai Node.js 18+. Asenna paketti pip:n tai npm:n kautta. Tarvitset API-avaimen hallintapaneelista. Puhelinnumeroa ei vaadita rekisteröitymiseen.

• Python: pip install openai
• Node.js: npm install openai

Säilytä API-avaimesi ympäristömuuttujassa. Tämä estää vahingollisen julkaisun versionhallinnassa. Avain antaa pääsyn uncensored-malliin.

Perus-URL-osoitteen määrittäminen

Osoita SDK-asiakkaasi oikeaan base URLiisi. Tämä on kriittisin vaihe onnistuneessa integraatiossa. Oletusarvoinen OpenAI:n base URL ei toimi tälle palvelulle.

Aseta perus-URL osoitteeseen HTTPS://api.uncensoredaicom.com/v1. Tämä ohjaa pyynnöt uncensored-LLM-infrastruktuuriin. Mallitunnuksen, jonka sinun täytyy lähettää, on "uncensored". Se on avoin painotusmalli, joka on hienosäädetty vähäisille kieltäytymisille.

Varmista yhteys kutsumalla models-päätepistettä. Tämä vahvistaa, että kirjautumistietosi ja base URL ovat oikein. Onnistunut vastaus palauttaa mallin id:n ja objektityypin.

Todennus ja otsikkomääritys

Vie API-avaimesi Authorization-headeriin. Käytä Bearer-skeemaa kaikissa pyynnöissä. Tämä header autentikoi esimaksullisen kreditilisi.

Aseta otsikko seuraavasti: Authorization: Bearer YOUR_API_KEY. SDK hoitaa tämän automaattisesti, jos syötät avaimen asiakasluokan rakentajalle. Varmista, että ylimääräistä välilyöntiä ei ole. Virheelliset avaimet palauttavat virhekoodin 401 Unauthorized.

Saat yhden aktiivisen avaimen tilille. Uuden avin luominen mitätöi edellisen. Tämä yksinkertaistaa avainten kiertoa ja tietoturvan hallintaa. Säilytä avain turvallisesti käyttöönottoympäristössäsi.

Lähettämällä standardi chat-pyyntö

Tee POST-pyyntö osoitteeseen /v1/chat/completions. Lähetä viestisi rooli- ja sisältöobjektien taulikkona. Järjestelmä tukee käyttäjä-, avustaja- ja järjestelmärôlejä.

Esimerkkirakenne: {"model": "uncensored", "messages": [{"role": "user", "content": "Hello"}]}. API palauttaa tekstin täydennyksen. Kontekstiikkuna on yhteensä 100,000 tokenia. Maksimitulo on 16,000 tokenia pyyntöä kohti.

Virheet ja hylkäykset eivät kuluta luottopisteitä. Tämä suojaa esimaksusallosi. Aseta lämpötila ja top_p hallinnan vuoksi. Oletusarvot toimivat useimmissa käyttötapauksissa.

Suoratoiston käyttöönotto reaaliaikaiseen tulostukseen

Aseta stream: true pyyntörunkossa. Tämä aktivoi palveluntason tapahtumat (SSE). Tokenit saapuvat vaiheittain sen sijaan, että odottaisit täydellistä täydennystä.

Jäsennä SSE-virta näyttääksesi tekstiä reaaliajassa. Lopullinen palikka sisältää token-käytöstilastot. Tämä mahdollistaa tarkan laskutuksen seurannan. Streamaus vähentää havaittua viivettä pääkäyttäjille.

Käsittele verkkokatkokset joustavasti. Yhdistä uudelleen, jos stream putoaa. uncensored API tukee vakaata streamausta. Valvonta yhteyden tilaa. Käytä tätä chat-liittymiin tai pitkän muodon generointiin.

Kun käytät työkaluja ja function callingia

Määritä työkalut pyyntörunkoasi varten. Välitä lista funktioiden skeemoista. Malli voi kutsua näitä funktioita käyttäjän tarkoituksen perusteella. Tämä mahdollistaa agenttimaisen toiminnan.

Määritä tool_choice hallita toiminnon valintaa. Käytä auto automaattista tunnistusta varten. API tukee standardityökalumäärittelyjä. Jäsennä funktion kutsumisen argumentit vastauksesta.

Ota toiminnon suoritus koodiisi. Lähetä tulos takaisin viestinä. Malli jatkaa keskustelua. Tämä mahdollistaa monimutkaiset työvuorot. Testaus varmistaa tarkat argumenttien jäsentelyt.

JSON-tilavastausten käsittely

Aseta response_format: {"type": "json_object"}. Tämä pakottaa mallin tuottamaan kelvollista JSONia. Käytä tätä rakenteisen datan erotteluun. Se estää virheellisten vastausten virheet.

Jäsennä JSON-merkkijono koodissasi. Käsittele mahdolliset jäsennysvirheet. JSON-tila parantaa luotettavuutta API-integraatioissa. Se on ihanteellinen datankäsittelyputkiin.

Yhdistä JSON-tila system prompteihin. Ohjaa malli tuottamaan tiettyjä skeemoja. Tämä varmistaa johdonmukaisen muotoilun. Vahvista tuloste ennen sen käyttöä. Tämä vähentää jälkikäsittelyvirheitä.

Valvontarajoitukset ja virheet

Kunnioita nopeusrajoituksia. Saat 300 pyyntöä minuutissa per avain. Enintään 8 samanaikaista pyyntöä. Pyynnön kehon koko on rajoitettu 8 Mt:aan.

Valvo HTTP-tilakoodit. 429 merkitsee nopeusrajoituksen ylittymistä. 400 merkitsee huonoa pyyntöä. 500 merkitsee palvelinvirhettä. Toteuta eksponentiaalinen taaksepäin hakeutuminen uusintoihin. Tämä estää API:n kuormittamisen liikaa.

Seuraa token-käyttöä streamauksen viimeisessä palassa. Tämä auttaa hallitsemaan esimaksukrediittiä. Virheet eivät kuluta tokenia. Tämä suojaa saldoasi. Säännöllinen valvonta varmistaa sujuvan toiminnan.

Kustannusten ja token-käytön laskenta

Hinnoittelu on läpinäkyvää ja esimaksu. Syöttötokenit maksavat $0,15 miljoonaa kohden. Tulostustokenit maksavat $0,50 miljoonaa kohden. Kreditti ei vanhene. Ei kuukausimaksuja.

Lataa vain kryptolla. USDT (TRC20) tai USDC (Base). Summat vaihtelevat 20 $–500 $. Bonussaldo koskee suurempia talletuksia. +5 % summista 50 $, +10 % summista 100 $, +15 % summista 200 $.

Laske kustannukset ennen laajaa käyttöä. Arvioi tokenmäärät syötteillesi. Tämä auttaa budjetoinnissa. Virheet ovat ilmaisia. Palautuksia ei myönnetä, mutta virheet korjataan. Seuraa kuluja hallintapaneelista.