Best LLM API Docs
Guida rapida: Integrazione pronta all'uso
Integra la nostra API LLM senza censura nella tua applicazione modificando l'URL di base e la chiave API nel tuo codice esistente compatibile con OpenAI.
Prerequisiti
Prima di effettuare la tua prima richiesta, assicurati di avere una chiave API valida. Iscriviti alla pagina Ottieni chiave API per ricevere la tua chiave istantaneamente. Non è richiesta una carta di credito per la prova iniziale. Avrai bisogno di un ambiente di linguaggio di programmazione supportato (Python 3.8+ o Node.js 18+) e dell'SDK ufficiale OpenAI installato nel tuo progetto.
Il nostro servizio agisce come una sostituzione pronta all'uso per gli endpoint standard di chat-completions. Non è necessario installare una libreria client personalizzata; l'SDK OpenAI standard gestisce il protocollo di comunicazione, incluso lo streaming e la chiamata di strumenti, purché si configuri correttamente l'URL di base.
Autenticazione
L'autenticazione viene gestita tramite l'intestazione Authorization. Passa la tua chiave API come token Bearer. Se la chiave non è valida o è scaduta, l'API restituisce un errore 401 Unauthorized. Se il saldo del tuo account è insufficiente, ricevi un errore 402 Payment Required. Aggiungi la tua chiave alle variabili di ambiente o al file di configurazione per evitare di memorizzare le credenziali in codice.
- Intestazione:
Authorization: Bearer YOUR_API_KEY - URL di base:
https://api.bestllmapi.com/v1
Mantieni la tua chiave sicura. Puoi rigenerarla in qualsiasi momento dal tuo dashboard, il che invalida immediatamente la chiave precedente.
Completamento chat di base
Invia una richiesta POST a /v1/chat/completions con un ID model uncensored e la cronologia dei messaggi. L'API restituisce una risposta testuale. Questo endpoint supporta strutture JSON standard OpenAI, rendendo la migrazione da altri provider semplice.
Assicurati di strutturare correttamente i messaggi con ruoli come system, user e assistant. Il modello elabora l'input e genera un completamento basato sul contesto del tuo prompt.
curl https://api.bestllmapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
Risposte in streaming
Per esperienze utente in tempo reale, abilita lo streaming impostando stream: true nel corpo della richiesta. L'API restituisce uno stream di Server-Sent Events (SSE) contenente oggetti delta. Ogni delta contiene un frammento del testo generato. Elaborare questi chunk in modo incrementale per visualizzare il testo man mano che viene generato, riducendo la latenza percepita per gli utenti finali.
La gestione dello stream è identica al protocollo di streaming standard di OpenAI. Devi gestire l'evento di completamento dello stream per sapere quando la generazione è terminata.
from openai import OpenAI
client = OpenAI(base_url="https://api.bestllmapi.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)
Chiamata di funzioni
Definisci le funzioni nel corpo della richiesta utilizzando il parametro tools. Il modello potrebbe restituire un oggetto di chiamata di funzione invece di testo diretto. Analizza il nome della funzione e gli argomenti, esegui la funzione nel tuo codice e poi invia i risultati al modello per una risposta finale. Questo permette al tuo LLM di interagire con API o database esterni in modo dinamico.
La chiamata di funzioni segue lo schema standard di OpenAI. Assicurati che le definizioni delle funzioni siano precise per migliorare l'accuratezza del modello nella selezione dello strumento corretto e nell'estrazione degli argomenti.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.bestllmapi.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);
Limiti della finestra di contesto
Il modello supporta una finestra di contesto di 100.000 token, combinando sia i token del prompt che quelli di completamento. Monitora l'utilizzo dei token per evitare di superare questo limite, che comporta un errore 400 Bad Request. Se raggiungi il limite di richieste di 300 richieste al minuto, ricevi un errore 429 Too Many Requests.
Implementa un meccanismo di backoff esponenziale per i retry. I corpi delle richieste sono limitati a 8 MB. Per conversazioni lunghe, valuta di riassumere i messaggi precedenti per restare entro il budget di token mantenendo il contesto.
stream = 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)Specifiche tecniche
Tutti i limiti e le funzioni reali dell'API in un unico posto: controllali prima di ricaricare.
| Voce | Valore |
|---|---|
| Formato | compatibile OpenAI: qualsiasi SDK OpenAI funziona cambiando base URL e chiave |
| Autenticazione | Authorization: Bearer YOUR_KEY |
| Endpoint | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.bestllmapi.com/v1 |
| ID modello | uncensored |
| Function calling | sì — tools, tool_choice; risposte con tool_calls anche in streaming; risultati come role: tool |
| Modalità JSON | response_format: {"type": "json_object"} |
| Output massimo | fino al resto della finestra di 100.000 token; max_tokens opzionale (nessun limite separato) |
| Finestra di contesto | 100.000 token (input + output) |
| Parametri | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Streaming | sì — server-sent events; l'ultimo blocco riporta l'uso dei token |
| Concorrenza | 8 richieste contemporanee per chiave |
| Limite di frequenza | 300 richieste al minuto per chiave |
| Dimensione | fino a 8 MB per richiesta |
| Header | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Scadenza | il credito pagato non scade, nessun abbonamento |
| Bonus | +5% da $50, +10% da $100, +15% da $200 |
| Ricarica | USDT (TRC20) o USDC (Base), qualsiasi importo intero da $20 a $500 |
| Prezzo | $0,15 per 1M token in input · $0,50 per 1M in output |
| Fatturazione | credito prepagato in base all'uso reale; errori e rifiuti gratuiti |
| Prova gratuita | $0,50 per 7 giorni, senza carta · Chiave di prova: 2 richieste parallele, 60 al minuto; limiti completi (8 e 300) dopo la prima ricarica |
| Chiavi | una chiave attiva per account; una nuova sostituisce la precedente |
| Contenuti | contenuti per adulti consentiti; rifiutati i contenuti sessuali con minori |
| Accesso | Google oppure e-mail e password |
Codici di errore
Gli errori arrivano in JSON con un type fisso; le richieste fallite o rifiutate non si pagano.
| Codice | Tipo | Significato |
|---|---|---|
400 | bad_request | JSON non valido, messaggi vuoti, parametro errato o contesto troppo lungo |
401 | missing_key · invalid_key · key_revoked | chiave mancante, errata o sostituita |
402 | no_credit | credito esaurito — ricarica e riparti subito |
403 | content_blocked | contenuti sessuali con minori — rifiutato, non addebitato |
404 | not_found | endpoint sconosciuto |
413 | request_too_large | corpo oltre 8 MB |
429 | rate_limited · concurrency | oltre 300/min o 8 in parallelo — attendi e riprova |
503 | upstream_busy | modello occupato — riprova tra pochi secondi |
Domande e risposte
Questa API è compatibile con l'SDK ufficiale OpenAI?
Sì, è pienamente compatibile. Devi solo modificare l'URL di base e la chiave API nella configurazione esistente dell'SDK OpenAI per utilizzare questo servizio.
Cosa succede se supero il limite di richieste?
L'API restituisce un errore 429 Too Many Requests. Dovresti implementare una logica di retry con backoff esponenziale per gestire l'errore in modo elegante.
Posso usare questa API per la generazione di immagini?
No, questa API serve solo completamenti di testo. Non supporta endpoint per la generazione di immagini, audio o video.
La tua chiave è a un modulo di distanza
Crea un account, copia la chiave, modifica l'URL di base. È tutta la configurazione.