Integratiegids

Snelstart: uw eerste verzoek

De API is een openai-compatible API die de Chat Completions-structuur nabootst. Je stuurt tekst, ontvangt tekst. Geen extra endpoints voor embeddings of audio die je workflow verstoren. Begin door je client naar onze base URL te wijzen.

• Basis-URL: HTTPS://api.filtrosemia.com/v1
• Model-ID: "uncensored"

Vervang de basis-URL in je SDK-configuratie. Het eindpunt regelt alles, van roleplay tot vertaling, zonder de gebruikelijke filters.

Copycurl https://api.filtrosemia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "check balance"}]
  }'

Authenticatie en headers

Voer uw API-sleutel in de standaard Authorization-header. We gebruiken één actieve sleutel per account voor eenvoud. Als u een nieuwe nodig heeft, genereer deze dan via uw dashboard.

• Header: Authorization: Bearer YOUR_API_KEY
• Geen OAuth-flows of refresh tokens om te beheren.

Houd je sleutel veilig. Deze geeft directe toegang tot je voorgekochtegoeden. Fouten zoals 401 Unauthorized betekenen dat de sleutel ontbreekt of ongeldig is.

Copyfrom openai import OpenAI

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

Chat Completions Endpoint

Stuur berichten naar POST /v1/chat/completions. Het model ondersteunt standaardparameters zoals temperature, top_p, en stop sequenties. Het is een uncensored-model dat is afgestemd op volwassen en creatieve inhoud.

• Ondersteunt json_object response-indeling.
• Accepteert tool-definities voor functieaanroepen.

Verzoeken worden sequentieel verwerkt binnen uw rate limits. Zorg dat uw payload onder de 8 MB blijft.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.filtrosemia.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);

Streaming-responsen (SSE)

Gebruik Server-Sent Events voor realtime tokenlevering. Dit vermindert de waargenomen latentie voor lange uitvoer. Het laatste chunk bevat de volledige tokengebruiksstatistieken.

• Instellen stream: true in je request.
• Parseer de SSE-stream in uw client.

Streaming werkt identiek aan het standaard OpenAI SDK-gedrag. Je verwerkt de chunks wanneer ze binnenkomen.

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)

Contextvenster en limieten

Het model ondersteunt een contextvenster van 100.000 tokens. Dit stelt zware werklasten met lange geschiedenissen mogelijk. De maximale output is 16.000 tokens per verzoek.

• Standaard max output: 2.048 tokens.
• Rate limit: 300 requests per minute.

Het overschrijden van limieten activeert een 429 Too Many Requests fout. Pas je concurrency aan om binnen de grenzen te blijven. Er zijn 8 gelijktijdige verzoeken per sleutel toegestaan.

Fouthantering en Tokens

Verwerk standaard HTTP-fouten. 402 Payment Required betekent dat uw vooruitbetaalde krediet is opgebruikt. 429 wijst op snelheidsbeperking. 401 signaleert authenticatieproblemen.

• Fouten zijn gratis. Je betaalt alleen voor succesvol token-gebruik.
• Weigeringen vanwege het inhoudsbeleid zijn ook gratis.

Controleer de response body voor gedetailleerde foutberichten. Gebruik deze om je retry-logica of frequentie van credit-opwaarderingen aan te passen.