Documentazione API Ablated ai

Autenticazione: Utilizzo della tua chiave API

La tua chiave API autentica ogni richiesta che invii ai nostri server. Emettiamo una singola chiave per account che puoi generare tramite la dashboard. Trasmetti questa chiave nell' Authorization header utilizzando lo schema Bearer. Se invii una chiave non valida, restituiamo un errore 401. Se il tuo credito prepagato si esaurisce, restituiamo un errore 402 che richiede un ricarico tramite criptovaluta prima di continuare.

Struttura URL Base e Endpoint

Indirizza tutte le richieste al nostro unico base URL per le chat completions. Non offriamo endpoint per embeddings, generazione di immagini o fine-tuning. Usa lo standard POST /v1/chat/completions path per inviare i tuoi prompt. Puoi anche interrogare GET /v1/models a verificare l'identificatore del modello disponibile. Questa struttura garantisce la compatibilità con i client SDK OpenAI esistenti senza logica di routing personalizzata.

Avvio rapido: La tua prima richiesta con ablated AI

Invia una semplice richiesta testuale per testare immediatamente il modello uncensored. Usa la libreria ufficiale OpenAI o qualsiasi client HTTP per POSTARE il tuo messaggio. Il modello restituisce una risposta testuale senza filtrare i contenuti adulti legali. Sostituisci il segnaposto con le tue credenziali effettive dal dashboard.

Copycurl https://api.aiablated.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the current version of the api"}]
  }'

Questa richiesta dimostra il flusso di interazione di base. Ricevi una risposta diretta dal modello ablated. Modifica il prompt di sistema per definire la persona o il contesto per il tuo caso d'uso specifico.

Integrazione SDK Python

Utilizza la libreria Python ufficiale di OpenAI per integrare l'API nelle tue applicazioni. Imposta l'URL di base e la chiave API nella configurazione del client. Questo approccio gestisce automaticamente la serializzazione e l'analisi degli errori. Puoi trasmettere le risposte o recuperarle in modo sincrono. La libreria client gestisce per te il ciclo di vita della connessione.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.aiablated.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 di codice inizializza correttamente il client. Punta al nostro URL di base specifico. Assicurati di installare l'ultimo pacchetto openai per una piena compatibilità con le funzionalità di streaming e function calling.

Integrazione SDK Node.js

Integra l'API nei tuoi progetti JavaScript o TypeScript utilizzando l'SDK standard. Configura l'URL di base per puntare al nostro servizio. Questo ti permette di utilizzare metodi familiari come chat.completions.create. L'SDK gestisce le intestazioni della richiesta e l'analisi della risposta. Puoi aggiungere facilmente la gestione degli errori per i limiti di frequenza o i fallimenti di autenticazione.

Copyimport OpenAI from "openai";

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

Questa configurazione garantisce che la tua applicazione Node comunichi correttamente. L'override dell'URL di base è il passaggio critico. Senza di esso, l'SDK tenterà di raggiungere il cloud di OpenAI invece dei nostri server.

Risposte in streaming e utilizzo dei token

Ricevi risposte token per token utilizzando Server-Sent Events (SSE). Questo riduce la latenza percepita per gli output lunghi. L'ultimo chunk dello streaming contiene l'utilizzo totale dei token per la richiesta. Puoi monitorare il consumo del tuo credito prepagato in tempo reale. Imposta stream: true nel payload della richiesta per abilitare questa modalità. Questo è ideale per le interfacce chat e la generazione di testo in diretta.

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)

Questo approccio di streaming garantisce un'esperienza utente fluida. L'ultimo chunk include le statistiche di utilizzo. Monitora questi valori per gestire efficacemente il credito prepagato. Gli errori durante lo streaming vengono gestiti in modo elegante dall'SDK.