Ghid de integrare

Quickstart: Prima solicitare

API este un API compatibil cu openai care imită structura Chat Completions. Trimite text, primești text. Fără endpoint-uri suplimentare pentru embeddings sau audio care-ți încarcă fluxul de lucru. Începe prin a direcționa clientul tău către URL-ul nostru de bază.

• URL de bază: HTTPS://api.filtrosemia.com/v1
• ID Model: "uncensored"

Înlocuiți-vă URL-ul de bază existent în configurația SDK-ului. Endpoint-ul se ocupă de totul, de la roleplay la traducere, fără filtrele obișnuite.

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

Autentificare și Anteturi

Transmiteți cheia API în antetul standard Authorization. Utilizăm o singură cheie activă per cont pentru simplitate. Dacă aveți nevoie de una nouă, generați-o din panoul dumneavoastră de control.

• Header: Authorization: Bearer YOUR_API_KEY
• Nu trebuie gestionate fluxuri OAuth sau token-uri de reîmprospătare.

Mențineți cheia în siguranță. Aceasta oferă acces direct la creditele preplătite. Erorile de genul 401 Unauthorized înseamnă că cheia lipsește sau este invalidă.

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)

Endpoint Completări Chat

Trimite mesaje către POST /v1/chat/completions. Modelul suportă parametri standard precum temperature, top_p, și stop secvențe. Este un model uncensored ajustat pentru conținut adult și creativ.

• Suportă json_object formatul de răspuns.
• Acceptă definiții de funcții pentru apeluri de funcții.

Cererea sunt procesate secvențial în limitele dumneavoastră de rată. Asigurați-vă că payload-ul rămâne sub 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);

Răspunsuri în streaming (SSE)

Folosiți Server-Sent Events pentru livrarea tokenilor în timp real. Acest lucru reduce latența percepută pentru ieșirile lungi. Ultimul chunk conține statisticile complete de utilizare a tokenilor.

• Setează stream: true în solicitarea dvs.
• Analizați fluxul SSE în clientul dvs.

Streaming-ul funcționează identic cu comportamentul standard al SDK-ului OpenAI. Gestionezi fragmentele pe măsură ce sosesc.

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)

Fereastră de Context și Limite

Modelul acceptă o fereastră de context de 100.000 de tokeni. Acest lucru permite sarcini grele cu istorice lungi. Output-ul maxim este de 16.000 de tokeni per solicitare.

• Output maxim implicit: 2.048 tokenuri.
• Limită de rată: 300 de cereri pe minut.

Depășirea limitelor declanșează o 429 Too Many Requests eroare. Ajustați concurența pentru a rămâne în limite. Sunt permise 8 cereri concurente per cheie.

Gestionarea erorilor și tokenii

Gestionați erorile standard HTTP. 402 Payment Required înseamnă că creditul tău preplătit este epuizat. 429 indică limitarea ratei. 401 semnalizează probleme de autentificare.

• Erorile sunt gratuite. Plătiți doar pentru utilizarea cu succes a tokenilor.
• Refuzurile din cauza politicii de conținut sunt, de asemenea, gratuite.

Verificați corpul răspunsului pentru mesaje de eroare detaliate. Utilizați-le pentru a ajusta logica de reîncercare sau frecvența reîncărcării creditului.