Avvio Rapido API e Integrazione

URL Base e Autenticazione

Il progetto Heretic fornisce un singolo endpoint ospitato per la generazione di testo. Usa https://api.hereticproject.com/v1 come tuo URL di base. L'autenticazione si basa su un token bearer passato tramite Authorization header. Crea la tua chiave accedendo con Google o email sul dashboard. Il sistema emette una chiave attiva per account; generare una nuova chiave invalida immediatamente quella precedente.

Paghi solo per i token consumati. Errori e rifiuti non addebitano il tuo credito prepagato. Un nuovo account riceve $0,50 di credito di prova valido per sette giorni. Ricarichi utilizzando USDT (TRC20) o USDC (Base) in importi tra $20 e $500.

L'endpoint /v1/chat/completions

Invia messaggi all'endpoint standard di completamento chat. L'ID del modello è uncensored. Accetta un elenco di oggetti messaggio con ruoli come system, user, o assistant. Il modello non rifiuta argomenti adulti, di fantasia o controversi leciti. È un modello open-weight ottimizzato per risposte dirette.

Le richieste restituiscono un oggetto JSON contenente il testo generato. La finestra di contesto supporta 100,000 token combinati per prompt e completamento. L'output è limitato a 16,000 token per richiesta a meno che tu non specifichi un limite inferiore max_tokens valore.

Copycurl https://api.hereticproject.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list dependencies for node project"}]
  }'

Integrazione SDK Python

Utilizza la libreria Python ufficiale di OpenAI con un URL di base personalizzato. Imposta api_key alla tua stringa API. Configura base_url per puntare al server del Progetto Heretic. Questo ti permette di utilizzare metodi familiari come chat.completions.create() senza modificare significativamente la struttura del codice esistente.

Installa la libreria tramite pip. Passa le tue credenziali direttamente all'inizializzazione del client. La libreria gestisce automaticamente la serializzazione. Questo approccio funziona sia per flussi di lavoro sincroni che asincroni. Assicurati di gestire con cura gli eventuali errori di rete.

Copyfrom openai import OpenAI

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

Integrazione SDK Node

L'SDK Node.js funziona identicamente alla versione Python. Inizializza il client con la tua chiave API e l'URL di base corretto. Puoi inviare richieste di completamento utilizzando le stesse firme dei metodi. Questo garantisce coerenza tra le diverse parti del tuo stack.

Gestisci le risposte in modo asincrono. L'SDK trasmette i dati se utilizzi il metodo di streaming. In caso contrario, restituisce la risposta JSON completa. Questa flessibilità supporta sia l'elaborazione batch che le interfacce in tempo reale. Mantieni la tua chiave API sicura nelle variabili d'ambiente.

Copyimport OpenAI from "openai";

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

Risposte in streaming (SSE)

Abilita lo streaming impostando stream: true nella tua richiesta. Il server invia Server-Sent Events (SSE). Ogni chunk contiene aggiornamenti di testo parziali. Questo riduce la latenza percepita per gli utenti finali. I dati sull'utilizzo dei token appaiono nell'ultimo chunk dello stream.

Elabora ogni oggetto delta per accumulare la risposta completa. Interrompi l'ascolto quando lo stream si chiude o si verifica un errore. Questo metodo è ideale per le interfacce chat. Permette agli utenti di vedere i pensieri formarsi in tempo reale. Il sovraccarico è minimo rispetto alle risposte complete.

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)

Limiti, Errori e Contesto

Rispetta i limiti di frequenza per evitare interruzioni del servizio. Hai diritto a 300 richieste al minuto per chiave. La concorrenza è limitata a 8 richieste simultanee. Il corpo della richiesta non può superare gli 8 MB. Il superamento di questi limiti restituisce un codice di stato 429. Attendi brevemente prima di riprovare.

I fallimenti di autenticazione restituiscono un errore 401. Questo accade se la chiave non è valida o è scaduta. Un errore 402 indica credito prepagato insufficiente. Gli errori di rimborso vengono gestiti tramite la pagina Supporto. Il credito non scade mai. Il modello rifiuta i contenuti che coinvolgono minori. Tutti gli altri contenuti legali sono accettati.