Aller au contenu

Crédits et utilisation

Les services facturables sont réglés en crédits de compte. Les montants sont exprimés en millicrédits (millicredits) ; 1000 millicrédits équivalent à 1 crédit. Les montants que vous indiquez dans les requêtes doivent être des entiers ; les montants figurant dans les soldes et les enregistrements peuvent comporter une décimale (0,1 millicrédit). credit_precision dans les réponses correspond à 4, ce qui signifie au maximum 4 décimales une fois converti en crédits.

GET /api/v1/billing/credits/balance
Fenêtre de terminal
curl https://omnidoc.top/api/v1/billing/credits/balance \
-H "X-API-Key: $OMNIDOC_API_KEY"

Champs clés :

ChampSignification
availableMillicrédits disponibles maintenant, après déduction de la dette ; négatifs en cas de dette
debtDette en millicrédits : la part du coût réel des travaux achevés qui a dépassé le solde. Les crédits reçus ultérieurement (recharges, subventions quotidiennes, codes de rachat, remboursements, etc.) servent d’abord à amortir cette dette.
spentTotal de millicrédits réglé
expiredMillicrédits expirés ou retirés
today_chargedMillicrédits réglés aujourd’hui
lotsLots de crédits actuellement valides et leur date d’expiration
GET /api/v1/billing/credits/plans

Un point de terminaison public ne nécessitant aucune authentification et renvoyant les packs en promotion (purchase_plans, indexés par code de plan). En promotion dès maintenant :

Code de planCréditsPrixBonus
credits_3000_v43,000¥9.90—
credits_10000_v410,000¥29.90—
credits_25000_v425,000¥698%
credits_50000_v4 (recommandé)50,000¥12916%
credits_125000_v4125,000¥29925%
credits_450000_v4450,000¥99935%
  • Le « bonus » est calculé sur la base de 10 000 crédits au prix de 29,90 ¥ et correspond au champ bonus_percent ; le pack recommandé comporte recommended: true. Aucun de ces champs n’apparaît s’il n’est pas défini.
  • price_fen (en fen, 1/100 de yuan) sert de référence pour le prix, et total_millicredits (millicrédits) pour les crédits. Les crédits achetés n’expirent pas ; les packs peuvent être rachetés et sont livrés en une seule fois à chaque acquisition.
  1. Le solde est vérifié par rapport à un seuil avant le démarrage d’un travail : le solde (après déduction de la dette) doit être supérieur au seuil du travail, par exemple « pages × 2 crédits » pour la traduction PDF, la longueur du texte source pour les autres fichiers (au moins 2 crédits), et pour l’audio, la vidéo et la parole, le coût calculé à partir de la durée ou du nombre de caractères mesuré par le serveur (tarifs en audio, vidéo et voix ). Avec une clé API disposant d’un budget, le solde restant de la clé doit également être supérieur au seuil. Dans le cas contraire, la réponse est 402 (un travail de traduction de fichier se termine par un échec avec quota_exceeded=true, un travail multimédia se termine avec error_code=insufficient_credits) et rien n’est facturé. Le démarrage d’un travail ne modifie pas le solde.
  2. L’utilisation réelle est facturée à son achèvement : la traduction de fichiers (y compris les images), le texte enrichi par lots, les opérations sur documents, ainsi que l’audio, la vidéo et la parole sont facturés intégralement sur la base de l’utilisation réelle à leur achèvement. Le budget d’une clé API ne participe qu’à la vérification effectuée avant le démarrage et ne réduit jamais la facturation d’une tâche achevée ; si cela fait dépasser le budget utilisé de la clé sa limite, celle-ci ne peut pas lancer de nouvelles tâches tant que la limite n’est pas relevée. Les tâches échouées ou annulées ne sont pas facturées.
  3. Le solde peut devenir négatif : la partie du coût réel qui dépasse le solde est enregistrée comme une dette et le solde apparaît alors négatif ; les crédits arrivant ultérieurement servent d’abord à rembourser cette dette. Aucun nouveau travail ne peut démarrer tant que le solde est négatif ; rechargez le solde.

Les clients ne soumettent jamais la question « combien doit être facturé » ; le serveur calcule le montant définitif sur la base de ce qui a été livré.

GET /api/v1/billing/credits/operations?limit=20
GET /api/v1/billing/credits/operations/{operation_id}
GET /api/v1/billing/credits/jobs/{job_id}

Un enregistrement contient l’ID de l’opération, son statut, la base de facturation ainsi que les montants facturés et remboursés. Lorsqu’il est associé à une clé API, seules les opérations initiées par cette clé sont répertoriées.

GET /api/v1/usage?limit=50
GET /api/v1/usage/summary

Les points de terminaison d’utilisation renvoient le nombre de fichiers, le nombre de caractères, le nombre de jetons et le temps de traitement du compte.

La consultation du solde, de l’état des travaux, de l’utilisation, des relevés de règlement, des listes de résultats et des adresses de téléchargement ne consomme aucun crédit.