Avvio rapido: Integra la chat di apertus ai

Prerequisiti e configurazione

Inizia creando un account e ottenendo la tua chiave API. Iscriviti utilizzando Google o una password email nella pagina di generazione della chiave. Il sistema visualizza la tua chiave immediatamente, così puoi copiarla senza indugio. Non è richiesto il numero di telefono per la registrazione. Ricevi $0.50 di credito di prova valido per 7 giorni, così puoi testare la connettività senza aggiungere fondi.

Configura la tua variabile di ambiente o il client SDK per puntare all'URL base corretto. Questo URL funziona con le librerie standard OpenAI. Modifica solo l'URL base e la tua chiave. L'ID del modello è "uncensored". Questo singolo endpoint gestisce tutte le completamenti di testo. Non hai bisogno di gestire il routing o selezionare modelli diversi.

Assicurati che la libreria client supporti il protocollo OpenAI Chat Completions. La maggior parte delle SDK moderne funziona subito. Verifica che la tua rete consenta le richieste HTTPS in uscita. Il servizio accetta payload JSON standard. Non sono necessarie intestazioni speciali oltre all'autenticazione.

Autenticazione con chiavi API

Inserisci la tuo chiave API nell'intestazione Authorization per ogni richiesta. Utilizza il metodo Bearer seguito dalla tua stringa di chiave. Il servizio convalida la chiave rispetto al tuo account. Le chiavi non valide restituiscono un errore 401 Unauthorized. La scadenza o il saldo insufficiente attivano una risposta 402 Payment Required. Verifica il tuo saldo nella dashboard se le richieste falliscono.

Tieni la tua chiave al sicuro. Ogni account mantiene una chiave attiva. Generando una nuova chiave, quella precedente viene invalidata. Non condividere la tua chiave nei repository pubblici. La chiave API è l'unico identificatore per il tuo utilizzo. I limiti di frequenza si applicano per chiave, non per account.

Copycurl https://api.apertusaichat.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set role to assistant"}]
  }'

L'autenticazione è stateless. Il server verifica il token a ogni chiamata. Se ruoti la tua chiave, aggiorna immediatamente tutti i client in esecuzione. La mancanza dell'intestazione comporta un rifiuto immediato. Il messaggio di errore indica chiaramente il fallimento dell'autenticazione.

Invio della tua prima richiesta

Invia una richiesta POST all'endpoint di completamento della chat. Includi l'ID del modello "uncensored" e la cronologia dei messaggi. L'API restituisce una risposta testuale. Puoi trasmettere in streaming l'output o attendere il completamento completo. Ogni richiesta consuma token di input e output. Gli errori non addebitano crediti. I rifiuti sono gratuiti.

Copyfrom openai import OpenAI

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

La risposta include le statistiche di utilizzo. Monitora il consumo di token per gestire il credito prepagato. Il modello risponde senza rifiuti di contenuto per l'uso adulto legale. Puoi inviare prompt di sistema per definire il comportamento. I messaggi dell'utente guidano la conversazione. La finestra di contesto supporta 100,000 token in totale.

Inizia con un semplice scambio a due messaggi. Questo verifica la connettività e la qualità della risposta. Regola temperatura e top_p per output creativi o precisi. L'API supporta parametri standard. Le sequenze di stop funzionano come previsto. I valori di seed garantiscono risultati riproducibili.

Risposte in streaming tramite SSE

Abilita lo streaming impostando il parametro stream su true. L'API restituisce Server-Sent Events (SSE) invece di un singolo oggetto JSON. Ogni chunk contiene una porzione del testo generato. Leggi i chunk fino alla fine dello stream. L'ultimo chunk include l'utilizzo totale 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. Gli utenti vedono il testo apparire in tempo reale. Questo è ideale per le interfacce chat. Gestisci i token parziali con cura. Concatena i chunk per formare la risposta completa. Il server chiude la connessione quando la generazione termina.

Monitorare gli errori di stream. Le interruzioni di rete possono interrompere lo stream. Implementare la logica di riconnessione se necessario. L'API non reinvia la cronologia. Avviare una nuova richiesta se lo stream fallisce. I conteggi dei token nell'ultimo chunk riflettono l'intera generazione.

Gestione dei parametri e delle modalità

Utilizza parametri standard per controllare la generazione. Imposta la temperatura per la casualità. Regola il top_p per il campionamento del nucleo. Definisci sequenze di stop per interrompere la generazione anticipatamente. Passa un seed per output deterministici. Abilita la modalità JSON impostando response_format su json_object. Il modello restituisce JSON valido quando richiesto.

Il function calling è supportato. Definisci gli strumenti nella richiesta. Il modello restituisce chiamate di strumento quando appropriato. Analizza gli argomenti degli strumenti nel tuo codice. Passa i risultati indietro per continuare la conversazione. Questo abilita flussi di lavoro di agenti complessi.

Copyimport OpenAI from "openai";

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

I token max limitano la lunghezza dell'output. Il valore predefinito è 2.048 token. Imposta un valore più alto se necessario. Il limite rigido per richiesta è di 16.000 token. La finestra di contesto è di 100.000 token. Pianifica di conseguenza la lunghezza della cronologia. Le penalità di frequenza e presenza aiutano a ridurre la ripetizione.

Comprendere limiti ed errori

I limiti di frequenza proteggono la stabilità del servizio. Puoi inviare 300 richieste al minuto. La concorrenza è limitata a otto richieste simultanee per chiave. I corpi delle richieste non devono superare 8 MB. Il superamento dei limiti restituisce un errore 429 Too Many Errors. Attendi prima di riprovare.

Verifica i codici di errore per il diagnostico. 401 indica una chiave non valida o mancante. 402 segnala credito prepagato insufficiente. Ricarica in criptovaluta per riprendere il servizio. 429 indica un limite di frequenza raggiunto. 400 denota una sintassi di richiesta errata. Rivedi il messaggio di errore per i dettagli.

La gestione della finestra di contesto è fondamentale. Somma i token di prompt e di completamento. Rimani ben al di sotto dei 100.000 token. Tronca i messaggi vecchi se necessario. L'API non tronca automaticamente. Controlli tu la lunghezza della cronologia. Un uso efficiente del contesto riduce i costi.