Autenticazione e Chiavi API
Inizia creando un account per ottenere immediatamente la tua chiave API. Puoi registrarti con Google o con una combinazione di email e password senza bisogno di un numero di telefono. Il sistema genera una chiave attiva per account e la creazione di una nuova chiave sostituisce istantaneamente quella vecchia. Ti serve solo un indirizzo email per iniziare e i tuoi prompt non vengono utilizzati per l'addestramento. Utilizza questa chiave nel Authorization header come token bearer per tutte le richieste.
Prima richiesta
Esegui la tua prima chiamata all'endpoint di completamento chat utilizzando la tua chiave API. L'URL base è https://api.aidphn.com/v1 e funziona con i client standard compatibili con OpenAI. Devi specificare il modello uncensored al modello linguistico di grandi dimensioni senza filtri. Errori e rifiuti non consumano i tuoi crediti prepagati, quindi puoi testare in sicurezza.
curl https://api.aidphn.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List the top 5 Rust crates for async HTTP clients"}]
}'
Verifica che la tua chiave funzioni controllando l'endpoint dell'elenco dei modelli. Questo conferma la connettività prima di inviare prompt complessi. L'API accetta testo in input e restituisce testo in output, supportando parametri standard come temperature e top_p.
Integrazione SDK Python
Utilizza la libreria Python ufficiale di OpenAI per interagire con il nostro endpoint. Imposta l'URL di base sul nostro server API e fornisci la tua chiave. Questo approccio ti permette di riutilizzare il codice esistente dai progetti OpenAI senza modifiche importanti. L'ID del modello rimane uncensored per tutte le completazioni.
from openai import OpenAI
client = OpenAI(base_url="https://api.aidphn.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)
Puoi configurare parametri come max_tokens per controllare la lunghezza dell'output. Il massimo output predefinito è 2.048 token, ma puoi aumentarlo fino a 16.000 per richiesta. Lo streaming è disponibile per le risposte lunghe per ridurre la latenza.
Utilizzo SDK Node
Integra l'API nelle tue applicazioni Node.js utilizzando l'SDK standard. Indirizza il client al nostro URL base e autentica con la tua chiave. Questo metodo supporta sia richieste sincrone che asincrone per un'integrazione flessibile. Puoi passare strumenti per il function calling o imporre modalità di output JSON.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.aidphn.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);
Gestisci le risposte analizzando il campo content dall'oggetto completion. L'API supporta parametri standard come stop sequenze e seed per la riproducibilità. La gestione degli errori dovrebbe tenere conto dei limiti di frequenza e della disponibilità di credito.
Risposte in streaming tramite SSE
Abilita lo streaming impostando stream: true nella tua richiesta. L'API restituisce Server-Sent Events (SSE) per la consegna dei token in tempo reale. Ogni chunk contiene contenuto parziale, consentendoti di visualizzare l'output man mano che viene generato. L'ultimo chunk include l'utilizzo totale dei token per la trasparenza della fatturazione.
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)
Lo streaming riduce la latenza percepita per gli utenti che attendono risposte lunghe. Puoi elaborare i token in modo incrementale o memorizzarli per un uso successivo. La finestra di contesto supporta fino a 100,000 token per prompt e completamento combinati.
Limiti ed Errori
Monitora il tuo utilizzo rispetto a rigorosi limiti di velocità e saldi dei crediti. Puoi inviare 300 richieste al minuto e avere 8 richieste concorrenti per chiave. La dimensione massima del corpo della richiesta è di 8 MB. Errori come 401 indicano una chiave non valida, mentre 402 significa che devi ricaricare. 429 segnali che hai superato il limite di velocità. Ricarica solo con criptovalute, a partire da $20, per continuare a utilizzare il servizio senza interruzioni.