Avvio rapido API senza filtri
Ottieni la tua chiave API e inizia a inviare richieste al nostro endpoint compatibile con OpenAI e rispettoso del GDPR. Questa guida copre le chiamate OpenAI-compatible essenziali di cui hai bisogno per un'integrazione rapida.
Prerequisiti: la tua chiave API
Recupera le tue credenziali immediatamente dopo la registrazione. Vai al Ottieni la chiave API pagina e autentica tramite Continua con Google o inserendo la tua email e password. Il sistema visualizza la tua chiave univoca istantaneamente e non è richiesto un numero di telefono per questo passaggio. Puoi rigenerare una chiave in qualsiasi momento, ma ciò invaliderà quella precedente, quindi conservala in modo sicuro. Questa singola chiave autentica tutte le tue richieste all'API.
URL Base e Intestazioni
Indirizza il tuo client all'endpoint corretto per garantire una connettività adeguata. Utilizza l'URL base https://api.openroutergdpr.com/v1 per tutte le interazioni. Imposta il Authorization header per Bearer YOUR_API_KEY e il Content-Type a application/json. Questa configurazione funziona con qualsiasi SDK standard di OpenAI o client HTTP senza richiedere adattatori personalizzati. Supportiamo parametri standard come temperature e top_p per controllare la variabilità della risposta.
Invio della tua prima richiesta
Esegui un completamento di base per verificare che la configurazione sia corretta. Invia una richiesta POST a /v1/chat/completions con l'identificatore del modello uncensored. Questo conferma che la tua chiave funziona e che il modello risponde agli input di testo come previsto. Il modello gestisce argomenti non restrittivi per l'uso adulto legale senza i rifiuti standard. Vedi l'esempio seguente per la struttura JSON minima richiesta.
curl https://api.openroutergdpr.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List the GDPR articles applicable to cross-border data transfers."}]
}'
Gestione delle risposte in streaming
Ricevi aggiornamenti token per token per una latenza inferiore e una migliore esperienza utente. Abilita lo streaming impostando stream: true nel corpo della richiesta. Il server invia Server-Sent Events (SSE) contenenti risposte parziali. L'ultimo chunk include le statistiche complete di utilizzo dei token per l'accuratezza della fatturazione. Questo approccio è ideale per le interfacce chat dove gli utenti si aspettano la generazione immediata del testo. Monitora il delta campi per ricostruire il messaggio completo.
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)
Modalità JSON e chiamata di strumenti
Struttura i tuoi output in modo affidabile utilizzando le funzionalità di formattazione integrate. Imposta response_format a {"type": "json_object"} per forzare la conformità JSON. Puoi anche definire tools per il function calling, consentendo al modello di eseguire azioni specifiche. Usa tool_choice per controllare quando il modello decide di chiamare una funzione. Queste funzionalità funzionano con client standard compatibili con OpenAI, rendendo l'integrazione semplice per le applicazioni esistenti.
from openai import OpenAI
client = OpenAI(base_url="https://api.openroutergdpr.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)
Comprendere i limiti dei token
Gestisci la tua finestra di contesto per evitare troncamenti o errori. Il modello supporta una finestra di contesto da 100.000 token sia per il prompt che per il completamento combinati. Ogni richiesta può generare fino a 16.000 token, o 2.048 se non specifichi max_tokens. Sei limitato a 300 richieste al minuto e 8 richieste concorrenti per chiave. La dimensione del corpo della richiesta non deve superare 8 MB. Il superamento di questi limiti comporta codici di errore HTTP specifici.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.openroutergdpr.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);Domande frequenti
Questo servizio è conforme al GDPR di OpenRouter?
Sì, non utilizziamo i tuoi prompt per i dati di addestramento. A differenza dei router multi-vendor che inviano dati a vari backend, serviamo un singolo modello sui nostri server, fornendo un controllo più chiaro dei dati per le esigenze di conformità UE.
Cosa succede se vengo limitato dalla frequenza?
Riceverai un codice di stato 429 se superi 300 richieste al minuto o 8 connessioni concorrenti. Attendi brevemente prima di riprovare, oppure riduci la tua concorrenza. Assicurati di non inviare payload di grandi dimensioni che superino il limite di corpo di 8 MB.
Perché ricevo un errore 402?
Un codice di stato 402 indica che il saldo del tuo credito prepagato non è sufficiente per la richiesta. Aggiungi fondi al tuo account utilizzando USDT (TRC20) o USDC (Base) per riprendere il servizio. Errori e rifiuti non consumano credito, quindi vengono fatturati solo i completamenti riusciti.
Ottieni la tua chiave API ora
Iscriviti, copia la chiave, aggiorna l'URL di base. È tutto qui.