Sensuroimaton API-pika-aloitusopas

Todennus ja base URL

Aloita osoittamalla SDK:si perusosoitteeseemme ja välittämällä avain valtakirjaotsikossa. Tarjoamme suoraa, yksimallista palvelua ilman välityspalvelimen reitityspalkkioita. Käytä standardia Authorization: Bearer mekanismin pyyntöjen tunnistamiseen. Avain luodaan välittömästi rekisteröitymisen jälkeen Google- tai sähköpostitunnuksella. Varmista, että korvaat asiakaskokoonpanon paikkamerkkiai avaimella, joka näkyy hallintapaneelissasi. Perus-URL-osoite on https://api.uncensoredmodelsollama.com/v1. Tämä päätepiste tukee vakiintuneita OpenAI-yhteensopivia asiakkaita, mikä mahdollistaa toimittajan vaihdon ilman sovelluslogiikan uudelleenkirjoittamista. Pidä avain turvassa, sillä se myöntää pääsyn esimaksutettujen krediittiesi saldon hallintaan.

Chat Completions Endpoint

Lähetä tekstipyyntöjä osoitteeseen /v1/chat/completions päätepiste vastausten generointiin. Tämä päätepiste käsittelee standardit keskusteluhistoriat ja järjestelmäohjeet. Sinun on määritettävä mallin ID arvoksi uncensored pyyntörunossa. API palauttaa JSON-muotoiset vastaukset, jotka sisältävät tuotetun tekstin ja tunnuslukutilastot. Virheet, kuten riittämätön saldo tai virheellinen avain, palautetaan asianmukaisilla HTTP-virhekoodilla. Käytä tätä päätepistettä kaikkiin vakioihin tekstin tuottamistehtäviin. Se ei tue vektoreita, kuvia tai hienosäätöä. Pidä payloadisi alle 8 Mt varmistaaksesi luotettavan käsittelyn. Malli käsittelee syötte- ja tulostustunnuksia jaetussa kontekstikkonaissa.

Streamausvastaukset

Ota virtauskäyttöön asettamalla stream parametri arvoon true pyynnössäsi. API palauttaa palvelimen lähettämiä tapahtumia (SSE), jotka sisältävät tekstin lisäosia. Tämä lähestymistapa vähentää havaittua viivettä käyttäjien odottaessa pitkiä tuotoksia. Saat tokenien käyttöinformaation streamin viimeisessä palikassa. Toteuta stream-käsittelijä asiakasohjelmaasi näiden tapahtumien tehokkaaseen käsittelyyn. Streamaus on ihanteellinen chat-käyttöliittymille ja reaaliaikaisille sovelluksille. Varmista, että asiakasohjelmistokirjastosi tukee SSE-jäsentämistä jatkuvan datavirran oikeaan käsittelyyn. Kontekstiikkunan koko pysyy 100,000 tokenissa streamaustilasta riippumatta.

Funktikutsut ja JSON-tila

Käytä tools parametri, joka ottaa käyttöön funktiokutsuominaisuudet. Määrittele funktiosi pyynnön ruumiissa mahdollistaaksesi mallin tuottaman rakenteellisen datan. Aseta response_format vastaan {"type": "json_object"} tiukan JSON-tuloksen varmistamiseksi. Tämä ominaisuus on hyödyllinen datan purkamiseen tai rakenteellisten kuormien generointiin. Malli tukee työkalun valintaparametreja toimintokutsukäyttäytymisen hallintaan. Käytä näitä ominaisuuksia integroidaksesi API:n automaattisiin työvuorokeluihin. Varmista, että toimintomäärittelysi vastaavat odotettua syöttökaavaa luotettavien tulosten saamiseksi. API palauttaa työkalukutsut standardissa OpenAI-muodossa helppoa jäsennystä varten.

Parameters and Rate Limits

Säädä generointikäyttäytymistä parametreilla kuten temperature, top_p, ja seed. Aseta max_tokens rajoittamaan tulosteen pituutta, oletusarvo on 2 048, jos sitä ei määritetä. API asettaa nopeusrajan 300 pyyntöä minuutissa per avain. Samanaikaiset pyynnöt on rajoitettu 8:aan per avain. Jos ylität nämä rajat, API palauttaa 429-tilakoodin. Pyyntöjen laskutus perustuu todelliseen tokenien käyttöön, ja virheet sekä hylkäykset ovat ilmaisia. Krediitti vanhenee, ja esimaksut ovat läpinäkyviä. Hallinnoi avaimiasi huolellisesti, sillä jokaiselle tilille sallitaan vain yksi aktiivinen avain kerrallaan.

Rajoitukset, virheet ja konteksti

Konteksti-ikkuna tukee 100 000 tokenia yhdistettyyn syötteeseen ja tulokseen. Pyynnöt, jotka ylittävät 8 Mt:n rungon kokorajan, epäonnistuvat. Yleisiä virheitä ovat 401 virallisista avaimista ja 402 riittämättömästä saldon määrästä. Käsittele nämä virheet joustavasti sovelluksesi logiikassa. API kieltää pyynnöt, jotka sisältävät alaikäisiin liittyvää seksuaalista sisältöä muiden asetusten riippumatta. Muu sisältö on sensuroimaton lailliseen aikuiskäyttöön. Seuraa token-käyttöäsi välttääksesi yllättävät kulut. Esimaksujärjestelmä varmistaa, että maksat vain käytetystä määrästä. Ei tilausmaksuja tai piilokuluja integraatiossa.

cURL

Copycurl https://api.uncensoredmodelsollama.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List all available models in the ollama library."}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

Virtaus

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)