Pika-aloitus: integroi minuuteissa

1. Asenna SDK

Aloita asentamalla kielen virallinen kirjasto. Useimmat kehittäjätkäyttävät mieluiten standardia pakettia, koska se vastaa jo tuttua käyttöliittymää. Suorita pip install openai Pythonille tai npm install openai Node.js:lle. Tarvitset vain yhden SDK:n käsittelemään kaikki pyynnöt.

2. Aseta base URL

Määritä asiakasohjelmisto osoittamaan spesifiin päätepisteeseesi. Sinun on ohitettava oletusbase URL ohjataksesi liikkeen oikein. Käytä https://api.unsencoredai.com/v1 pohja-URL:ksi. Välitä API-avaimesi kenttään Authorization header. Tämä kokoonpano toimii minkä tahansa standardin OpenAI-yhteensopivan asiakkaan kanssa.

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

3. Lähetä ensimmäinen pyyntösi

Lähetä vakio chat-completion pyyntö tekstin luomiseksi. Mallin tunnus on uncensored. Voit lähettää system-promptit ohjaamaan mallin käyttäytymistä. API palauttaa suoran tekstivastauksen. Käytä alla olevaa curl-komentoa testataksesi yhteyden välittömästi. Tarkista vastauksestasi kenttä choices tietorakenteella.

Copycurl https://api.unsencoredai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the version number"}]
  }'

4. Käsittele streamausvastauksia

Ota suoratoisto käyttöön matalamman viiveen ja reaaliaikaisen tulostuksen saavuttamiseksi. Aseta stream: true pyynnössäsi. API lähettää osia Server-Sent Events -tekniikalla. Voit käsitellä jokaisen tokenin sen saapuessa. Tämä on ihanteellista keskustelujärjestelmiin tai roolipelitehtäviin. Viimeinen osa sisältää käyttötilastot.

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)

5. Määritä parametrit

Säädä temperature, top_p, ja stop sekvenssit. Nämä säätimet vaikuttavat luovuuteen ja tuoton pituuteen. Voit myös käyttää response_format JSON-tila. Kontekstiikkuna tukee yhteensä 100 000 tokenia. Maksimilähtö on 16 000 tokenia pyyntöä kohti. Säädä näitä asetuksia tiettyyn käyttötarkoitukseesi.

6. Rajat, virheet ja konteksti

Käsittele virheet joustavasti käyttäen standardit HTTP-tilakoodit. 401-virhe tarkoittaa, että API-avaimesi on virheellinen. 402-virhe tarkoittaa riittämätöntä esimaksukrediittiä. 429-virhe merkitsee, että osuit 300 pyynnön minuutissa -rajaan. Kontekstiikkunasi on 100 000 tokeniä. Pyynnöt, jotka ovat yli 8 Mt, voivat epäonnistua. Palautuksia ei myönnetä krediiteille, mutta virheet ovat ilmaisia.