Documentazione API

URL Base e autenticazione

Connetti la tua applicazione puntando al nostro endpoint dedicato e passando la tua chiave API univoca. L'URL base per tutte le richieste è https://api.apertusapp.com/v1. Ottieni la tua chiave immediatamente dopo la registrazione tramite Google o email sul Ottieni la chiave API pagina. Inserisci questa chiave nel Authorization header per ogni richiesta.

Copycurl https://api.apertusapp.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run curl test with empty headers"}]
  }'

Ogni account genera una chiave attiva. Se generi una nuova chiave, quella precedente diventa invalida istantaneamente. Questo garantisce un controllo rigoroso del tuo accesso senza piani di abbonamento o costi inattivi.

Prima richiesta

Invia il tuo primo prompt all'endpoint per le chat completions per ricevere testo grezzo e non filtrato. Usa l'ID del modello uncensored al nostro specifico modello open-weight ottimizzato per uso adulto legale e argomenti controversi.

Copyfrom openai import OpenAI

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

L'API accetta parametri standard come temperature e top_p. Errori e rifiuti non consumano token, quindi paghi solo per ciò che raggiunge effettivamente il modello. Questo approccio mantiene i costi prevedibili rispetto agli aggregatori che addebitano per il sovraccarico di instradamento.

Integrazione SDK Node

Utilizza l'SDK Node ufficiale per gestire la modalità JSON e il function calling in modo efficiente. Imposta response_format a {"type": "json_object"} per output strutturati o definire strumenti per un comportamento simile agli agent.

Copyimport OpenAI from "openai";

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

Il modello supporta le chiamate agli strumenti con tool_choice opzioni. Puoi anche impostare un seed per risultati deterministici. Questa flessibilità ti permette di costruire applicazioni complesse senza uscire dall'ecosistema compatibile con OpenAI.

Risposte in streaming

Esegui lo streaming dei token in tempo reale utilizzando Server-Sent Events (SSE) per esperienze utente a bassa latenza. Ogni chunk contiene il testo generato e l'ultimo chunk include le statistiche totali sull'utilizzo dei token.

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)

Lo streaming riduce la latenza percepita per gli utenti finali. Puoi interrompere lo stream se l'utente cambia idea. L'API gestisce automaticamente il protocollo SSE, richiedendo codice minimo da parte tua.

Finestra di contesto e capacità

Il modello supporta una finestra di contesto di 100.000 token per input e output combinati. Puoi specificare fino a 16.000 token per richiesta, oppure ricorrere a 2.048 token se ometti max_tokens.

Questa finestra ampia consente un'analisi estesa dei documenti o la conservazione di lunghe cronologie di conversazioni. Tuttavia, mantieni i corpi delle richieste sotto gli 8 MB. Il modello non è GPT o Llama; è un modello distinto di IA senza filtri ottimizzato per il tuo caso d'uso specifico.

Gestione degli errori e limiti

Gestisci gli errori HTTP standard con grazia per mantenere un flusso dell'applicazione robusto. Un 401 errore indica una chiave API non valida o mancante. Un 402 errore significa che il tuo credito prepagato è esaurito. Un 429 errore segnala che hai superato 300 richieste al minuto o 8 richieste concorrenti.

Il credito non scade mai, quindi puoi interrompere l'utilizzo e riprenderlo in seguito. Errori come le addebiti doppi vengono risolti tramite la pagina Supporto. Il credito prepagato viene addebitato solo per il consumo effettivo di token, garantendo una trasparenza sui prezzi per ogni byte.