- Modelli AI sbloccati
- Documentazione API
Documentazione API
Questa documentazione copre l'interfaccia core chat-completions per il nostro modello uncensored. Usa gli endpoint forniti per inviare testo e ricevere risposte senza restrizioni immediatamente.
Autenticazione e Base URL
Invia le tue richieste al nostro URL base con una chiave API valida nell'intestazione.
- Base URL:
https://api.unlockedaimodels.com/v1 - Intestazione:
Authorization: Bearer YOUR_API_KEY
L'identificatore del modello è semplicemente uncensored. Ottieni una chiave attiva per account, che sostituisce qualsiasi chiave precedente alla generazione.
curl https://api.unlockedaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Generate the standard HTTP headers for a POST request."}]
}'
Endpoint Chat Completions
Il POST /v1/chat/completions endpoint elabora il tuo testo e restituisce un completamento.
Questo è l'unico endpoint testuale che forniamo. Non offriamo generazione di immagini, audio o embedding. Il modello accetta un array standard di messaggi contenente le tue turnazioni di sistema, utente e assistente.
Errori come 401 indicano una chiave non valida, mentre 402 significa che hai bisogno di più credito. Le richieste vengono addebitate solo quando vengono generati i token.
Risposte in streaming (SSE)
Abilita lo streaming impostando stream: true nel corpo della richiesta.
Ogni chunk contiene testo parziale, permettendoti di visualizzare l'output in tempo reale. L'ultimo chunk include le statistiche complete sull'utilizzo dei token per la trasparenza nella fatturazione.
Questo metodo riduce la latenza percepita per le risposte lunghe, aspetto cruciale quando si generano oltre 16,000 token.
from openai import OpenAI
client = OpenAI(base_url="https://api.unlockedaimodels.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)
Function Calling e strumenti
Definisci gli strumenti nella richiesta per abilitare il richiamo di funzioni strutturato.
Il modello supporta tool_choice parametri, permettendoti di forzare comportamenti specifici o lasciare che il modello decida. Questo è utile per costruire agenti che devono interagire con sistemi esterni senza interrompere il contesto uncensored.
Assicurati che le tue definizioni degli strumenti seguano lo schema OpenAI per la compatibilità.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.unlockedaimodels.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);
Modalità JSON e output strutturati
Forza il modello a restituire JSON validi impostando response_format: {"type": "json_object"}.
Questo garantisce un parsing prevedibile per le tue applicazioni. Utilizza questa modalità quando estrai dati o generi file di configurazione.
Combinato con il function calling, crea una pipeline robusta per attività automatizzate senza livelli di convalida esterni.
stream = 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)
Parametri: Temperatura, Top-P e Stop
Controlla la creatività con temperature e diversità con top_p.
Usa stop sequenze per interrompere la generazione a marcatori specifici. La finestra di contesto è di 100.000 token in totale, con un output massimo di 16.000 token a meno che tu non specifichi un max_tokens valore (il valore predefinito è 2,048).
I limiti di frequenza sono di 300 richieste al minuto e 8 richieste concorrenti per chiave.
FAQ
Come iniziare con il modello senza filtri?
Iscriviti con Google o email per ricevere una prova gratuita di $0.50. Aggiungi credito crittografato per continuare a usare l'API dopo la scadenza della prova. Usa l'URL di base fornito e la tua chiave API per inviare la tua prima richiesta.
Cosa succede se vengo limitato dalla frequenza?
Riceverai un errore 429. Il limite è di 300 richieste al minuto e 8 richieste concorrenti per chiave. Attendi un momento e riprova, oppure riduci il numero di richieste parallele.
Il modello uncensored è gratuito?
No, ma ricevi un credito di prova di $0.50. Successivamente, paghi a consumo. I token di input costano $0.15 per milione, mentre quelli di output costano $0.50 per milione. Errori e rifiuti sono gratuiti.
Ottieni la tua chiave API ora
Registrati, copia la chiave e aggiorna il tuo URL di base. È tutto ciò di cui hai bisogno.