Pika-aloitus: Integroi uncensored-API

Edellytykset ja SDK-asennus

API vaatii kelvollisen API-avaimen ja modernin SDK:n. Asenna kirjasto haluamaasi kieleen pip:n tai npm:n kautta. Tuemme vakiomaisia OpenAI-asiakirajapintakirjastoja, jotka hoitavat todennuksen ja JSON-jäsennyksen automaattisesti.

Varmista, että Python 3.8+ tai Node.js 18+ on asennettuna. SDK:t hallitsevat yhteyksien hallintaa ja uudelleenyrittelylogiikkaa puolestasi. Tämä vähentää merkittävästi boilerplate-koodia.

Copyfrom openai import OpenAI

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

Perus-URL-osoitteen ja API-avaimen määrittäminen

Ohjaa asiakasohjelmistosi tiettyyn päätepisteeseen. Käytä hallintapaneelissasi annettua base URL -osoitetta. Anna API-avaimesi Authorization-headerissa. Tämä varmistaa, että pyynnöt kohdistuvat suoraan rajoituksettomalle infrastruktuurille.

Älä käytä oletusarvoista OpenAI:n perusURL-osoitetta. Avaimesi epäonnistuu, jos se reititetään virheellisesti. Aseta perusURL SDK-konfiguraatio-objektissa ennen minkään datan lähettämistä.

Copycurl https://api.ablatedmodels.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Send me the monthly server uptime report"}]
  }'

Ensimmäisen keskustelun täydennyspyynnön lähettäminen

Lähetä POST-pyyntö osoitteeseen /v1/chat/completions. Sisällytä mallin tunnus ja messages-taulukko. Malli vastaa välittömästi tekisisältöä. Monimutkaista reititykslogiikkaa ei tarvita.

Pidä tietopaketti yksinkertaiseksi. Aloita yhdellä järjestelmäpromptilla ja yhdellä käyttäjäviestillä. Varmista, että vastauksen rakenne vastaa OpenAI-standardia. Tämä vahvistaa, että integraatiosi toimii oikein.

Copyimport OpenAI from "openai";

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

Striimitettyjen vastausten ja työkalukutsujen käsittely

Ota käyttöön suoratoisto asettamalla stream arvoon true. API palauttaa lohkoja palvelimen lähettämien tapahtumien kautta. Jokainen lohko sisältää osittaista tekstiä tai tokenkäyttötilastoja. Yhdistä nämä lohkonäytöt reaaliaikaisen tulosteen näyttämiseen.

Työkalujen käyttöä tuetaan funktiokutsuille. Määritä työkalut pyynnössäsi. Malli palauttaa työkalukutsuja sen sijaan, että tuottaisi pelkkää tekstiä, kun se on asianmukaista. Jäsentele työkalukutsut suorittaaksesi mukautetun logiikkasi.

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)

Ymmärrä tokenirajat ja kontekstiikkuna

Konteksti-ikkuna tukee yhteensä 100 000 tokenia. Tämä sisältää sekä syöte- että tulostetokenit. Aseta max_tokens rajoittaaksesi vastauksen pituutta. Oletusarvoinen maksimituloste on 2 048 tokenia, jos sitä ei määritetä.

Seuraa token-käyttöä viimeisessä streamauspalikassa. Virheet eivät kuluta kredittiä. Tämä mahdollistaa turvallisen kokeilun ilman taloudellista riskiä. Suunnittele syötteesi rakenne pysyäksesi rajan sisällä.

Vianmääritys yleisistä virheistä

Tarkista API-avaimesi ensin. 401-virhe tarkoittaa virheellistä tai vanhentunutta avainta. 402-virhe tarkoittaa, että esimaksukrediittisi on loppu. Lataa saldo uudelleen kryptolla jatkaaksesi.

Virhe 429 ilmoittaa nopeusrajoituksesta. Sinulla on rajoitus 300 pyyntöä minuutissa. Vähennä samanaikaisuuttasi tai odota ennen uudelleenkäynnistystä. 8 Mt:n kehikkoraja aiheuttaa myös virheen 400, jos se ylitetään.