URL base e autenticazione
La nostra API è completamente compatibile con OpenAI, il che significa che puoi utilizzare qualsiasi SDK standard con modifiche minime. L'URL di base per tutte le richieste è https://api.openrouterapi.top/v1. L'autenticazione viene gestita tramite un token Bearer passato nell'intestazione Authorization. Puoi generare questa chiave istantaneamente iscrivendoti con Google o un indirizzo email sul nostro cruscotto. Mantieni la chiave al sicuro, poiché fornisce accesso diretto al tuo credito prepagato.
Prima richiesta
Testa l'endpoint con un semplice comando curl. Sostituisci YOUR_API_KEY con la tua chiave effettiva. L'ID del modello è impostato su uncensored per bypassare i blocchi dei contenuti standard. Questa richiesta invia un prompt e attende la risposta completa.
curl https://api.openrouterapi.top/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."}]
}'Se la chiave non è valida, ricevi un errore 401. Se il tuo credito prepagato è esaurito, ricevi un errore 402. Questi errori non consumano il tuo saldo di token, ma contano verso la tua quota di limite di richieste.
Integrazione SDK Python
L'utilizzo del pacchetto Python ufficiale openai è semplice. Inizializza il client con il tuo URL di base e la chiave. L'SDK gestisce automaticamente la serializzazione JSON. Questo esempio dimostra una richiesta di generazione chat di base.
from openai import OpenAI
client = OpenAI(base_url="https://api.openrouterapi.top/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)Assicurati di aver installato l'ultima versione dell'SDK. L'oggetto client gestisce il pool di connessioni, quindi puoi riutilizzarlo per più richieste senza reinizializzarlo.
Integrazione SDK Node.js
Per gli ambienti JavaScript, l'SDK Node funziona allo stesso modo. Passa l'URL base personalizzato durante l'inizializzazione. Questo approccio ti consente di integrare la generazione senza censura nelle app web esistenti o nei servizi backend senza problemi.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.openrouterapi.top/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);L'SDK Node supporta sia i pattern basati su promise che async/await. La gestione degli errori è coerente con altri servizi compatibili con OpenAI.
Risposte in streaming
Abilita lo streaming impostando stream: true nella tua richiesta. L'API restituisce Server-Sent Events (SSE). Ogni chunk contiene testo parziale. L'ultimo chunk include le statistiche sull'utilizzo dei token per la fatturazione.
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)Il credito prepagato viene addebitato in base ai token effettivi generati nell'output finale. Lo streaming non modifica il modello di fatturazione; paghi i token che vengono consegnati con successo.
Limiti di richiesta e finestra di contesto
Ogni chiave API è limitata a 300 richieste al minuto e 8 richieste parallele. La dimensione massima del corpo della richiesta è di 8 MB. La finestra di contesto supporta fino a 100.000 token in totale (input più output). L'output massimo per richiesta è di 32.000 token, o 2.048 se max_tokens non è impostato. Errori come 401 o 402 non consumano credito, ma contano verso il tuo limite di richieste. Anche i rifiuti per specifici tipi di contenuto sono gratuiti.
