Comprendre l'URL de base
L'URL de base définit l'endroit où votre client envoie les requêtes. Une incompatibilité ici entraîne immédiatement des échecs de connexion ou des réponses de modèle inattendues. De nombreux développeurs supposent que l'URL OpenAI standard fonctionne universellement, mais les fournisseurs sans censure utilisent souvent des points de terminaison distincts pour acheminer le trafic vers des pools de modèles spécifiques.
Vérifiez que votre configuration pointe vers https://api.openrouterabliteratedmodels.com/v1 pour notre service. Si vous utilisez un agrégateur tiers, assurez-vous que l'URL de base correspond exactement à leur documentation. Des URL incorrectes entraînent souvent des erreurs 404 ou des réponses provenant de modèles par défaut au lieu de la variante non censurée prévue.
- Vérifiez vos variables d'environnement pour
BASE_URLouAPI_HOST. - Assurez-vous que le chemin inclut
/v1pour la compatibilité standard. - Testez la connectivité avec une simple requête de liste de modèles avant une utilisation intensive.
Gestion des limites de débit
Les limites de taux restreignent le nombre de requêtes que vous pouvez envoyer dans un délai spécifique. Notre API applique une limite de 300 requêtes par minute par clé. Le dépassement de ce seuil entraîne des erreurs HTTP 429, bloquant temporairement les requêtes suivantes jusqu'à la réinitialisation de la fenêtre.
De plus, il y a une limite de requêtes simultanées de 8 requêtes en même temps par clé. Si vous envoyez plus de 8 requêtes simultanées, l'excédent sera mis en file d'attente ou échouera selon votre bibliothèque cliente. Surveillez la concurrence de votre application pour éviter de dépasser ces limites strictes. Utilisez des stratégies de backoff exponentiel dans votre code pour gérer les erreurs 429 sans surcharger le serveur.
N'oubliez pas que chaque clé est unique à votre compte. Partager des clés entre plusieurs services peut accélérer l'atteinte de ces limites. Générez une nouvelle clé si vous avez besoin de pools de limites de débit séparés pour différentes parties de votre application.
Réponses : Streaming vs Non-Streaming
Le streaming retourne des données de manière incrémentale au fur et à mesure de la génération des tokens, tandis que le non-streaming attend la réponse complète. Le streaming est essentiel pour les expériences utilisateur en temps réel mais nécessite une gestion rigoureuse des Server-Sent Events (SSE).
En streaming, le dernier chunk contient les statistiques d’utilisation des jetons. Si vous arrêtez le traitement prématurément, vous risquez de manquer ces données. Assurez-vous que votre client analyse le dernier message SSE pour récupérer avec précision les comptes de jetons d’entrée et de sortie. Les réponses non-streaming sont plus simples mais peuvent entraîner une latence élevée pour les longues sorties.
Choisissez le streaming pour les interfaces de chat où les utilisateurs voient le texte apparaître caractère par caractère. Utilisez le mode non-streaming pour le traitement par lots ou lorsque vous avez besoin de la réponse complète avant de continuer. Notre API prend en charge les deux modes via le stream le paramètre dans le corps de la requête.
Erreurs du Mode JSON
Le mode JSON garantit que le modèle produit du JSON valide, ce qui est critique pour l'intégration programmatique. Les erreurs proviennent souvent de mauvais en-têtes ou de mismatchs de schéma. L'API nécessite response_format: {"type": "json_object"} pour imposer une sortie JSON stricte.
Si vous recevez un JSON malformé, vérifiez la définition de votre schéma. Le modèle peut inclure des blocs de code markdown ou du texte explicatif en dehors de la structure JSON. Utilisez un analyseur robuste capable de supprimer les balises markdown ou de valider la sortie par rapport à votre schéma attendu. Évitez les schémas trop complexes qui pourraient confondre le modèle.
Testez d'abord avec des structures simples. Ajoutez progressivement de la complexité pour identifier où le modèle rencontre des difficultés. Assurez-vous que votre température est réglée correctement, car des températures plus élevées peuvent augmenter l'aléatoire et réduire la validité du JSON.
Erreurs de calcul du nombre de jetons
Les comptes de tokens déterminent votre facturation et l'utilisation de la fenêtre de contexte. Des calculs erronés peuvent entraîner des frais inattendus ou des réponses tronquées. Notre API facture 0,15 $ par 1M de tokens d'entrée et 0,50 $ par 1M de tokens de sortie.
Utilisez une bibliothèque de tokenisation fiable qui correspond au schéma de tokenisation du modèle. Différents modèles peuvent tokeniser les espaces blancs ou la ponctuation différemment, entraînant des écarts entre votre comptage local et celui de l'API. Fiez-vous toujours à l'utilisation des tokens retournée dans la réponse pour une facturation précise.
Surveillez votre fenêtre de contexte, qui est de 100 000 tokens au total. Dépasser cette limite entraînera des erreurs. Tronquez les messages ou résumés les plus anciens pour rester dans les limites. Surveillez votre consommation de tokens au fil du temps pour optimiser la structure de vos prompts et réduire les coûts.
Retards de paiement crypto
Les recharges en crypto via USDT (TRC20) ou USDC (Base) sont traitées instantanément de notre côté. Cependant, la congestion du réseau peut parfois entraîner de légers retards de confirmation. Assurez-vous d'envoyer le bon montant et sur le bon réseau pour éviter toute perte.
Les recharges vont de $20 à $500 en montants entiers. Les crédits bonus s'appliquent automatiquement : +5 % à partir de $50, +10 % à partir de $100, et +15 % à partir de $200. Vérifiez le hash de la transaction pour confirmer le paiement. Si les crédits n'apparaissent pas dans les quelques minutes qui suivent, vérifiez l'explorateur de blockchain pour l'état de la transaction.
Le crédit n'expire jamais, il n'y a donc aucune urgence à l'utiliser immédiatement. Les erreurs comme les doubles facturations sont résolues via la page Support. Conservez vos relevés de transaction pour une référence facile en cas de problème.
Configuration de l'ID du modèle
L'ID de modèle identifie la version du modèle sans censure que vous utilisez. Pour notre service, l'ID de modèle est uncensored. L'utilisation d'un ID incorrect peut entraîner des erreurs ou un comportement inattendu.
Assurez-vous que vos requêtes spécifient model: "uncensored" dans le corps de la requête. Cet ID pointe vers notre modèle open-weight spécifique ajusté pour les réponses non restreintes. Il ne s'agit pas d'un identifiant générique, mais d'un pointeur spécifique vers notre instance hébergée.
Vérifiez la documentation de votre bibliothèque cliente pour savoir comment définir l'ID du modèle. Certaines bibliothèques utilisent un model champ, tandis que d'autres peuvent utiliser un paramètre différent. La cohérence dans l'utilisation de l'ID du modèle dans votre application évite les confusions et garantit que vous appelez toujours le modèle uncensored prévu.
Dépassements de Fenêtre de Contexte
La fenêtre de contexte limite le nombre total de tokens que vous pouvez envoyer dans une seule requête. Notre API prend en charge une fenêtre de 100 000 tokens, incluant à la fois l'invite et la complétion. Dépasser cette limite entraîne une erreur.
Pour gérer le contexte, implémentez une stratégie de fenêtre glissante. Supprimez les messages plus anciens ou résumez-les pour libérer de l'espace. Surveillez le nombre de tokens de votre entrée pour vous assurer qu'il reste dans la limite de 100,000 tokens. Si vous dépassez la limite, l'API rejettera la requête.
Utilisez le max_tokens paramètre pour contrôler la longueur de la sortie. La sortie maximale par requête est de 16 000 jetons. La définition de ce paramètre aide à éviter une utilisation excessive de jetons et maintient les réponses dans des limites gérables pour votre application.
Politique de support et de remboursement
Le crédit n'est pas remboursé une fois utilisé, mais il n'expire jamais. Si vous rencontrez des problèmes de paiement ou de service, contactez le Support via la page dédiée. Les erreurs comme les doubles prélèvements sont résolues par l'équipe Support.
Pour les problèmes techniques, consultez d'abord la documentation. Notre API est simple, mais des cas limites peuvent survenir. Fournissez votre clé API et les détails de la requête lorsque vous demandez de l'aide. Les temps de réponse varient, mais nous visons à résoudre les problèmes rapidement.
N'oubliez pas que le crédit est prépayé. Vous payez ce que vous consommez, les erreurs et les refus étant gratuits. Ce modèle garantit la transparence de la facturation. Utilisez la page Support pour toute divergence ou question concernant votre compte.
