Documentazione API: Guida Rapida

URL Base e Autenticazione

L'API Heretic AI è completamente compatibile con OpenAI. Interagisci con essa puntando il tuo client al nostro URL di base: https://api.hereticai.cc/v1. L'autenticazione si basa su una singola chiave API per account, generata istantaneamente al momento della registrazione tramite Google o email. Passa questa chiave nell' Authorization header come token Bearer. L'identificatore del modello è semplicemente uncensored. Questo modello singolo gestisce tutte le tue richieste senza complessità di routing. Errori come 401 indicano una chiave non valida, mentre 402 significa che hai bisogno di più credito crittografico prepagato.

Copycurl https://api.hereticai.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "generate twenty test cases"}]
  }'

Endpoint Chat Completions

Invia richieste di testo utilizzando il POST /v1/chat/completions endpoint. endpoint. L'API si aspetta un array standard di messaggi contenente la cronologia della conversazione o il prompt. Restituisce il testo generato nel choices array. Questa è un'API puramente utilitaristica: testo in, testo out. Paghi solo per i token consumati. Il credito prepagato non scade mai, e i rifiuti o gli errori non costano token. Questo approccio elimina i blocchi di abbonamento e i livelli gratuiti imprevedibili.

Copyfrom openai import OpenAI

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

Risposte in streaming (SSE)

Abilita lo streaming dei token in tempo reale impostando stream: true nella tua richiesta. L'API restituisce Server-Sent Events (SSE) per ogni token generato. Questo ti consente di visualizzare l'output in modo progressivo, cruciale per le applicazioni sensibili alla latenza. Le statistiche di utilizzo dei token appaiono nell'ultimo chunk dello stream. Questa funzionalità funziona in modo trasparente con gli SDK standard di OpenAI che gestiscono automaticamente gli SSE. Fornisce feedback immediato senza attendere il completamento completo.

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)

Function Calling e strumenti

L'API supporta la chiamata di funzioni con il tools e tool_choice parametri. Definisci gli schemi dei tuoi strumenti nella richiesta, e il modello restituirà chiamate di funzione strutturate quando appropriato. Questo abilita flussi di lavoro complessi in cui il LLM decide quale azione intraprendere dopo. Puoi forzare l'uso di strumenti specifici o lasciare che il modello scelga liberamente. Questa capacità è essenziale per costruire applicazioni agentiche che interagiscono con sistemi esterni o database.

Modalità JSON

Assicura output deterministici impostando response_format a {"type": "json_object"}. Il modello vincolerà la sua risposta a JSON valido, che è vitale per l'analisi programmatica. Questo riduce la necessità di correzioni regex post-elaborazione. Garantisce che l'output possa essere consumato direttamente dal tuo codice. Questo è particolarmente utile per l'estrazione di dati strutturati o la generazione di configurazioni.

Parametri e limiti

Controlla la generazione con parametri standard come temperature, top_p, e seed. La finestra di contesto è di 100,000 token per prompt più completamento. L'output massimo è di 16,000 token per richiesta, o 2,048 se max_tokens è non impostato. I limiti di frequenza sono di 300 richieste al minuto e 8 richieste concorrenti per chiave. Il corpo della richiesta deve rimanere sotto 8 MB. Questi limiti garantiscono un utilizzo stabile ad alto volume per gli sviluppatori.

Node.js

Copyimport OpenAI from "openai";

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