Il OpenRouter API Spiegato
Un'API compatibile con OpenAI ti permette di sostituire il tuo codice con un nuovo provider senza riscrivere la logica, il che è fondamentale quando hai bisogno di modelli uncensored per casi d'uso specifici. Questa guida spiega come funzionano gli URL di base, la tariffazione dei token e lo streaming in modo che tu possa integrare un endpoint alternativo in modo affidabile.
Ultimo aggiornamento
Riepilogo
- Usa l'endpoint standard /v1/chat/completions con qualsiasi SDK OpenAI semplicemente cambiando l'URL di base.
- La tariffazione a token è prepagata e trasparente, addebitando solo per l'utilizzo effettivo senza abbonamenti mensili.
- Le risposte in streaming tramite SSE consentono la consegna dei token in tempo reale, essenziale per le interfacce chat.
- Il function calling e la modalità JSON sono supportati per l'estrazione di dati strutturati e l'integrazione di strumenti.
Cos'è un'API compatibile con OpenAI?
È un'API REST che segue l'interfaccia chat-completions di OpenAI. Invii prompt e ricevi output di testo utilizzando payload JSON standard. Questa compatibilità significa che il tuo codice client esistente funziona senza modifiche sostanziali.
L'endpoint principale è POST /v1/chat/completions. Accetta messaggi come array di oggetti role e content. Puoi anche elencare i modelli disponibili tramite GET /v1/models. Questa standardizzazione riduce significativamente i tempi di integrazione.
Il nostro servizio fornisce esattamente questa interfaccia. Serviamo un singolo modello uncensored sotto l'ID "uncensored". Esegue sui nostri server. Non effettua il routing verso altri fornitori. Hai accesso diretto al modello di cui hai bisogno.
Le finestre di contesto supportano fino a 100,000 token in totale. I limiti di output sono di 16,000 token per richiesta. Lo streaming è disponibile tramite Server-Sent Events. La chiamata di funzioni e la modalità JSON sono pienamente supportate.
Comprensione degli URL di base e delle chiavi API
L'URL di base punta al server che gestisce le tue richieste. Sostituisci l'URL predefinito di OpenAI con il nostro endpoint specifico. Il nostro URL di base è HTTPS://api.openrouterabliterated.com/v1. Questa modifica indirizza il traffico verso la nostra infrastruttura uncensored.
Le chiavi API autenticano le tue richieste. Generi una chiave per account. La chiave viene mostrata immediatamente dopo la registrazione. Puoi sostituirla se necessario. Ogni account mantiene una chiave attiva alla volta.
I limiti di frequenza sono applicati per chiave. Puoi inviare 300 richieste al minuto. Fino a 8 richieste possono essere eseguite simultaneamente. I corpi delle richieste sono limitati a 8 MB. Questi limiti gestiscono bene l'uso ad alto volume.
La registrazione richiede solo un'email o un account Google. Non è necessario il numero di telefono. La chiave appare istantaneamente. Puoi iniziare a inviare richieste immediatamente. La privacy è preservata; i prompt non vengono utilizzati per l'addestramento.
Perché scegliere un modello senza filtri per il tuo caso d'uso?
I modelli uncensored non rifiutano argomenti adulti leciti, di finzione o controversi. Sono ideali per la scrittura creativa, il roleplay o la ricerca. I modelli mainstream applicano spesso guardrail rigorosi. Questi possono interrompere il flusso di generazione.
Il nostro modello è ottimizzato per rispondere direttamente. Gestisce i contenuti NSFW senza obiezioni. Funziona bene per la filosofia politica o i generi di nicchia. Ottieni un comportamento coerente senza prompt aggiuntivi.
L'uso degli strumenti è supportato. Puoi definire gli strumenti per la tua applicazione. Il modello rispetta le scelte degli strumenti. Questo lo rende adatto per flussi di lavoro complessi. Errori e rifiuti sono gratuiti. Paghi solo per l'utilizzo effettivo.
I limiti sul contenuto continuano a valere. I contenuti sessuali che coinvolgono minori vengono sempre rifiutati. Questo è un limite invalicabile. Garantisce standard di sicurezza di base. Tutto il resto è disponibile per il tuo caso d'uso.
Prezzi dei Token: Come vengono calcolati i costi
Il prezzo si basa sull'utilizzo dei token. I token di input costano $0,15 per 1 milione di token. I token di output costano $0,50 per 1 milione di token. Paghi solo per ciò che utilizzi. Non ci sono costi nascosti.
Il credito è prepagato. Ricarichi solo con criptovalute. Sono accettati USDT su TRC20 o USDC su Base. È consentito qualsiasi importo intero da $20 a $500. I crediti non scadono mai. Questo evita il blocco con gli abbonamenti.
Il credito bonus è disponibile sui ricarichi. Ottieni un bonus del +5% da $50. Bonus del +10% da $100. Bonus del +15% da $200. Questo riduce il tuo costo effettivo. Gli errori sono gratuiti. I rifiuti sono gratuiti. Paghi solo per i token con esito positivo.
Un account di prova riceve 0,50 $. È valido per 7 giorni. Questo ti permette di testare l'API a fondo. Puoi verificare l'integrazione prima di impegnare fondi.
Risposte: streaming vs non-streaming
Lo streaming invia i token man mano che vengono generati. Questo riduce la latenza percepita. Gli utenti vedono il testo apparire in tempo reale. È essenziale per le interfacce chat. Il non-streaming attende la risposta completa. Questo può sembrare lento per output lunghi.
Supportiamo lo streaming tramite SSE. L'ultimo chunk include l'utilizzo dei token. Ciò consente un tracciamento accurato della fatturazione. Puoi gestire le risposte parziali in modo elegante. Gli errori vengono gestiti in modo coerente.
È disponibile anche la modalità non streaming. Restituisce la risposta completa in una volta. Questo è più semplice per l'elaborazione in batch. Scegli in base alle tue esigenze. Entrambe le modalità utilizzano lo stesso endpoint.
La chiamata di funzioni può essere in streaming. Gli strumenti vengono eseguiti non appena vengono identificati. Questo migliora l'interattività. Puoi iniziare a elaborare gli input in anticipo. L'API gestisce la complessità per te.
Function Calling e output strutturato
Il function calling permette al modello di invocare strumenti. Definischi gli schemi degli strumenti nella richiesta. Il modello restituisce chiamate di funzione. Il tuo codice le esegue. Questo abilita flussi di lavoro complessi. Puoi costruire agenti o assistenti.
La modalità JSON forza un output strutturato. Il modello restituisce un JSON valido. Questo è utile per l'estrazione di dati. Ottieni formati coerenti. L'analisi è più semplice. Gli errori sono rari.
Parametri come temperatura e top_p controllano il comportamento. Le sequenze di stop limitano l'output. I seed garantiscono la riproducibilità. Le penalità riducono la ripetizione. Hai un controllo granulare.
La scelta dello strumento può essere automatica o forzata. Specifichi la preferenza del modello. Questo guida il processo di generazione. Migliora l'affidabilità. La tua applicazione rimane robusta.
Librerie client e SDK comuni
La maggior parte degli SDK funziona con modifiche minime. Aggiorni solo l'URL di base. Il resto del codice rimane invariato. Questo si applica a Python, Node.js e altri. L'integrazione è semplice.
L'SDK OpenAI è lo standard. Gestisce l'autenticazione e i retry. Passi la tua chiave API. L'URL di base punta al nostro servizio. Le richieste vengono inviate normalmente.
Lo streaming è supportato in tutti gli SDK. Iteri sui chunk. L'utilizzo dei token è disponibile nell'ultimo chunk. Questo corrisponde al nostro modello di fatturazione. Gli errori vengono rilevati in modo coerente.
Il function calling è integrato negli SDK moderni. Passi le definizioni degli strumenti. L'SDK analizza le risposte. Il tuo codice esegue gli strumenti. Il ciclo continua fino al termine. È efficiente e affidabile.
Risoluzione degli errori API comuni
I limiti di frequenza restituiscono errori 429. Puoi inviare 300 richieste al minuto. Il superamento di questo limite attiva un'attesa. Implementa un backoff esponenziale. Questo impedisce di sovraccaricare il server.
Le chiavi non valide restituiscono errori 401. Controlla la tua chiave API. Assicurati che sia attiva. Sostituiscila se necessario. Ogni account ha una sola chiave. Generane una nuova se la perdi.
Si verificano errori JSON nella modalità JSON. Assicurati che lo schema sia valido. Il modello deve restituire un JSON valido. Se fallisce, riprova. Regola la temperatura per una migliore stabilità.
I timeout si verificano con generazioni lunghe. Aumenta il valore del timeout. Lo streaming riduce il rischio di timeout. Le risposte parziali vengono gestite. Puoi ricostruire l'output completo.
Prossimi passi: Ottenere la tua prima chiave API
Visita la pagina di registrazione. Usa Google o email. Non è richiesto il numero di telefono. Il processo è veloce. Ottieni accesso immediato.
La tua chiave API è stata visualizzata. Copiala in modo sicuro. Usala nel tuo SDK. Imposta l'URL base sul nostro endpoint. Inizia a inviare richieste.
Ricarica con criptovalute. Sono accettati USDT o USDC. Ottieni credito bonus per importi maggiori. I crediti non scadono. Usali al tuo ritmo.
Testa con il credito di prova. Dura 7 giorni. Verifica lo streaming e il function calling. Esplora le capacità del modello. Integralo nella tua app. L'API è pronta per la produzione.
Domande comuni
Il modello senza filtri è lo stesso dei modelli di OpenRouter?
No, il nostro modello è indipendente. Esegue sui nostri server. Non è GPT, Claude o il modello di alcun altro fornitore. È ottimizzato per risposte non filtrate. Ottieni accesso diretto senza instradamento.
Come pago per l'API?
Accettiamo solo criptovalute. Sono supportati USDT su TRC20 o USDC su Base. Le ricariche vanno da $20 a $500. Il credito bonus viene aggiunto per importi più cospicui. I crediti non scadono mai.
Posso usarlo con l'SDK OpenAI?
Sì, è completamente compatibile. Modifica l'URL di base con il nostro endpoint. Utilizza lo stesso metodo di autenticazione. Il resto del tuo codice rimane invariato. Lo streaming e il function calling funzionano come previsto.
Quali sono i limiti di frequenza?
Puoi inviare 300 richieste al minuto. Fino a 8 richieste possono essere eseguite simultaneamente. I corpi delle richieste sono limitati a 8 MB. Questi limiti gestiscono bene i consumi ad alto volume. Errori e rifiuti sono gratuiti.
Ottieni la tua chiave API
Iscriviti, copia la chiave, aggiorna il tuo URL di base. È tutto qui.
