Facturation et erreurs OpenAPI
Fournisseur : Felo · Payé avec le solde de plateforme
Cette page s'applique à /api/v1/data/*, les APIs exclusives de la plateforme Felo OpenAPI. Les appels utilisent le solde de plateforme, un solde de crédits de service libellé en USD. Ils ne consomment pas les crédits Felo Pro. Les anciennes APIs Felo sous /v2 utilisent des crédits Pro.
Lire les prix actuels
curl -sS https://openapi.felo.ai/api/v1/data/pricesCe point de terminaison public ne nécessite aucune clé. Faites correspondre ses entrées par identifiant d'opération et lisez le tarif et l'unité de facturation actuels ; ne supposez pas que chaque opération coûte la même chose et ne figez pas un tarif issu d'un exemple dans votre application.
| Identifiant d'opération | Unité de facturation |
|---|---|
web.search, web.read, chat | Requête |
x.user.info, x.user.search, x.user.tweets, x.tweet.search, x.tweet.replies | Résultat retourné |
ppt.generate | Page générée |
ppt.export | Requête d'export |
ppt.generate.status, ppt.generate.historical, ppt.export.status, ppt.delete | Aucun nouveau frais |
Une requête de statut gratuite ne rend pas la génération ou l'export sous-jacent gratuits. Pour X, la pagination et les enregistrements retournés imbriqués peuvent augmenter l'utilisation facturable.
Solde et réservations
Avant l'exécution, le service peut réserver suffisamment de solde pour l'opération. Un travail réussi est régularisé sur cette réservation ; un échec confirmé la libère. Pour les tâches asynchrones, le renvoi d'un ID ne signifie pas que la facturation est déjà définitive.
La tarification des pages PPT réserve dix pages à la création. La génération réussie régularise la production réelle et libère les fonds inutilisés. La génération et l'export sont des frais séparés. Consultez le workflow PPT pour le comportement de réexport répété.
Si l'exécution ou la régularisation est incertaine, une réservation peut rester en attente pendant que le service la rapproche. Ne considérez pas chaque délai d'attente ou 5xx comme la preuve qu'aucun travail n'a eu lieu ou qu'une requête répétée est gratuite.
Consultez votre solde disponible et votre utilisation dans Console Billing. Pour les conseils de recharge au niveau du compte, consultez Billing and Credits.
Interroger l'utilisation du portefeuille via l'API
Les propriétaires de compte peuvent inspecter les enregistrements d'appels du portefeuille à l'aide d'un jeton de connexion Felo. Cet identifiant est différent de la clé API utilisée pour les appels Data API ; ne le remplacez pas par FELO_API_KEY.
curl -sS 'https://openapi.felo.ai/api/wallet/usage?call_type=data' \
-H 'Authorization: Bearer YOUR_FELO_LOGIN_TOKEN'Les enregistrements se trouvent sous data.items ; call_type=data filtre les appels de capacité. Comparez l'utilisation avec les prix actuels du compte. La lecture des enregistrements ne soumet pas une autre tâche de génération. Console Billing reste disponible pour la consultation du compte et les recharges.
Lire les erreurs de manière défensive
Vérifiez d'abord le statut HTTP. Les erreurs peuvent utiliser l'une ou l'autre de ces formes ; les valeurs ci-dessous sont illustratives :
{"error":{"code":"invalid_parameter","message":"Check the request fields"},"request_id":"example-request-id"}{"status":402,"code":"INSUFFICIENT_BALANCE","message":"Insufficient balance","request_id":"example-request-id"}Lisez error.code / error.message lorsqu'ils sont présents, sinon code / message. Conservez request_id lorsqu'il est renvoyé. Les réponses réussies varient selon l'opération ; ne les forcez pas toutes dans la même enveloppe d'erreur ou data.
Décider de la suite
| Statut HTTP | Cause fréquente | Étape suivante |
|---|---|---|
| 400 | Paramètre manquant ou invalide | Corrigez la requête avant de réessayer |
| 401 | Clé manquante, invalide, révoquée ou expirée | Vérifiez la clé et l'en-tête d'authentification |
| 402 | Solde de plateforme insuffisant | Vérifiez le solde disponible et les réservations en attente ; rechargez si nécessaire |
| 404 | Ressource manquante ou inaccessible à ce compte | Vérifiez l'ID et le compte créateur |
| 409 | L'opération entre en conflit avec l'état actuel de la tâche, ou l'exécution n'est pas confirmée | Lisez le code d'erreur et interrogez la tâche existante ; ne la dupliquez pas immédiatement |
| 410 | Ressource expirée ou supprimée | Utilisez un fichier enregistré ; créez une nouvelle tâche seulement si nécessaire |
| 429 | Limite de débit ou quota de clé API dépassé | Inspectez les informations de réinitialisation ; ralentissez ou attendez la réinitialisation du quota |
| 502 / 503 / 504 | Échec amont, de disponibilité, de délai d'attente ou de régularisation | Vérifiez si le travail existe déjà avant de réessayer une opération payante |
execution_unconfirmed (409) et billing_settlement_pending (503) exigent une attention particulière : ne soumettez pas immédiatement de nouveau travail payant. Interrogez les tâches connues ou contactez le support avec l'ID de requête. Un statut HTTP réussi avec un résultat vide est différent d'une réponse d'erreur.
Réessayer sans créer de travail en double
- Pour les requêtes en lecture seule de tâche et de statut d'export, utilisez un backoff borné et respectez
Retry-Afterlorsqu'il est présent. - Pour une requête de création échouée avec un
task_idenregistré, interrogez cette tâche avant d'en créer une autre. - Si la connexion a échoué avant que vous receviez un ID, le résultat peut être inconnu. Ne supposez pas qu'un renvoi dédupliquera la requête.
- Pour 429, distinguez une limitation de débit courte d'une fenêtre de quota de clé API ; réessayer à répétition ne réinitialise pas le quota.
- Arrêtez les nouvelles tentatives après une échéance configurée et affichez une erreur exploitable au client.
Pour le support, fournissez le point de terminaison, l'heure approximative, le statut HTTP et l'ID de requête. N'incluez jamais la clé API complète.