Μονάδες και χρήση
Οι χρεώσιμες υπηρεσίες εκκαθαρίζονται με πιστώσεις λογαριασμού. Τα ποσά δίνονται σε μιλλιπιστώσεις (millicredits); 1000 μιλλιπιστώσεις ισούνται με 1 πίστωση. Τα ποσά που αποστέλλετε στις αιτήσεις πρέπει να είναι ακέραιοι· τα ποσά στους υπολογισμούς και στις καταχωρήσεις μπορεί να φέρουν ένα δεκαδικό ψηφίο (0,1 μιλλιπιστώσεις). Το credit_precision στις απαντήσεις είναι 4, δηλαδή το πολύ 4 δεκαδικά ψηφία μετά τη μετατροπή σε πίστωση.
Ελέγξτε το υπόλοιπο
Section titled “Ελέγξτε το υπόλοιπο”GET /api/v1/billing/credits/balancecurl https://omnidoc.top/api/v1/billing/credits/balance \ -H "X-API-Key: $OMNIDOC_API_KEY"Βασικά πεδία:
| Πεδίο | Σημασία |
|---|---|
available | Χιλιοκρεδίτες διαθέσιμοι τώρα, μετά την οφειλή· αρνητικοί όταν υπάρχει οφειλή |
debt | Χρέος σε μιλλικρεντ: το μέρος του πραγματικού κόστους των ολοκληρωμένων εργασιών που υπερέβη το υπόλοιπο. Τα κρεντ που λαμβάνονται αργότερα (επαναφόρτιση, ημερήσιες επιχορηγήσεις, κωδικοί εξαργύρωσης, επιστροφές χρημάτων κ.λπ.) εξοφλούν πρώτα το χρέος |
spent | Συνολικά εξοφληθέντα μιλλικρεντ |
expired | Χιλιοστά πίστωσης που έληξαν ή αποσύρθηκαν |
today_charged | Χιλιοκρεδίτες εξοφλήθηκαν σήμερα |
lots | Πιστωτικά λοτ που είναι αυτή τη στιγμή έγκυρα και η ημερομηνία λήξης τους |
Πακέτα πιστώσεων
Section titled “Πακέτα πιστώσεων”GET /api/v1/billing/credits/plansΜια δημόσια διεύθυνση IP που δεν απαιτεί σύνδεση και επιστρέφει τις προσφορές πακέτων (purchase_plans, με κλειδί τον κωδικό προγράμματος). Προς πώληση τώρα:
| Κωδικός σχεδίου | Πίστωση | Τιμή | Μπόνους |
|---|---|---|---|
credits_3000_v4 | 3,000 | ¥9.90 | — |
credits_10000_v4 | 10,000 | ¥29.90 | — |
credits_25000_v4 | 25,000 | ¥69 | 8% |
credits_50000_v4 (συνιστάται) | 50,000 | ¥129 | 16% |
credits_125000_v4 | 125,000 | ¥299 | 25% |
credits_450000_v4 | 450,000 | ¥999 | 35% |
- Το «Bonus» υπολογίζεται με βάση την τιμή των 10.000 πιστώσεων για 29,90 ¥ και αντιστοιχεί στο πεδίο
bonus_percent; η συνιστώμενη συσκευασία έχειrecommended: true. Κανένα από τα δύο πεδία δεν εμφανίζεται όταν δεν έχει οριστεί. - Το
price_fen(σε φέν, 1/100 γιουάν) είναι το αρχικό νόμισμα για τις τιμές, και τοtotal_millicredits(μιλλικρεντ) για τα κρεντ. Τα αγορασμένα κρεντ δεν λήγουν· τα πακέτα μπορούν να αγοραστούν ξανά και παραδίδονται όλα μαζί κάθε φορά.
Κύκλος φόρτισης
Section titled “Κύκλος φόρτισης”- Το υπόλοιπο ελέγχεται σε σχέση με ένα όριο πριν ξεκινήσει μια εργασία : το υπόλοιπο (μετά το χρέος) πρέπει να είναι πάνω από το όριο της εργασίας, για παράδειγμα «σελίδες × 2 πιστώσεις» για τη μετάφραση PDF, το μήκος του πηγαίου κειμένου για άλλα αρχεία (τουλάχιστον 2 πιστώσεις), και για ήχο, βίντεο και λόγο το κόστος που υπολογίζεται από τη διάρκεια ή τους χαρακτήρες που μέτρησε ο διακομιστής (τιμές σε ήχος, βίντεο και φωνές ). Με μια προθήκη API που έχει προϋπολογισμό, το υπόλοιπο προϋπολογισμού της προθήκης πρέπει επίσης να είναι πάνω από το όριο. Διαφορετικά η απόκριση είναι
402(μια εργασία μετάφρασης αρχείου τερματίζεται ως αστοχία μεquota_exceeded=true, μια εργασία πολυμέσων τερματίζεται μεerror_code=insufficient_credits) και δεν χρεώνεται τίποτα. Η έναρξη μιας εργασίας δεν αλλάζει το υπόλοιπο. - Η πραγματική χρήση χρεώνεται όταν ολοκληρωθεί : η μετάφραση αρχείων (συμπεριλαμβανομένων εικόνων), ομαδοποιημένος πλούσιος κείμενος, λειτουργίες εγγράφων, ήχος, βίντεο και ομιλία χρεώνονται πλήρως για την πραγματική χρήση κατά την ολοκλήρωση. Ο προϋπολογισμός μιας κλειδιού API συμμετέχει μόνο στον έλεγχο πριν την έναρξη και δεν μειώνει ποτέ τη χρέωση για μια ολοκληρωμένη εργασία· εάν αυτό οδηγήσει τον χρησιμοποιημένο προϋπολογισμό του κλειδιού πάνω από το όριό του, το κλειδί δεν μπορεί να ξεκινήσει νέες εργασίες μέχρι να αυξηθεί το όριο. Δεν χρεώνονται οι αποτυχημένες ή ακυρωμένες εργασίες.
- Το υπόλοιπο μπορεί να γίνει αρνητικό : το μέρος του πραγματικού κόστους που υπερβαίνει το υπόλοιπο καταχωρείται ως χρέος και το υπόλοιπο εμφανίζεται ως αρνητικό· οι πίστωσεις που λαμβάνονται αργότερα εξοφλούν πρώτα το χρέος. Δεν μπορούν να ξεκινήσουν νέες εργασίες όσο το υπόλοιπο είναι αρνητικό· αναπληρώστε.
Οι πελάτες δεν υποβάλλουν ποτέ την ερώτηση «πόσο θα πρέπει να χρεωθεί»· ο διακομιστής υπολογίζει το τελικό ποσό με βάση το περιεχόμενο που παραδόθηκε.
Λειτουργίες και καταχωρήσεις
Section titled “Λειτουργίες και καταχωρήσεις”GET /api/v1/billing/credits/operations?limit=20GET /api/v1/billing/credits/operations/{operation_id}GET /api/v1/billing/credits/jobs/{job_id}Ένα αρχείο περιέχει τον αριθμό αναγνώρισης της επιχείρησης, την κατάσταση, τη βάση χρέωσης, καθώς και τα ποσά που χρεώθηκαν και επιστράφηκαν. Με την προσθήκη μιας κλειδαριάς API, οι επιχειρήσεις περιλαμβάνουν μόνο εκείνες που ξεκινήθηκαν με αυτήν την κλειδαριά.
GET /api/v1/usage?limit=50GET /api/v1/usage/summaryΟι κορυφές χρήσης επιστρέφουν τον αριθμό αρχείων, τους χαρακτήρες, τα διακριτικά στοιχεία και τον χρόνο επεξεργασίας του λογαριασμού.
Οι αναζητήσεις είναι δωρεάν
Section titled “Οι αναζητήσεις είναι δωρεάν”Η ελέγχους της υπόλοιπο, της κατάστασης εργασίας, της χρήσης, των αρχείων διακανονισμού, των λιστών αποτελεσμάτων και των διευθύνσεων λήψης δεν κοστίζουν πιστώσεις.