API-pika-aloitus

Perus-URL ja todennus

Aloita osoittamalla asiakasohjelma base URL -osoitteeseemme ja välittämällä avaimesi headeriin. Käytämme standardia Authorization-menetelmää, joten mikä tahansa OpenAI-SDK tai yhteensopiva asiakasohjelma toimii heti. Sinun ei tarvitse hallita monimutkaisia OAuth-virtoja tai odottaa hyväksyntää. Kirjaudu vain sisään Googlen tai sähköpostin avulla, kopioi avain ja olet valmis. Päätepiste on https://api.aiohnezensur.com/v1 ja hyväksyy Authorization: Bearer YOUR_API_KEY header jokaisessa pyynnössä.

Ensimmäisen pyynnön lähettäminen

Tee yksinkertainen chat-täydennyskutsu testaaksesi uncensored-mallia. Tämä pyyntö lähettää kehotteen ja vastaanottaa tekstimuotoisen vastauksen ilman tavallisia yritysten suojakenttiä. Voit käyttää mitä tahansa OpenAI-protokollaa tukevaa työkalua, mutta suora curl-kutsu näyttää tarkasti, mitä tapahtuu taustalla. Korvaa YOUR_API_KEY oikealla avaimellasi hallintapaneelista.

Copycurl https://api.aiohnezensur.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list 5 free open source image generators"}]
  }'

Vastaus sisältää luodun tekstin ja token-käystilastot. Jos saat vastauksen, integraatiosi toimii oikein. Voit nyt siirtyä rakentamaan monimutkaisempia vuorovaikutuksia tai vaihtaa ohjelmoitaviin asiakkaisiin.

Python SDK -integraatio

Käytä virallista OpenAI:n Python-pakettua vuorovaikutukseen API:n kanssa saumattomasti. Aseta base URL osoittamaan päätepisteeseemme ja anna avaimesi API-tokenina. Tämä mahdollistaa olemassa olevien koodikantojen hyödyntämisen ilman HTTP-logiikan uudelleenkirjoittamista. Mallin tunnus on uncensored, joka käynnistää nimenomaisen suuren kielimallin, joka on hienosäädetty rajoittamattomaan lähtöön.

Copyfrom openai import OpenAI

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

Tämä koodinpätkä demonstroi perusviestinvaihtoa. Voit säätää messages-taulukkoa sisältämään system-promptteja tai keskusteluhistoriaa. SDK hoitaa sinulta serialisoinnin ja virheiden jäsentämisen.

Node SDK -integraatio

Integroi API JavaScript- tai TypeScript-sovelluksiin käyttämällä Node SDK:ta. Määritä perus-URL ja API-avain samalla tavalla kuin Python-esimerkissä. Tämä lähestymistapa toimii hyvin palvelinsivuisessa renderöinnissä tai backend-mikropalveluissa. SDK abstrahoi verkkokerroksen, jolloin voit keskittyä prompt-logiikkaan.

Copyimport OpenAI from "openai";

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

Suorita tätä koodia nähdäksesi mallin vastaavan syötteeseesi. Voit iteroida nopeasti muuttamalla promptin sisältöä. Vastauksen rakenne vastaa standardia OpenAI-muotoa, varmistaen yhteensopivuuden muiden työkalujen kanssa pinoissasi.

Streamausvastaukset

Ota käyttöön streamaus, jotta saat tokenit vastaanotettua niiden luomisen aikana, mikä vähentää koettua viivettä. Tämä on ratkaisevan tärkeää käyttöliittymille, jotka näyttävät tekstiä reaaliajassa. Aseta stream parametri true pyynnössäsi. API lähettää sarjan Server-Sent Events (SSE) -viesteitä yksittäisen JSON-objektin sijaan. Jokainen osa sisältää osittaisen vastauksen delta-arvon.

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)

Liitä nämä delta-arvot asiakaspäässä rekonstruoidaksesi koko viestin. Tämä menetelmä tuntuu välittömältä käyttäjälle, jopa pitkien tulosten osalta. Viimeinen lohko sisältää kokonaistokenkäytön, mikä mahdollistaa tarkan laskutuksen.

Nopeusrajoitukset ja rajoitukset

Ymmärrä tekniset rajat estääksesi pyyntöjen epäonnistumisen tuotannossa. Sinulla on lupa tehdä 300 pyyntöä minuutissa avainta kohden ja sinulla voi olla 8 samanaikaista pyyntöä. Pyyntöruumiin koko ei saa ylittää 8 Mt. Jos ylität nämä rajat, API palauttaa tilakoodin 429. Sinun tulisi toteuttaa eksponentiaalinen taaksepäin haku asiakkaassasi käsitelläksesi näitä piikkejä sujuvasti. Kontekstikkone on yhteensä 100 000 tokennia, maksimi lähtö on 16 000 tokenia pyyntöä kohden. Virheet ja kieltämiset eivät kuluta luottoa, joten voit yrittää uudelleen turvallisesti. Todennusvirheet palauttavat 401, ja riittämättömät varat palauttavat 402.