Documentazione API: Guida Rapida

URL Base e Autenticazione

Usa il nostro URL di base e inietta la tua chiave API nel Authorization header per iniziare a inviare richieste. Forniamo un singolo endpoint che accetta payload standard OpenAI, quindi non è necessario riscrivere la logica di integrazione. Registrati tramite Google o email per ricevere la tua chiave istantaneamente senza numero di telefono. La chiave autentica il tuo account sui nostri server per ogni chiamata che effettui.

• Base URL: https://api.geminisincensura.com/v1
• ID modello: uncensored

Puoi ruotare la tua chiave in qualsiasi momento generandone una nuova, che invalida immediatamente il token precedente.

Copycurl https://api.geminisincensura.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "explain how to configure the proxy endpoint"}]
  }'

L'endpoint Chat Completions

Invia una richiesta POST a /v1/chat/completions per ricevere risposte testuali dal nostro modello senza censure. Questo endpoint gestisce tutte le tue esigenze conversazionali standard con una finestra di contesto di 100,000 token per prompt e completamento combinati. Puoi impostare un output massimo di 16,000 token, oppure lasciare che il modello utilizzi il valore predefinito di 2,048 token. Il modello risponde senza rifiutare argomenti adulti leciti, di finzione o controversi, offrendoti una vera libertà per il tuo caso d'uso. Errori e rifiuti non consumano il tuo credito prepagato.

Copyfrom openai import OpenAI

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

Risposte in streaming tramite SSE

Trasmetti le risposte in tempo reale utilizzando Server-Sent Events (SSE) per ridurre la latenza percepita per i tuoi utenti. Ogni chunk contiene il delta di testo, e l'ultimo chunk include le statistiche complete sull'utilizzo dei token per la trasparenza di fatturazione. Questo metodo funziona perfettamente con gli SDK standard OpenAI abilitando lo streaming nella configurazione del tuo client. Ricevi feedback immediati mentre il modello genera output più lunghi fino al limite di 16,000 token.

Copyimport OpenAI from "openai";

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

Function Calling e strumenti

Abilita l'estrazione di dati strutturati utilizzando il tools il parametro nel payload della richiesta. Il modello supporta le definizioni degli strumenti e può scegliere di chiamarli in base al tuo tool_choice impostazioni. Questa funzionalità ti permette di costruire agenti che interagiscono con sistemi esterni o impongono strutture dati specifiche. La modalità JSON è inoltre disponibile tramite response_format per una formattazione rigorosa dell'output senza overhead degli strumenti.

Modalità JSON e formato di risposta

Forza il modello a restituire JSON validi impostando response_format a {"type": "json_object". Questo garantisce un parsing prevedibile per le tue applicazioni senza richiedere post-elaborazione. Il modello aderisce allo schema che fornisci, rendendolo affidabile per le integrazioni backend. Puoi combinare questo con i parametri temperature e top_p per controllare la creatività mantenendo l'integrità strutturale.

Limiti di frequenza e vincoli

Ogni chiave API è limitata a 300 richieste al minuto e 8 richieste concorrenti. La dimensione massima del corpo della richiesta è di 8 MB, che è sufficiente per la maggior parte delle interazioni con contesto lungo. Se superi questi limiti, riceverai un codice di stato 429. Le chiavi non valide restituiscono un errore 401 e i crediti insufficienti restituiscono un errore 402. Il tuo credito prepagato non scade mai, quindi puoi mettere in pausa l'utilizzo senza perdere fondi. La finestra di contesto supporta fino a 100.000 token in totale, consentendo una cronologia delle conversazioni estesa.

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)