Dokumentace API

Rychlý start: Připojení prvního požadavku

Začněte vygenerováním svého klíče na ovládacím panelu. Základní URL pro všechny požadavky je HTTPS://api.filterno.cc/v1. Předejte svůj klíč v hlavičce Authorization jako bearer token. Toto nastavení funguje s libovolným standardním klientem kompatibilním s OpenAI.

Otestujte připojení okamžitě jednoduchou žádostí o dokončení. Endpoint přijímá standardní formáty chatu a vrací surový text bez filtrů obsahu.

Nahraďte YOUR_API_KEY řetěcem vydaným vašemu účtu. Tělo požadavku definuje model a obsah zprávy. Obdržíte odpověď obsahující vygenerovaný text.

Koncový bod: POST /v1/chat/completions

Pošlete své podněty na POST /v1/chat/completions. Toto je jediný chat endpoint, který podporujeme. Poskytujete systémovou instrukci a zprávy uživatele ve formátu pole.

Identifikátor modelu je „uncensored“. Zpracovává textový vstup a vrací textový výstup. Neočekávejte zde generování obrázků nebo audia.

Nastavte teplotu pro ovládání náhodnosti. Vyšší hodnoty produkují kreativnější výstupy. Nižší hodnoty poskytují deterministické výsledky. API přísně dodržuje schéma OpenAI pro tento endpoint.

Koncový bod: GET /v1/models

Ověřte dostupné modely pomocí GET požadavku na /v1/models. Tento endpoint vrací seznam podporovaných ID modelů. V odpovědi byste měli vidět "uncensored".

Tento endpoint potvrzuje, že váš API klíč je platný. Zobrazuje také detaily modelu. Použijte jej pro ladění problémů s připojením.

Odpověď zahrnuje ID modelu a typ objektu. Neuvádí ceny ani limity. Podívejte se do dokumentace pro sazby tokenů.

Parametry: Teplota, Top-P a Tools

Ovládejte rozmanitost generování pomocí temperature a top_p. Temperature upravuje pravděpodobnostní rozdělení. Top P odfiltruje tokeny s nízkou pravděpodobností. Společně vyvažují kreativitu a zaměření.

Používejte volání funkcí pro strukturované interakce. Definujte nástroje v těle požadavku. Model může tyto funkce zavolat. Předáte tool_choice pro vynucení specifického chování.

Nastavte sekvence stop pro předčasné ukončení generování. Použijte seed pro reprodukovatelné výsledky. Penalty pro přítomnost a frekvenci snižují opakování. Tyto parametry se řídí standardními konvencemi OpenAI.

Streamované odpovědi (SSE) a spotřeba tokenů

Povolte streamování nastavením stream na true. API vrací Server-Sent Events (SSE). Každý chunk obsahuje částečná data tokenů.

Data o použití tokenů se objeví ve finálním chunku. Přečtěte si je pro sledování nákladů. Streamování snižuje vnímanou latenci u dlouhých odpovědí. Je ideální pro aplikace v reálném čase.

Parsovejte strukturu SSE pečlivě. Zpracujte přerušení sítě gracefulně. API zajišťuje integritu dat prostřednictvím hranic částí.

Limity, chyby a aritmetika tokenů

Získáte 300 požadavků za minutu na klíč. Paralelismus je omezen na 8 současných požadavků. Maximální velikost těla požadavku je 8 MB.

Okno kontextu má 100 000 tokenů. To zahrnuje prompt a odpověď. Maximální výstup je 16 000 tokenů. Nastavte max_tokens pro omezení využití.

Zpracujte chyby kontrolou status kódů. 401 znamená neplatný klíč. 402 signalizuje nedostatek kreditu. 429 signalizuje limit rychlosti. Opakujte s exponenciálním backoffem pro 429.

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);

Streamování

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)