Compatibilità SDK e configurazione dell'URL di base
Collega il tuo codice client esistente puntandolo al nostro endpoint dedicato. Questo API compatibile con openai accetta intestazioni standard e configurazioni SDK senza modifiche al codice. Devi solo aggiornare l'URL di base e fornire la tua chiave API dal dashboard.
https://api.openrouterratelimits.com/v1 è il punto di ingresso unico per tutte le richieste. L'autenticazione utilizza lo standard schema del token Bearer trovato nella maggior parte delle librerie LLM moderne. Passa la tua chiave nel Authorization header per verificare la tua identità. Questa configurazione funziona con qualsiasi client che si aspetta un'interfaccia in stile OpenAI, rendendo la migrazione istantanea per i team stanchi del vendor lock-in.
- Base URL:
https://api.openrouterratelimits.com/v1 - Intestazione Auth:
Authorization: Bearer YOUR_API_KEY - ID modello:
uncensored
Risposte in streaming con SSE
Abilita lo streaming impostando stream: true nel payload della richiesta. L'API restituisce Server-Sent Events (SSE) per la consegna dei token in tempo reale. Ogni chunk contiene il testo generato fino a quando l'ultimo chunk non include le statistiche di utilizzo. Questo approccio mantiene la tua UI reattiva anche per finestre di contesto lunghe.
Lo streaming è ideale per interfacce chat o scenari di roleplay dove la latenza è importante. Non è necessario attendere il completamento completo per visualizzare il testo. L'ultimo chunk contiene sempre i conteggi dei token per una fatturazione accurata. Gli errori durante lo streaming restituiscono comunque codici di stato HTTP corretti per una gestione immediata.
Function calling e modalità JSON
Usa gli output strutturati per un'estrazione affidabile dei dati o l'integrazione con gli strumenti. Abilita response_format con {"type": "json_object"} per forzare la conformità JSON. Questa modalità è essenziale per analizzare strutture nidificate complesse senza logica di pulizia aggiuntiva. Il function calling funziona insieme alla generazione di testo standard per flussi di lavoro dinamici degli agenti.
Definisci i tuoi strumenti nel tools array e specifica tool_choice per un'applicazione rigorosa. Il modello restituisce chiamate di funzione nel formato standard OpenAI. Questa funzione supporta chiamate di tool singole e multiple all'interno di un singolo turno. Usalo per costruire agent che interagiscono in modo affidabile con API o database esterni.
Gestione dei token e dei parametri
Controlla il comportamento di generazione con parametri standard come temperature, top_p, e stop. La finestra di contesto supporta fino a 100,000 token totali per prompt e completamento combinati. Questo consente di gestire un contesto storico esteso o l'elaborazione di documenti di grandi dimensioni in una singola richiesta.
Imposta max_tokens per limitare la lunghezza dell'output, con un valore predefinito di 2.048 se omesso. Il modello gestisce presence_penalty e frequency_penalty per il controllo stilistico. L'utilizzo dei token viene addebitato in base ai conteggi effettivi di input e output. Gli errori non consumano token, garantendo un fatturazione equa per le richieste fallite.
Comprendere i limiti di velocità per chiave
Ogni chiave API supporta 300 richieste al minuto con un limite di concorrenza di 8 richieste simultanee. Questo limite si applica per chiave, quindi la creazione di più chiavi scala il tuo throughput in modo lineare. La dimensione massima del corpo della richiesta è di 8 MB, che rientra nella finestra di contesto per la maggior parte dei casi d'uso.
I limiti di frequenza si resettano continuamente in base a una finestra scorrevole. Se superi il limite, l'API restituisce un errore 429. Aggiorna il tuo credito prepagato per mantenere l'accesso prioritario. A differenza dei piani condivisi, i nostri server dedicati non soffrono del rumore dei vicini. Monitora la dashboard del tuo utilizzo per rimanere entro questi confini per prestazioni coerenti.
Risoluzione degli errori comuni
Gestisci gli errori controllando il codice di stato HTTP e il corpo della risposta. Un errore 401 indica una chiave API non valida o mancante. Rigenera la tua chiave dal dashboard se l'autenticazione fallisce. Un errore 402 significa che il tuo credito prepagato è esaurito; ricarica tramite criptovalute per riprendere il servizio.
Un errore 429 segnala che hai superato i limiti di velocità. Riduci la frequenza delle richieste o dividi i carichi di lavoro su più chiavi. L'API non addebita token per questi errori, quindi non perdi credito per i retry. Assicurati che la tua libreria client gestisca i retry con backoff esponenziale per una maggiore robustezza.
cURL
curl https://api.openrouterratelimits.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Process one million logs"}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.openrouterratelimits.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
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.openrouterratelimits.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
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)