Avvio rapido: API Chat Completions

Prerequisiti e URL di base

La nostra API è completamente compatibile con l'interfaccia standard di chat completions di OpenAI. Hai bisogno solo di un URL di base e di una chiave API per iniziare a inviare richieste. L'URL di base è HTTPS://api.howmuchisanapikey.com/v1. Questo singolo endpoint gestisce tutta la generazione di testo senza richiedere la gestione di più URL di servizio o configurazioni proxy.

L'autenticazione è semplice. Devi includere un'intestazione Authorization con lo schema Bearer seguita dalla tua chiave univoca. Ogni richiesta all'endpoint di completamento della chat richiede questa intestazione per convalidare il tuo account e tracciare l'utilizzo dei token rispetto al tuo saldo di credito prepagato.

Autenticazione e intestazioni

Includi l'intestazione Authorization in ogni richiesta per verificare la tua identità. Il formato dell'intestazione è Authorization: Bearer YOUR_API_KEY. Se la chiave non è valida o è scaduta, l'API restituisce immediatamente un errore 401. Questo garantisce che solo gli account autorizzati possano consumare il tuo credito prepagato.

Non hai bisogno di passare intestazioni aggiuntive per la generazione di testo di base. Tuttavia, se utilizi funzionalità specifiche come la modalità JSON o il function calling, devi impostare l'intestazione Content-Type su application/json. Questo dice al server come analizzare correttamente il corpo della richiesta.

Invio della tua prima completazione chat

Invia una richiesta POST a /v1/chat/completions con la cronologia dei messaggi e l'identificatore del modello. L'ID del modello è "uncensored". Questo modello è ottimizzato per rispondere senza rifiuti per contenuti adulti leciti, finzione o argomenti controversi. Non filtra in base alle norme politiche o sociali standard.

Ecco un esempio base di curl per iniziare:

Copycurl https://api.howmuchisanapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a simple hello world function in python"}]
  }'

La risposta conterrà il testo generato nell'array choices. Puoi analizzarlo direttamente nella logica della tua applicazione. Ogni richiesta consuma token di input per il tuo prompt e token di output per la risposta del modello.

Risposte in streaming e utilizzo dei token

Usa Server-Sent Events (SSE) per ricevere i token man mano che vengono generati. Questo riduce la latenza percepita per gli output lunghi. Imposta il parametro stream su true nel corpo della richiesta. Il server invierà più chunk, ciascuno contenente un delta parziale della risposta.

L'ultimo chunk include i dati di utilizzo. Questo oggetto contiene i token totali di input e output consumati dalla richiesta. Puoi usare questi dati per aggiornare il tuo saldo locale o monitorare le tue spese in tempo reale. Lo streaming è ideale per le interfacce chat dove gli utenti si aspettano feedback istantaneo.

Function calling e modalità JSON

L'API supporta l'output strutturato tramite la modalità JSON e il function calling. Imposta response_format su {"type": "json_object"} per forzare il modello a restituire un JSON valido. Questo è utile per estrarre dati o generare configurazioni strutturate senza errori di parsing.

Per la chiamata di funzioni, fornisci un array di strumenti nella tua richiesta. Il modello risponderà con tool_calls se determina che è necessaria una funzione. Puoi poi eseguire la funzione e inviare il risultato al modello. Questo abilita flussi di lavoro complessi a più passaggi senza logica di parsing esterna.

Gestione dei limiti e degli errori

Sei limitato a 300 richieste al minuto per chiave e a 8 richieste concorrenti. Se superi questi limiti, riceverai un errore 429 Too Many Requests. Il corpo della risposta includerà i dettagli retry-after. Regola il throttling lato client per evitare retry non necessari.

Se il tuo credito prepagato è esaurito, l'API restituisce un errore 402 Payment Required. Puoi ricaricare tramite criptovalute in qualsiasi momento. Errori e rifiuti sono gratuiti, quindi paghi solo per la generazione di token con esito positivo. La finestra di contesto è di 100,000 token per prompt e completamento combinati.

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Streaming

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)