API-dokumentaatio

Perus-URL ja todennus

Pyyntöjen perusosoite on HTTPS://api.aiobliterated.com/v1. Tarvitset API-avaimen todennusta varten. Luo se kirjautumalla Google-tilillä tai sähköpostilla ja salasanalla Get API key -sivulla. Syötä avain Authorization-headeriin Bearer-tokenina. Jokaisessa pyynnössä tämä header tarvitaan tunnistamaan tilisi ja seuraamaan käyttöä.

Copycurl https://api.aiobliterated.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch all user tokens from database"}]
  }'

Ensimmäinen pyyntösi

Lähetä POST-pyyntö osoitteeseen /v1/chat/completions tekstin luomiseksi. Aseta malli arvoksi "uncensored" ja sisällytä järjestelmäpromptisi. API palauttaa mallin vastauksen content-kentässä. Tämä on useimpien LLM-asiakkaiden käyttämä vakiomuoto.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.aiobliterated.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 SDK:n käyttäminen

Asenna virallinen OpenAI:n SDK Node.js:lle. Määritä se API-avaimellasi ja base URL -osoitteella. Kutsu chat.completions.create-metodia viestiesi kanssa. SDK hoitaa serialisoinnin ja streamauksen automaattisesti.

Copyimport OpenAI from "openai";

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

Streamausvastaukset

Ota käyttöön suoratoisto asettamalla stream arvoon true pyynnössäsi. API palauttaa streamin palvelimen lähettämiä tapahtumia. Jokainen tapahtuma sisältää osittaisen lohkon vastauksesta. Tämä mahdollistaa tekstin näyttämisen sen tuotannon aikana, mikä parantaa käyttökokemusta.

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)

Kontekstiluukku ja rajoitukset

Malli tukee 100 000 tokenin kontekstiikkunaa. Tämä sisältää sekä syötteen että tuloksen. Voit asettaa enimmäistuotoskokoeksi 16 000 tokenia pyyntöä kohti. Jos et määritä max_tokens-arvoa, raja on 2 048 tokenia. Tämä varmistaa ennustettavat kustannukset ja suorituskyvyn.

Virheenkäsittely ja rajat

Valvo HTTP-tilakoodit virheiden varmistamiseksi. 401-vastaus tarkoittaa, että API-avaimesi on virheellinen. 402-vastaus osoittaa riittämätöntä krediittiä. 429-vastaus merkitsee, että ylittänyt nopeusrajoituksen 300 pyyntöä minuutissa. Käsittele nämä virheet hienovaraisesti sovelluksessasi luotettavuuden ylläpitämiseksi.