API-dokumentaatio

Pika-aloitus: Yhdistä ensimmäinen pyyntösi

Aloita avaimen luomin kojelaudasta. Kaikkien pyyntöjen perus-URL on HTTPS://api.filterno.cc/v1. Syötä avaimesi Authorization-otsakkeeseen bearer-tokenina. Tämä kokoonpano toimii minkä tahansa standardin OpenAI-yhteensopivan asiakkaan kanssa.

Testaa yhteyttä välittömästi yksinkertaisella päätöspyyntöllä. Päätepiste hyväksyy vakiot chat-muodot ja palauttaa raakatekstin ilman sisältösuodattimia.

Korvaa YOUR_API_KEY merkkijonolla, joka on annettu tilillesi. Pyynnön runko määrittää mallin ja viestisisällön. Saat vastauksen, joka sisältää luodun tekstin.

Päätepiste: POST /v1/chat/completions

Lähetä promptisi osoitteeseen POST /v1/chat/completions. Tämä on ainoa chat-päätepiste, jota tuemme. Syötät järjestelmäohjeen ja käyttäjäviestit taulukkomuodossa.

Mallin tunniste on "uncensored". Se käsittelee tekstisyötteen ja palauttaa tekstitulosteen. Älä odota kuvien tai äänen generointia tähän.

Aseta lämpötila hallitsemaan satunnaisuutta. Korkeammat arvot tuottavat luovempia tuloksia. Matalammat arvot tuottavat deterministisiä tuloksia. API noudattaa tiukasti OpenAI-skeemaa tähän päätepisteeseen.

Päätepiste: GET /v1/models

Vahvista saatavilla olevat mallit GET-pyynnöllä osoitteeseen /v1/models. Tämä päätepiste palauttaa luettelon tuetuista mallitunnuksista. Vastauksessa pitäisi näkyä "uncensored".

Tämä päätepiste vahvistaa API-avaimesi voimassaolon. Se näyttää myös mallin tiedot. Käytä sitä yhteysongelmien vianmääritykseen.

Vastaus sisältää mallin tunnuksen ja objektityypin. Se ei luettele hintoja tai rajoituksia. Tarkista dokumentaatiosta token-hinnat.

Parametrit: lämpötila, Top-P ja työkalut

Säädä tuotannon monimuotoisuutta lämpötilan ja top_p:n avulla. Lämpötila säätää todennäköisyysjakaumaa. Top_p suodattaa matalan todennäköisyyden tokenneja. Yhdessä ne tasapainottavat luovuutta ja tarkkuutta.

Käytä funktiokutsuja rakenteisiin vuorovaikutuksiin. Määrittele työkalut pyyntöruumiissa. Malli voi kutsua näitä funktioita. Välitä tool_choice pakottaaksesi tietyn käyttäytymisen.

Aseta stop-sekvenssit lopettaaksesi tuotannon ajoissa. Käytä seed-toistettavien tulosten saamiseksi. Presence- ja frequency-penaltyt vähentävät toistoa. Nämä parametrit noudattavat OpenAI-standardikäytäntöjä.

Streamausvastaukset (SSE) & merkkikäyttö

Ota käyttöön suoratoisto asettamalla stream arvoon true. API palauttaa palvelimen lähettämiä tapahtumia (SSE). Jokainen lohko sisältää osittaista tokenidataa.

Token-käyttö näkyy viimeisessä palassa. Lue se seurataksesi kustannuksia. Streamaus vähentää koettua viivettä pitkissä vastauksissa. Se on ihanteellinen reaaliaikaisiin sovelluksiin.

Jäsennä SSE-datarakennetta huolellisesti. Käsittele verkkokatkokset sulavasti. API varmistaa tietojen eheyden osarajojen kautta.

Rajoitukset, virheet ja tokenien aritmetiikka

Saat 300 pyyntöä minuutissa per avain. Samanaikaisuus on rajoitettu 8 samanaikaiseen pyyntöön. Pyyntörungon maksimikoko on 8 Mt.

Kontekstuuri-ikkuna on 100 000 tokenia. Tämä sisältää promptin ja vastauksen. Maksimipituus on 16 000 tokenia. Aseta max_tokens rajoittaaksesi käyttöä.

Käsittele virheet tarkistamalla tilakoodit. 401 tarkoittaa virheellistä avainta. 402 tarkoittaa, että saldoa ei ole. 429 ilmoittaa nopeusrajoituksesta. Yritä uudelleen eksponentiaalisella viiveparannuksella 429-virheiden yhteydessä.

cURL

Copycurl https://api.filterno.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top five risks in a standard React application."}]
  }'

Python

Copyfrom openai import OpenAI

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