跳转到内容

Μονάδες και χρήση

Οι χρεώσιμες υπηρεσίες εκκαθαρίζονται με πιστώσεις λογαριασμού. Τα ποσά δίνονται σε μιλλιπιστώσεις (millicredits); 1000 μιλλιπιστώσεις ισούνται με 1 πίστωση. Τα ποσά που αποστέλλετε στις αιτήσεις πρέπει να είναι ακέραιοι· τα ποσά στους υπολογισμούς και στις καταχωρήσεις μπορεί να φέρουν ένα δεκαδικό ψηφίο (0,1 μιλλιπιστώσεις). Το credit_precision στις απαντήσεις είναι 4, δηλαδή το πολύ 4 δεκαδικά ψηφία μετά τη μετατροπή σε πίστωση.

GET /api/v1/billing/credits/balance
Terminal window
curl https://omnidoc.top/api/v1/billing/credits/balance \
-H "X-API-Key: $OMNIDOC_API_KEY"

Βασικά πεδία:

ΠεδίοΣημασία
availableΧιλιοκρεδίτες διαθέσιμοι τώρα, μετά την οφειλή· αρνητικοί όταν υπάρχει οφειλή
debtΧρέος σε μιλλικρεντ: το μέρος του πραγματικού κόστους των ολοκληρωμένων εργασιών που υπερέβη το υπόλοιπο. Τα κρεντ που λαμβάνονται αργότερα (επαναφόρτιση, ημερήσιες επιχορηγήσεις, κωδικοί εξαργύρωσης, επιστροφές χρημάτων κ.λπ.) εξοφλούν πρώτα το χρέος
spentΣυνολικά εξοφληθέντα μιλλικρεντ
expiredΧιλιοστά πίστωσης που έληξαν ή αποσύρθηκαν
today_chargedΧιλιοκρεδίτες εξοφλήθηκαν σήμερα
lotsΠιστωτικά λοτ που είναι αυτή τη στιγμή έγκυρα και η ημερομηνία λήξης τους
GET /api/v1/billing/credits/plans

Μια δημόσια διεύθυνση IP που δεν απαιτεί σύνδεση και επιστρέφει τις προσφορές πακέτων (purchase_plans, με κλειδί τον κωδικό προγράμματος). Προς πώληση τώρα:

Κωδικός σχεδίουΠίστωσηΤιμήΜπόνους
credits_3000_v43,000¥9.90—
credits_10000_v410,000¥29.90—
credits_25000_v425,000¥698%
credits_50000_v4 (συνιστάται)50,000¥12916%
credits_125000_v4125,000¥29925%
credits_450000_v4450,000¥99935%
  • Το «Bonus» υπολογίζεται με βάση την τιμή των 10.000 πιστώσεων για 29,90 ¥ και αντιστοιχεί στο πεδίο bonus_percent; η συνιστώμενη συσκευασία έχει recommended: true. Κανένα από τα δύο πεδία δεν εμφανίζεται όταν δεν έχει οριστεί.
  • Το price_fen (σε φέν, 1/100 γιουάν) είναι το αρχικό νόμισμα για τις τιμές, και το total_millicredits (μιλλικρεντ) για τα κρεντ. Τα αγορασμένα κρεντ δεν λήγουν· τα πακέτα μπορούν να αγοραστούν ξανά και παραδίδονται όλα μαζί κάθε φορά.
  1. Το υπόλοιπο ελέγχεται σε σχέση με ένα όριο πριν ξεκινήσει μια εργασία : το υπόλοιπο (μετά το χρέος) πρέπει να είναι πάνω από το όριο της εργασίας, για παράδειγμα «σελίδες × 2 πιστώσεις» για τη μετάφραση PDF, το μήκος του πηγαίου κειμένου για άλλα αρχεία (τουλάχιστον 2 πιστώσεις), και για ήχο, βίντεο και λόγο το κόστος που υπολογίζεται από τη διάρκεια ή τους χαρακτήρες που μέτρησε ο διακομιστής (τιμές σε ήχος, βίντεο και φωνές ). Με μια προθήκη API που έχει προϋπολογισμό, το υπόλοιπο προϋπολογισμού της προθήκης πρέπει επίσης να είναι πάνω από το όριο. Διαφορετικά η απόκριση είναι 402 (μια εργασία μετάφρασης αρχείου τερματίζεται ως αστοχία με quota_exceeded=true, μια εργασία πολυμέσων τερματίζεται με error_code=insufficient_credits) και δεν χρεώνεται τίποτα. Η έναρξη μιας εργασίας δεν αλλάζει το υπόλοιπο.
  2. Η πραγματική χρήση χρεώνεται όταν ολοκληρωθεί : η μετάφραση αρχείων (συμπεριλαμβανομένων εικόνων), ομαδοποιημένος πλούσιος κείμενος, λειτουργίες εγγράφων, ήχος, βίντεο και ομιλία χρεώνονται πλήρως για την πραγματική χρήση κατά την ολοκλήρωση. Ο προϋπολογισμός μιας κλειδιού API συμμετέχει μόνο στον έλεγχο πριν την έναρξη και δεν μειώνει ποτέ τη χρέωση για μια ολοκληρωμένη εργασία· εάν αυτό οδηγήσει τον χρησιμοποιημένο προϋπολογισμό του κλειδιού πάνω από το όριό του, το κλειδί δεν μπορεί να ξεκινήσει νέες εργασίες μέχρι να αυξηθεί το όριο. Δεν χρεώνονται οι αποτυχημένες ή ακυρωμένες εργασίες.
  3. Το υπόλοιπο μπορεί να γίνει αρνητικό : το μέρος του πραγματικού κόστους που υπερβαίνει το υπόλοιπο καταχωρείται ως χρέος και το υπόλοιπο εμφανίζεται ως αρνητικό· οι πίστωσεις που λαμβάνονται αργότερα εξοφλούν πρώτα το χρέος. Δεν μπορούν να ξεκινήσουν νέες εργασίες όσο το υπόλοιπο είναι αρνητικό· αναπληρώστε.

Οι πελάτες δεν υποβάλλουν ποτέ την ερώτηση «πόσο θα πρέπει να χρεωθεί»· ο διακομιστής υπολογίζει το τελικό ποσό με βάση το περιεχόμενο που παραδόθηκε.

Λειτουργίες και καταχωρήσεις

Section titled “Λειτουργίες και καταχωρήσεις”
GET /api/v1/billing/credits/operations?limit=20
GET /api/v1/billing/credits/operations/{operation_id}
GET /api/v1/billing/credits/jobs/{job_id}

Ένα αρχείο περιέχει τον αριθμό αναγνώρισης της επιχείρησης, την κατάσταση, τη βάση χρέωσης, καθώς και τα ποσά που χρεώθηκαν και επιστράφηκαν. Με την προσθήκη μιας κλειδαριάς API, οι επιχειρήσεις περιλαμβάνουν μόνο εκείνες που ξεκινήθηκαν με αυτήν την κλειδαριά.

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

Οι κορυφές χρήσης επιστρέφουν τον αριθμό αρχείων, τους χαρακτήρες, τα διακριτικά στοιχεία και τον χρόνο επεξεργασίας του λογαριασμού.

Οι αναζητήσεις είναι δωρεάν

Section titled “Οι αναζητήσεις είναι δωρεάν”

Η ελέγχους της υπόλοιπο, της κατάστασης εργασίας, της χρήσης, των αρχείων διακανονισμού, των λιστών αποτελεσμάτων και των διευθύνσεων λήψης δεν κοστίζουν πιστώσεις.