Integrationsguide

Hurtig start: Din første anmodning

API'en er en openai-kompatibel API, der spejler Chat Completions-strukturen. Du sender tekst, modtager tekst. Ingen ekstra endepunkter til embeddings eller lyd, der besværer dit workflow. Start med at pege din klient mod vores base URL.

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

Erstat din eksisterende base URL i din SDK-konfiguration. Endepunktet håndterer alt fra rollespil til oversættelse uden de sædvanlige filtre.

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"}]
  }'

Autentificering og headers

Indtast din API-nøgle i standard Authorization-headeren. Vi bruger én aktiv nøgle pr. konto for enkelhedens skyld. Hvis du har brug for en ny, kan du generere den fra dit dashboard.

• Header: Authorization: Bearer YOUR_API_KEY
• Ingen OAuth-flow eller refresh tokens, der skal administreres.

Hold din nøgle sikker. Den giver direkte adgang til din forudbetalte kredit. Fejl som 401 Unauthorized Betyder, at nøglen mangler eller er ugyldig.

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

Send beskeder til POST /v1/chat/completions. Modellen understøtter standardparametre som temperature, top_p, og stop sekvenser. Det er en ucensureret model, der er finjusteret til voksen- og kreativt indhold.

• Understøtter json_object response-format.
• Accepterer værktøgsdefinitioner til function calling.

Anmodninger behandles sekventielt inden for dit rate limit. Sørg for, at din payload er under 8 MB.

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-svar (SSE)

Brug Server-Sendte Begivenheder til real-time tokenlevering. Dette reducerer den opfattede forsinkelse for lange output. Den sidste chunk indeholder de fulde tokenforbrugsstatistikker.

• Indstil stream: true i din request.
• Parser SSE-strømmen i din klient.

Streaming fungerer identisk som standard OpenAI SDK-adfærd. Du håndterer chunks, mens de ankommer.

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)

Kontekstvindue og Grænser

Modellen understøtter et kontekstvindue på 100.000 tokens. Dette muliggør tunge arbejdsbelastninger med lange historikker. Max output er 16.000 tokens pr. anmodning.

• Standard max output: 2.048 tokens.
• Rate limit: 300 anmodninger i minuttet.

Overskridelse af grænserne udløser en 429 Too Many Requests fejl. Juster din konkurrenceevne for at holde dig inden for grænserne. 8 samtidige forespørgsler pr. nøgle er tilladt.

Fejlhåndtering og tokens

Håndter standard HTTP-fejl. 402 Payment Required Betyder, at din forudbetalte kredit er opbrugt. 429 indikerer ratebegrænsning. 401 signalerer autentificeringsproblemer.

• Fejl er gratis. Du betaler kun for succesfuld token-brug.
• Afvisninger på grund af indholdspolitik er også gratis.

Tjek response body for detaljerede fejlmeddelelser. Brug disse til at justere din retry-logik eller hyppigheden af kreditopfyldning.