Guida all'Integrazione

Avvio rapido: La tua prima richiesta

L'API è un'API compatibile con openai che rispecchia la struttura delle Chat Completions. Invii testo, ricevi testo. Nessun endpoint extra per embeddings o audio che affollano il tuo flusso di lavoro. Inizia puntando il tuo client al nostro URL di base.

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

Sostituisci il tuo URL di base esistente nella configurazione del tuo SDK. L'endpoint gestisce tutto, dal roleplay alla traduzione, senza i soliti filtri.

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

Autenticazione e Intestazioni

Inserisci la tua chiave API nell'intestazione standard Authorization. Utilizziamo una singola chiave attiva per account per semplicità. Se ne hai bisogno di una nuova, generala dalla tua dashboard.

• Intestazione: Authorization: Bearer YOUR_API_KEY
• Nessun flusso OAuth o token di rinnovo da gestire.

Tieni la tua chiave al sicuro. Essa garantisce l'accesso diretto ai tuoi crediti prepagati. Errori come 401 Unauthorized significano che la chiave è mancante o non valida.

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 Chat Completions

Invia messaggi a POST /v1/chat/completions. Il modello supporta parametri standard come temperature, top_p, e stop sequenze. È un modello uncensored ottimizzato per contenuti adulti e creativi.

• Supporta json_object formato di risposta.
• Accetta definizioni di strumenti per il function calling.

Le richieste vengono elaborate in sequenza entro i tuoi limiti di frequenza. Assicurati che il tuo payload rimanga sotto gli 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);

Risposte in streaming (SSE)

Usa Server-Sent Events per la consegna dei token in tempo reale. Questo riduce la latenza percepita per gli output lunghi. L'ultimo chunk contiene le statistiche complete sull'utilizzo dei token.

• Imposta stream: true nella richiesta.
• Analizza il flusso SSE nel tuo client.

Lo streaming funziona in modo identico al comportamento standard dell'SDK OpenAI. Gestisci i chunk man mano che arrivano.

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)

Finestra di contesto e limiti

Il modello supporta una finestra di contesto di 100,000 token. Questo consente carichi di lavoro intensi con lunghe cronologie. L'output massimo è di 16,000 token per richiesta.

• Output massimo predefinito: 2.048 token.
• Limite di frequenza: 300 richieste al minuto.

Il superamento dei limiti innesca un 429 Too Many Requests errore. Regola la tua concorrenza per rimanere entro i limiti. Sono consentite 8 richieste concorrenti per chiave.

Gestione degli errori e token

Gestisci gli errori HTTP standard. 402 Payment Required significa che il tuo credito prepagato è esaurito. 429 indica il rate limiting. 401 segnalano problemi di autenticazione.

• Gli errori sono gratuiti. Paghi solo per l'utilizzo dei token con esito positivo.
• I rifiuti dovuti alla policy sui contenuti sono gratuiti.

Controlla il corpo della risposta per messaggi di errore dettagliati. Utilizzali per regolare la tua logica di retry o la frequenza di ricarica del credito.