Avvio Rapido API

URL Base e Autenticazione

Inizia puntando il tuo client al nostro URL base e passando la chiave nell'intestazione. Utilizziamo lo standard schema Authorization, quindi qualsiasi SDK OpenAI o client compatibile funziona immediatamente. Non è necessario gestire flussi OAuth complessi o attendere l'approvazione. Basta registrarsi con Google o email, copiare la chiave e si è pronti. L'endpoint è https://api.aiohnezensur.com/v1 e accetta il Authorization: Bearer YOUR_API_KEY header su ogni richiesta.

Invio della tua prima richiesta

Effettua una semplice chiamata di completamento chat per testare il modello uncensored. Questa richiesta invia un prompt e riceve una risposta testuale senza i soliti guardrail aziendali. Puoi usare qualsiasi strumento che supporti il protocollo OpenAI, ma una chiamata curl diretta mostra esattamente cosa succede sotto il cofano. Sostituisci YOUR_API_KEY con la tua chiave effettiva dal dashboard.

Copycurl https://api.aiohnezensur.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list 5 free open source image generators"}]
  }'

La risposta include il testo generato e le statistiche sull'utilizzo dei token. Se ricevi una risposta, la tua integrazione sta funzionando correttamente. Ora puoi procedere a costruire interazioni più complesse o passare a client programmatici.

Integrazione SDK Python

Usa il pacchetto Python ufficiale di OpenAI per interagire con la nostra API in modo trasparente. Imposta l'URL di base sul nostro endpoint e fornisci la tua chiave come token API. Questo ti permette di sfruttare i codebase esistenti senza riscrivere la logica HTTP. L'ID del modello è uncensored, che attiva il nostro specifico modello di linguaggio di grandi dimensioni ottimizzato per output senza restrizioni.

Copyfrom openai import OpenAI

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

Questo snippet dimostra uno scambio di messaggi di base. Puoi modificare l'array messages per includere prompt di sistema o la cronologia delle conversazioni. L'SDK gestisce per te la serializzazione e il parsing degli errori.

Integrazione SDK Node

Integra l'API nelle tue applicazioni JavaScript o TypeScript utilizzando l'SDK Node. Configura l'URL di base e la chiave API proprio come nell'esempio Python. Questo approccio funziona bene per il rendering lato server o per i microservizi backend. L'S astrae lo strato di rete, permettendoti di concentrarti sulla logica del prompt.

Copyimport OpenAI from "openai";

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

Esegui questo codice per vedere il modello rispondere al tuo input. Puoi iterare rapidamente modificando il contenuto del prompt. La struttura della risposta corrisponde allo standard OpenAI, garantendo la compatibilità con altri strumenti nel tuo stack.

Risposte in streaming

Abilita lo streaming per ricevere i token man mano che vengono generati, riducendo la latenza percepita. Questo è fondamentale per le interfacce utente che visualizzano il testo in tempo reale. Imposta il stream il parametro a true nella tua richiesta. L'API invia una serie di Server-Sent Events (SSE) invece di un singolo oggetto JSON. Ogni chunk contiene un delta parziale della risposta.

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)

Concatena questi delta lato client per ricostruire il messaggio completo. Questo metodo appare istantaneo per l'utente, anche per output lunghi. L'ultimo chunk contiene l'utilizzo totale dei token, permettendoti di fatturare con precisione.

Limiti di frequenza e vincoli

Comprendere i limiti tecnici per prevenire i fallimenti delle richieste in produzione. Hai diritto a 300 richieste al minuto per chiave e puoi avere 8 richieste concorrenti. Il corpo della richiesta non deve superare gli 8 MB. Se superi questi limiti, l'API restituisce un codice di stato 429. Dovresti implementare un backoff esponenziale nel tuo client per gestire questi picchi in modo elegante. La finestra di contesto è di 100.000 token in totale, con un output massimo di 16.000 token per richiesta. Errori e rifiuti non consumano credito, quindi puoi ritentare in sicurezza. Gli errori di autenticazione restituiscono 401 e la mancanza di fondi restituisce 402.