en utilisant le mauvais base_url
L'utilisation de l'URL de base OpenAI standard entraîne l'échec de vos requêtes ou leur routage vers un modèle différent. Notre API nécessite que vous modifiiez le base_url à https://api.whatisopenrouterai.com/v1. Une seule ligne de configuration assure la connexion de votre SDK à nos serveurs au lieu de l'infrastructure OpenAI mondiale.
De nombreux développeurs copient-colleur leur code existant sans mettre à jour cette variable. Si vous laissez l'URL par défaut, vous obtiendrez soit une erreur 404, soit vous atteindrez un modèle qui n'est pas uncensored. Vérifiez toujours la connexion en examinant le /v1/models endpoint. Vous devriez y voir notre ID de modèle spécifique listé. Cela confirme que le routage est correct avant d’envoyer votre première requête de complétion.
en oubliant de définir l'identifiant du modèle
Même avec l'URL de base correcte, l'omission de l'ID du modèle entraîne l'utilisation par défaut d'un modèle générique ou plus ancien. Vous devez définir explicitement le model le paramètre à "uncensored" dans chaque requête. Cela indique à notre couche de routage de servir le modèle open-weight spécifique ajusté pour le contenu non restreint.
Sans cette instruction explicite, vous pourriez recevoir un modèle différent avec des règles d'alignement différentes. Certains modèles refusent par défaut les sujets adultes licites. En forçant le uncensored ID, vous garantissez le comportement attendu. Vérifiez votre code pour tout nom de modèle codé en dur qui pourrait remplacer les valeurs par défaut de votre SDK.
ignoring token limits and errors
Dépasser la fenêtre de contexte de 100,000 tokens ou la limite de sortie de 16,000 tokens entraîne des échecs immédiats de la requête. Notre API impose une sortie maximale de 16,000 tokens par requête. Si vous ne définissez pas max_tokens, la valeur par défaut n'est que de 2 048 tokens. C'est souvent trop court pour les tâches de raisonnement complexes.
Les erreurs et les refus ne consomment pas votre crédit prépayé. Cependant, les requêtes malformées qui atteignent les limites de débit ou dépassent la taille du corps (8 Mo) comptent toujours contre votre quota. Surveillez les en-têtes de réponse pour l'utilisation des jetons. Ajustez votre ingénierie de prompt pour tenir dans la fenêtre de contexte. Cela évite les nouvelles tentatives coûteuses et garantit un flux de données fluide.
compréhension erronée de la facturation prépayée
Votre solde de compte est lié à un crédit prépayé, et non à un abonnement mensuel. Nous facturons $0.15 par 1M de tokens d'entrée et $0.50 par 1M de tokens de sortie. Les erreurs sont gratuites, mais les complétions réussies consomment du crédit. Vous devez recharger en crypto pour maintenir la disponibilité du service.
Nous acceptons USDT (TRC20) ou USDC (Base) pour les recharges. Les dépôts minimums commencent à $20. Des bonus s'appliquent aux paliers supérieurs : +5% à partir de $50, +10% à partir de $100, et +15% à partir de $200. Le crédit n'expire jamais. Assurez-vous que votre solde est positif avant de lancer de grands lots. Consultez le tableau de bord pour vérifier votre solde actuel et vos transactions récentes.
confondre le streaming avec les réponses standard
Le streaming via SSE modifie la manière dont vous analysez le flux de réponse. Les réponses standard retournent un seul objet JSON. Le streaming retourne plusieurs chunks. Vous devez traiter le dernier chunk pour obtenir des statistiques précises sur l'utilisation des tokens.
Notre implémentation du streaming inclut l'utilisation de tokens dans le dernier chunk. Si vous arrêtez de lire le flux prématurément, vous risquez de manquer ces données. Assurez-vous que votre bibliothèque cliente prend correctement en charge SSE. C'est crucial pour les applications en temps réel où vous affichez les tokens au fur et à mesure de leur génération. Un streaming mal configuré peut entraîner un texte incomplet ou des états d'interface utilisateur corrompus.
erreurs de configuration du choix d'outil
Incorrect tool_choice paramètres peuvent empêcher l'appel de fonctions de fonctionner comme prévu. Vous pouvez forcer un outil spécifique ou laisser le modèle décider. Une mauvaise configuration entraîne souvent l'ignorance des fonctions disponibles par le modèle.
Utiliser tool_choice pour contrôler si le modèle appelle des outils automatiquement. Définissez-le à "auto" pour la flexibilité ou spécifiez un ID d'outil pour un comportement strict. Assurez-vous que vos définitions de fonction correspondent au schéma attendu. Cela évite les erreurs d'exécution lorsque le modèle essaie d'appeler une fonction inexistante. Testez vos définitions d'outil minutieusement avant le déploiement en production.
mode json_object manquant
Sans response_format: {"type": "json_object"}, le modèle peut générer du Markdown ou du texte brut. Cela casse les analyseurs qui attendent du JSON strict. Activez le mode JSON pour garantir une sortie cohérente et analysable.
Cette fonctionnalité est essentielle pour l'intégration avec des systèmes en aval nécessitant des données structurées. Elle réduit considérablement la surcharge de post-traitement. Validez toujours le schéma de sortie dans le code client. Cela garantit la robustesse contre les hallucinations occasionnelles du modèle. Utilisez ce mode lors de l'extraction d'entités ou de la génération de fichiers de configuration.
Surprises de limites de taux
Notre API permet 300 requêtes par minute par clé. Le dépassement de cette limite entraîne une réponse 429 Too Many Errors. Les requêtes simultanées sont limitées à 8 par clé. Planifiez vos paramètres de concurrence en conséquence.
Si vous exécutez plusieurs processus, assurez-vous qu'ils partagent la même clé ou générez des clés séparées. Chaque compte prend en charge une clé active. Une nouvelle clé remplace l'ancienne. Surveillez les en-têtes de limite de débit dans la réponse. Implémentez une réessaye exponentielle dans votre logique de réessaye. Cela empêche les défaillances en cascade pendant les périodes de fort trafic.
délais de rechargement crypto
Les transactions crypto peuvent prendre du temps à être confirmées sur la blockchain. Votre crédit peut ne pas apparaître instantanément après l'envoi de fonds. Utilisez le bon réseau : TRC20 pour USDT ou Base pour USDC. Envoyer sur le mauvais réseau entraîne une perte de fonds.
Les recharges varient de 20 $ à 500 $. Assurez-vous d'envoyer le montant exact ou de tenir compte des frais de réseau. Vérifiez le hash de la transaction sur l'explorateur de blockchain. Si le crédit est retardé, contactez le support avec l'ID de transaction. Ne supposez pas que le paiement a échoué immédiatement. La patience lors des congestions réseau est clé pour des opérations fluides.
