utilizzando il base_url sbagliato
L'utilizzo dell'URL base standard di OpenAI fa sì che le tue richieste falliscano o vengano instradate verso un modello diverso. La nostra API richiede di modificare il base_url a https://api.whatisopenrouterai.com/v1. Questa singola riga di configurazione assicura che il tuo SDK si connetta ai nostri server invece che all'infrastruttura globale di OpenAI.
Molti sviluppatori copiano e incollano il loro codice esistente senza aggiornare questa variabile. Se lasci l'URL predefinito, otterrai un errore 404 o colpirai un modello che non è senza filtri. Verifica sempre la connessione controllando il /v1/models endpoint. Dovresti vedere il nostro ID del modello specifico elencato lì. Questo conferma che l'instradamento è corretto prima di inviare la tua prima richiesta di completamento.
dimenticando di impostare l'id del modello
Anche con l'URL di base corretto, l'omissione dell'ID del modello predefinisce un modello generico o più vecchio. Devi impostare esplicitamente il model il parametro a "uncensored" in ogni richiesta. Questo dice al nostro livello di routing di servire il modello open-weight specifico ottimizzato per contenuti non filtrati.
Senza questa istruzione esplicita, potresti ricevere un modello diverso con regole di allineamento diverse. Alcuni modelli rifiutano di default gli argomenti adulti leciti. Forzando la uncensored ID, garantisci il comportamento che ti aspetti. Controlla il tuo codice per eventuali nomi di modello hardcoded che potrebbero sovrascrivere i valori predefiniti del tuo SDK.
ignorando i limiti dei token e gli errori
Il superamento della finestra di contesto di 100,000 token o del limite di output di 16,000 token causa fallimenti immediati della richiesta. La nostra API impone un output massimo di 16,000 token per richiesta. Se non imposti max_tokens, il valore predefinito è solo 2.048 token. Questo è spesso troppo breve per attività di ragionamento complesse.
Errori e rifiuti non consumano il tuo credito prepagato. Tuttavia, le richieste malformed che superano i limiti di velocità o superano la dimensione del corpo (8 MB) contano ancora contro la tua quota. Monitora le intestazioni di risposta per l'utilizzo dei token. Regola la tua ingegneria dei prompt per adattarsi alla finestra di contesto. Questo previene retry costosi e garantisce un flusso di dati fluido.
incomprensione della fatturazione prepagata
Il saldo del tuo account è legato a un credito prepagato, non a un abbonamento mensile. Addebitiamo $0.15 per 1M token di input e $0.50 per 1M token di output. Gli errori sono gratuiti, ma i completamenti riusciti consumano credito. Devi ricaricare tramite criptovaluta per mantenere la disponibilità del servizio.
Accettiamo USDT (TRC20) o USDC (Base) per i ricarichi. I depositi minimi partono da $20. I bonus si applicano ai livelli superiori: +5% da $50, +10% da $100 e +15% da $200. Il credito non scade mai. Assicurati che il tuo saldo sia positivo prima di eseguire batch di grandi dimensioni. Controlla la dashboard per verificare il tuo saldo attuale e le transazioni recenti.
confondere lo streaming con le risposte standard
Lo streaming tramite SSE cambia il modo in cui analizzi il flusso di risposta. Le risposte standard restituiscono un singolo oggetto JSON. Lo streaming restituisce più chunk. Devi gestire l'ultimo chunk per ottenere statistiche accurate sull'utilizzo dei token.
La nostra implementazione dello streaming include l'utilizzo di token nell'ultimo chunk. Se interrompi la lettura dello stream in anticipo, potresti perdere questi dati. Assicurati che la tua libreria client supporti correttamente SSE. Questo è cruciale per le applicazioni in tempo reale in cui si visualizzano i token man mano che vengono generati. Uno streaming configurato male può portare a testo incompleto o stati dell'interfaccia utente interrotti.
errori di configurazione tool_choice
Non corretto tool_choice impostazioni possono impedire al function calling di funzionare come previsto. Puoi forzare uno strumento specifico o lasciare che il modello decida. Una configurazione errata spesso porta il modello a ignorare le funzioni disponibili.
Usa tool_choice per controllare se il modello chiama gli strumenti automaticamente. Impostalo su "auto" per la flessibilità o specifica un ID strumento per un comportamento rigoroso. Assicurati che le tue definizioni di funzione corrispondano allo schema previsto. Questo evita errori di runtime quando il modello tenta di chiamare una funzione inesistente. Testa attentamente le tue definizioni di strumento prima di distribuire in produzione.
modalità json_object mancante
Senza response_format: {"type": "json_object"}, il modello potrebbe outputare markdown o testo normale. Questo interrompe i parser che si aspettano JSON rigoroso. Abilita la modalità JSON per garantire un output coerente e analizzabile.
Questa funzionalità è essenziale per l'integrazione con sistemi downstream che richiedono dati strutturati. Riduce significativamente il sovraccarico di post-elaborazione. Convalida sempre lo schema di output nel codice client. Questo garantisce la robustezza contro eventuali allucinazioni del modello. Utilizza questa modalità quando estrai entità o generi file di configurazione.
sorprese sui limiti di frequenza
La nostra API consente 300 richieste al minuto per chiave. Il superamento di questo limite comporta una risposta 429 Too Many Errors. Le richieste concorrenti sono limitate a 8 per chiave. Pianifica di conseguenza le impostazioni di concorrenza.
Se esegui più processi, assicurati che condividano la stessa chiave o genera chiavi separate. Ogni account supporta una chiave attiva. Una nuova chiave sostituisce quella vecchia. Monitora le intestazioni del limite di frequenza nella risposta. Implementa un backoff esponenziale nella logica di ritentativo. Questo previene i guasti a cascata durante i periodi di traffico elevato.
ritardi nei ricarichi cripto
Le transazioni in criptovaluta possono richiedere tempo per la conferma sulla blockchain. Il tuo credito potrebbe non apparire immediatamente dopo l'invio dei fondi. Utilizza la rete corretta: TRC20 per USDT o Base per USDC. L'invio sulla rete sbagliata causa la perdita dei fondi.
Le ricariche vanno da $20 a $500. Assicurati di inviare l'importo esatto o di considerare le commissioni di rete. Controlla l'hash della transazione sull'esploratore della blockchain. Se il credito è in ritardo, contatta il supporto con l'ID della transazione. Non assumere che il pagamento sia fallito immediatamente. La pazienza durante la congestione della rete è fondamentale per operazioni fluide.
