Documentație API

Începe rapid: Prima Cerere

Începeți prin a genera cheia pe panoul de control. URL-ul de bază pentru toate solicitările este HTTPS://api.filterno.cc/v1. Transmiteți cheia în antetul Authorization ca token bearer. Această configurare funcționează cu orice client standard compatibil cu OpenAI.

Testați conectivitatea imediat cu o simplă solicitare de completare. Endpointul acceptă formate standard de chat și returnează text brut, fără filtre de conținut.

Înlocuiți YOUR_API_KEY cu șirul emis contului dvs. Corpul cererii definește modelul și conținutul mesajului. Primești un răspuns care conține textul generat.

Punct final: POST /v1/chat/completions

Trimiteți prompturile către POST /v1/chat/completions. Acesta este singurul endpoint de chat pe care îl suportăm. Furnizați o instrucțiune de sistem și mesaje utilizator într-un format de array.

Identificatorul modelului este "uncensored". Procesează input text și returnează output text. Nu vă așteptați la generare de imagini sau audio aici.

Setează temperatura pentru a controla aleatorietatea. Valorile mai mari produc ieșiri mai creative. Valorile mai mici oferă rezultate deterministe. API-ul respectă strict schema OpenAI pentru acest endpoint.

Punct final: GET /v1/models

Verifică modelele disponibile cu o solicitare GET la /v1/models. Acest endpoint returnează o listă de ID-uri de modele acceptate. Ar trebui să vezi "uncensored" în răspuns.

Acest endpoint confirmă că cheia dvs. API este validă. De asemenea, afișează detaliile modelului. Utilizați-l pentru depanarea problemelor de conectivitate.

Răspunsul include ID-ul modelului și tipul de obiect. Nu listează prețurile sau limitele. Verifică documentația pentru tarifele pe tokeni.

Parametri: Temperatură, Top-P și Instrumente

Controlează diversitatea de generare cu temperature și top_p. Temperature ajustează distribuția de probabilitate. Top_p filtrează tokenii cu probabilitate mică. Împreună, ele echilibrează creativitatea și focalizarea.

Utilizează apelarea de funcții pentru interacțiuni structurate. Definește instrumentele în corpul cererii. Modelul poate apela aceste funcții. Transmite tool_choice pentru a impune un anumit comportament.

Setează secvențe stop pentru a încheia generarea devreme. Folosește seed pentru rezultate reproductibile. Penalizările de prezență și frecvență reduc repetiția. Acești parametri urmează convențiile standard OpenAI.

Răspunsuri în streaming (SSE) și consumul de tokeni

Activați streaming-ul setând stream la true. API-ul returnează Evenimente trimise de Server (SSE). Fiecare fragment conține date parțiale de token.

Consumul de tokenuri apare în ultimul fragment. Citiți-l pentru a urmări costurile. Streaming-ul reduce latența percepută pentru răspunsurile lungi. Este ideal pentru aplicațiile în timp real.

Analizați cu atenție structura de date SSE. Gestionați în mod elegant întreruperile de rețea. API-ul asigură integritatea datelor prin limitele de fragmente.

Limitări, Erori și Aritmetică a Tokenilor

Primești 300 de cereri pe minut per cheie. Concurența este limitată la 8 cereri simultane. Dimensiunea maximă a corpului cererii este de 8 MB.

Fereastra de context are 100.000 de tokeni. Aceasta include promptul și completarea. Output-ul maxim este de 16.000 de tokeni. Setează max_tokens pentru a limita utilizarea.

Gestionați erorile verificând codurile de stare. 401 înseamnă cheie invalidă. 402 indică lipsă credit. 429 semnalează limită de rată. Reîncercați cu backoff exponențial pentru 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);

Streaming

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)