API Documentatie

Snelstart: Verbind uw eerste verzoek

Genereer eerst uw sleutel op het dashboard. De basis-URL voor alle verzoeken is HTTPS://api.filterno.cc/v1. Voeg uw sleutel toe in de Authorization-header als bearer-token. Deze setup werkt met elke standaard OpenAI-compatibele client.

Test de connectiviteit direct met een eenvoudige completion-request. Het endpoint accepteert standaard chatformaten en retourneert ruwe tekst zonder contentfilters.

Vervang YOUR_API_KEY door de string die aan je account is uitgegeven. De request body definieert het model en de berichtinhoud. Je ontvangt een antwoord met de gegenereerde tekst.

Eindpunt: POST /v1/chat/completions

Stuur je prompts naar POST /v1/chat/completions. Dit is het enige chat-eindpunt dat we ondersteunen. Je geeft een systeem-instructie en gebruikersberichten in een array-indeling.

De modelidentifier is "uncensored". Het verwerkt tekstinput en retourneert tekstoutput. Verwacht hier geen beeld- of audiogeneratie.

Stel de temperatuur in om willekeurigheid te regelen. Hogere waarden leveren meer creatieve outputs op. Lagere waarden leveren deterministische resultaten op. De API volgt strikt het OpenAI-schema voor dit eindpunt.

Eindpunt: GET /v1/models

Verifieer beschikbare modellen met een GET-verzoek naar /v1/models. Dit eindpunt retourneert een lijst met ondersteunde model-ID's. U zou "uncensored" in de respons moeten zien.

Dit endpoint bevestigt dat je API-sleutel geldig is. Het toont ook de modeldetails. Gebruik het voor het debuggen van verbindingsproblemen.

De respons bevat het model-ID en het objecttype. Het geeft geen prijzen of limieten weer. Raadpleeg de documentatie voor token tarieven.

Parameters: Temperatuur, Top-P en Tools

Reguleer de diversiteit van de generatie met temperatuur en top_p. Temperatuur past de waarschijnlijkheidsverdeling aan. Top_p filtert tokens met een lage waarschijnlijkheid. Samen balanceren ze creativiteit en focus.

Gebruik function calling voor gestructureerde interacties. Definieer tools in de request body. Het model kan deze functies aanroepen. Geef tool_choice door om specifiek gedrag af te dwingen.

Stel stopvolgorde in om de generatie vroegtijdig te beëindigen. Gebruik seed voor reproduceerbare resultaten. Presence- en frequency-penalties verminderen herhaling. Deze parameters volgen de standaard OpenAI-conventies.

Streaming-responsen (SSE) & tokengebruik

Schakel streamen in door stream in te stellen op true. De API retourneert Server-Sent Events (SSE). Elke chunk bevat gedeeltelijke tokengegevens.

Tokenverbruik verschijnt in de laatste chunk. Lees dit om kosten te volgen. Streaming vermindert de waargenomen latentie voor lange antwoorden. Dit is ideaal voor realtime-toepassingen.

Parseer de SSE-datamatrix zorgvuldig. Afhandelen van netwerkonderbrekingen op een soepele manier. De API waarborgt gegevensintegriteit door chunk-grenzen.

Limieten, fouten en tokenrekenkunde

Je krijgt 300 verzoeken per minuut per sleutel. Concurrency is beperkt tot 8 gelijktijdige verzoeken. De maximale grootte van de request body is 8 MB.

Het contextvenster is 100.000 tokens. Dit omvat prompt en voltooiing. Maximaal uitvoer is 16.000 tokens. Stel max_tokens in om gebruik te beperken.

Verwerk fouten door statuscodes te controleren. 401 betekent ongeldige sleutel. 402 geeft geen tegoed aan. 429 signaleert snelheidslimiet. Probeer opnieuw met exponentiële backoff voor 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)