Grok API -integraatioopas

Miksi käyttää rajoittamatonta Grok API -vaihtoehtoa?

Suora API-pääsy soveltaa usein tiukkoja sisältösuureita, jotka estävät laillisen aikuis- tai kiistanalaisten aiheiden käsittelyn. Monet tarjoajat piilottavat nämä hylkäykset syvälle vastausrakenteisiinsa. Sensuroimaton malli tarjoaa raakaa johtopäätösdataa mille tahansa lailliselle käyttötarkoitukselle. Saat koko tuotannon ilman yrityksen turvallisuuskerroksen väliintuloa.

Yritysluokan API:t muuttavat usein suodatuslogiikkaansa ilmoittamatta siitä. Tämä rikkoo alajärjestelmiä, jotka luottavat tiettyihin sisältötyyppeihin. Omistettu sensuroimaton palvelu poistaa tämän epävarmuuden. Promptisi palautuvat täsmälleen sen, mitä malli tuottaa.

Harkitse eroa chat-käyttöliittymän ja raakapohjaisen API:n välillä. Chat-käyttöliittymä voi piilottaa hienovaraisia tuloksia. API paljastaa koko tokenivirran. Tämä läpinäkyvyys on kriittistä kehittäjille, jotka rakentavat erikoistyökaluja.

Palvelumme toimii itsenäisesti. Emme tarjoa Grokia tai muita toimittajien malleja. Tarjoamme erillisen sensuroimattoman suuren kielimallin. Se toimii omilla palvelimillamme. Käyttöliittymä on tuttu OpenAI-käyttäjille.

Keskeiset edut

• Ei kuukausimaksuja.
• Läpinäkyvä esimaksulaskutus.
• Raaka sisältö lailliseen aikuis sisältöön.
• Ei piilotettuja hylkäyksiä kiistanaisille aiheille.

Ymmärrä API-päätepisteen rakenne

Kaksi päätepistettä käsittelee kaikkia vuorovaikutuksia: POST /v1/chat/completions ja GET /v1/models. Noudattavat vakiintunutta OpenAI API -standardia. Lähetät JSON-payloadin järjestelmä- ja käyttäjäviestien kanssa. Palvelin palauttaa JSON-vastauksen generoidulla tekstillä.

GET-päätepiste listaa käytettävissä olevat mallit. Se vahvistaa, että yhteytesi on kunnossa. Käytä tätä varmistaaksesi, että API-avaimesi toimii ennen raskaiden kuormien lähettämistä. Se näyttää myös mallin tunnuksen, joka sinun on sisällytettävä pyyntöihisi.

base URL-osoitteemme on HTTPS://api.isgrokunfiltered.com/v1. Tämä korvaa oletusarvoisen OpenAI-URL-osoitteen asiakasasetuksissasi. Lähetettävän mallin tunnuksen on oltava "uncensored". Tämä varmistaa, että osut oikeaan palvelimeen.

Todennus käyttää Bearer-tokenia Authorization-otsikkotiedoissa. Sisällytä API-avaimesi suoraan. Monimutkaisia OAuth-virtoja ei tarvita. Tämä yksinkertaisuus vähentää integrointiaikaa merkittävästi.

Päätepisteen yhteenveto

Menetelmä	Polku	Funktio
POST	/v1/chat/completions	Tuottaa tekstivastauksia
GET	/v1/models	Luettelee saatavilla olevat mallit

Asiakasohjelman määrittäminen streamausta varten

Ota käyttöön streamaus asettamalla stream-parametri arvoksi true pyynnön runkossa. Tämä palauttaa Server-Sent Events -tapahtumia (SSE) yhden JSON-objektin sijaan. Jokainen tapahtuma sisältää osan vastauksesta. Voit näyttää tekstin käyttäjille reaaliajassa.

Streamaus vähentää havaittua viivettä pitkissä vastauksissa. Käyttäjät näkevät tulosteen sen generoitessa. Tämä parantaa kokemusta chat-tyyppisissä liittymissä. Se mahdollistaa myös pyyntöjen keskeyttämisen varhain tarvittaessa.

Jokainen palikka sisältää token-käyttötiedot viimeisessä tapahtumassa. Voit seurata syötteiden ja lähtöjen tokenit tarkasti. Tämä auttaa sinua valvomaan esimaksutason saldoasi. Virheet streamauksen aikana kuluttavat silti tokenit käsitellyn datan osalta.

Käsittele SSE-muoto oikein. Jäsennä jokainen rivi, joka alkaa "data: ". Ohita lopullinen "[DONE]"-tapahtuma. Tämä varmistaa, että sovelluksesi käsittelee jokaisen tokenin oikein.

Copyfrom openai import OpenAI

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

Funktioittamisen käsittely uncensored-tilassa

Function calling mahdollistaa sovelluksesi suorittaa koodia mallin tulosten perusteella. Lähetä lista työkaluista pyynnössä. Malli palauttaa tool_calls-taulukon tavallisen tekstin sijaan. Koodisi suorittaa funktion ja lähettää tuloksen takaisin.

Tämä toimii saumattomasti sensuroimattoman mallin kanssa. Malli ei kieltäydy kutsumasta toimintoja sisällön tyypin perusteella. Se keskittyy pyynnön loogiseen rakenteeseen. Tämä on ihanteellista monimutkaisiin datan erottamistehtäviin.

Käytä JSON-tilaa pakottaaksesi tiukat tulostusmuodot. Aseta response_format arvoksi json_object. Malli palauttaa vain kelvollisen JSON-tiedoston. Tämä vähentää jäsentamisvirheitä backendissasi. Se varmistaa johdonmukaiset datastruktuurit.

Yhdistä funktiokutsut streamaukseen dynaamisia vuorovaikutuksia varten. Voit aloittaa funktioiden suorittamisen, kun malli vielä generoi. Tämä luo erittäin responsiivisen sovelluksen. uncensored-malli käsittelee monenlaisia työkalumäärittelyjä ilman harhaa.

Copyimport OpenAI from "openai";

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

Token-kustannusten optimointi pitkille konteksteille

Kontekstiluukku tukee jopa 100 000 tokenia. Tämä sisältää sekä promptin että completionin. Pidemmät kontekstit kuluttavat enemmän esimaksukrediittiä. Seuraa tokenkäyttöäsi välttääksesi yllättävät laskut.

Syötetokenit maksavat $0.15 miljoonaa kohti. Tulostetokenit maksavat $0.50 miljoonaa kohti. Tulostetokenit ovat merkittävästi kalliimpia. Optimoi promptisi vähentääksesi syötteen kokoa. Käytä ytimekkäitä järjestelmäohjeita. Vältä tarpeettoman historian lähettämistä.

Aseta max_tokens-parametri hallitsemaan lähtöpituutta. Oletusarvo on 2 048 tokenia. Voit lisätä tätä jopa 16 000 tokeniin pyyntöä kohden. Tämä estää hallitsemattoman generoinnin, joka polttaa krediittejä nopeasti.

Virheet ja hylkäykset ovat ilmaisia. Maksat vain onnistuneesta token-generoinnista. Tämä suojaa sinua hukkaamasta rahaa epäonnistuneisiin pyyntöihin. Seuraa saldoasi säännöllisesti pysyäksesi ajan tasalla.

Hinnan erittely

• Syöte: $0,15 / 1M tunniste
• Lähtö: 0,50 $ / 1M tokenttia
• Max Output: 16 000 tokenia
• Kontekstiuikkuna: 100 000 tokenia

Nopeusrajoitukset ja samanaikaisuusasetukset

Jokainen API-avain sallii 300 pyyntöä minuutissa. Tämä raja koskee avaintasi globaalisti. Korkeataajuisisten sovellusten on hallittava pyyntönopeutta huolellisesti. Rajan ylitys palauttaa 429 Liian monta pyyntöä -virheen.

Voit tehdä enintään 8 samanaikaista pyyntöä avainta kohti. Tämä mahdollistaa riippumattomien tehtävien rinnakkaisen käsittelyn. Hallitse samanaikaisuutta välttääksesi nopeusrajoitusten ylittymisen. Jaa pyynnöt aikavälien yli.

Pyynnön rungon maksimikoko on 8 Mt. Suuret tietopaketit, joissa on laaja historia, voivat ylittää tämän rajan. Purista syötettäsi tai leikkaa vanhoja viestejä. Tämä varmistaa, että pyyntösi käsitellään onnistuneesti.

Tilillä voi olla vain yksi aktiivinen avain. Jos menetät avaimen, luo uusi. Vanha avain mitätöityy välittömästi. Tämä yksinkertaistaa tietoturvan hallintaa. Kierrä avaimia säännöllisesti lisäturvallisuuden vuoksi.

Copycurl https://api.isgrokunfiltered.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 five unique Python script ideas."}]
  }'

Olemassa olevien Grok API -avainten migröinti

Migrating to our API requires changing the base URL and model ID. Your existing client code structure remains largely the same. Update the base URL to HTTPS://api.isgrokunfiltered.com/v1. Change the model ID to "uncensored".

Vianmääritys yleisistä integraatiovirheistä

401 Ei valtuutettu -virheet viittaavat virheelliseen tai vanhentuneeseen API-avaimeseen. Tarkista avaimesi hallintapaneelista. Varmista, että lähetät sen Authorization-headerissa. Tarkista johtavat välilyönnit tai kirjoitusvirheet.

429 Liian monta pyyntöä tarkoittaa, että osuit nopeusrajaan. Vähennä pyyntöjen taajuutta tai lisää väliaikaa kutsujen välillä. Käytä eksponentiaalista taaksepäinpalautusta uusintoihin. Tämä estää palvelimen kuormittamisen.

400 Bad Request johtuu usein virheellisestä JSONista. Varmista, että payloadisi vastaa odotettua skeemaa. Tarkista puuttuvat pakolliset kentät kuten messages tai model. Käytä GET-päätepistettä varmistaaksesi mallin saatavuuden.

500 Internal Server Error -virheet ovat harvinaisia, mutta mahdollisia. Yritä pyyntöä uudelleen lyhyen viiveen jälkeen. Jos ongelma jatkuu, ota yhteyttä tukeen. Lokimme auttavat tunnistamaan vian syy nopeasti.

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)

Seuraavat askeleet: Testaa uncensored-mallia

Aloita yksinkertaiseen tekstigenerointipyyntöön. Lähetä lyhyt prompt ja varmista vastausmuoto. Tarkista, että suoratoisto toimii oikein. Varmista, että toimintokutsut integroituvat sujuvasti koodiisi.

Seuraa token-käyttöä tarkasti. Esimalliperusteinen malli peri vain todelliset tokenit. Virheet ovat ilmaisia. Tämä mahdollistaa turvallisen kokeilun. Täydennä saldoa kryptolla tarpeen mukaan.

Testaa ääritapauksia kuten pitkiä konteksteja ja monimutkaisia työkalumäärittelyjä. Varmista, että rajoittamaton malli käsittelee monenlaisia aiheita. Varmista, että sovelluksesi käsittelee osittaiset vastaukset oikein. Tämä valmistaa sinua tuotantokäyttöön.

Rekisteröidy Google- tai sähköpostitunnuksella. Saat API-avaimesi välittömästi. Puhelinnumeroa ei tarvita. Aloita testaaminen heti $0.50 kokeilusaldoilla. Tämä tarjoaa riskittömän tavan arvioida palvelua.