API-pika-aloitus: Chat Completions

Todennus & Base URL

API-avaimesi todentaa jokaisen pyynnön. Käytä Authorization header arvo Bearer mekanismin. Perus-URL-osoitteesi on https://api.nsfwopenrouter.com/v1. Tämä URL toimii minkä tahansa OpenAI-yhteensopivan SDK:n kanssa. Sinun ei tarvitse tilausta. Maksetaan vain käytetyistä tokenneista. Virheet ja hylkäykset eivät aiheuta kustannuksia. Rekisteröidy Google-tilin tai sähköpostin kautta saadaksesi avaimesi välittömästi.

Lähettämällä chat-completion-pyyntö

Lähetä POST-pyyntö osoitteeseen /v1/chat/completions. Mallin tunnus on aina uncensored. Anna järjestelmäpromptisi määrittämään käyttäytyminen. Sisällytä käyttäjäviestit kenttään messages taulukkoa. API palauttaa tekstitulosteen suoraan. Monimutkaista reititystä ei tapahdu. Liikenne kulkee suoraan palvelimillemme. Tämä varmistaa johdonmukaisen NSFW-käsittelyn ilman ylävirran suodattimia.

Striimitettyjen vastausten käsittely

Ota streamaus käyttöön asettamalla stream vastaan true. API palauttaa Server-Sent Events -tapahtumavirran (SSE). Jokainen palautusosuus sisältää osittaisen tekstin. Token-käytön tiedot ilmestyvät viimeisessä palautusosuudessa. Tämä vähentää käyttäjien kokemaa viivettä. Se mahdollistaa tuotetun sisällön näyttämisen reaaliajassa. Käsittele virheet virran käsittelylogiikassa. Hylkää epätäydelliset palautusosuudet virhetilanteessa.

Malliparametrien määrittäminen

Säädä temperature luovuuteen. Käytä top_p ytimenäytteistykseen. Aseta max_tokens rajoittamaan tulosteen pituutta. Maksimiarvo on 2 048 tokenia. Voit pyytää jopa 16 000 tokenia pyyntöä kohden. Kontesttilaajuus tukee yhteensä 100 000 tokenia. Tämä sisältää sekä promptin että täydennyksen. Hienosäädä näitä asetuksia tarkkoihin roolipelitarpeisiisi.

JSON-tilan pakottaminen

Käyttö response_format kanssa {"type": "json_object"}. Malli takistaa validin JSON-tulosteen. Tämä rakenne on olennaista ohjelmalliseen integraatioon. Jäsentele vastaus suoraan sovellusobjekteihisi. Vältä regex-jäsennyystä luotettavuuden vuoksi. Tämä varmistaa johdonmukaisen datan erottelun. Se toimii saumattomasti standardien SDK:iden kanssa.

Ymmärrä työkalukutsut

Määritä työkalut pyynnön runkoon. Malli voi palauttaa rakenteisia funktiokutsuja. Käytä tool_choice pakottaa tiettyjä käyttäytymisiä. Tämä mahdollistaa dynaamiset agenttityönkulut. API tukee vakioitua OpenAI-työkalumuotoa. Jäsennä tool_calls taulukko vastauksessa. Suorita funktiot ja syötä tulokset takaisin. Tämä mahdollistaa monimutkaiset monivaiheiset vuorovaikutukset.

cURL

Copycurl https://api.nsfwopenrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run my unit tests and show results"}]
  }'

Python

Copyfrom openai import OpenAI

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