Τιμολόγηση

Κάθε μοντέλο κοστίζει ακριβώς όσο χρεώνει ο δημιουργός του, σε δολάρια ΗΠΑ. Πληρώνετε από το υπόλοιπο API, το οποίο υπολογίζεται σε πιστώσεις API: 1.000 πιστώσεις API = 1 $. Το υπόλοιπο API είναι ξεχωριστό υπόλοιπο, διαφορετικό από τις πιστώσεις των εφαρμογών Doitong. Δεν υπάρχουν προγράμματα, ελάχιστα ποσά ή χρεώσεις ανά μοντέλο: μια κλήση κοστίζει την τιμή της, η οποία αφαιρείται από το υπόλοιπο API όταν γίνει αποδεκτό το αίτημα.

Στη Ρωσία (doitong.ru, api.doitong.ru ή ?currency=rub) οι τιμές εμφανίζονται και σε ρούβλια: η τιμή USD × η ισοτιμία USD/RUB × 1,3.

Μονάδες#

Κάθε μοντέλο έχει μία μονάδα χρέωσης, η οποία εμφανίζεται στη σελίδα του και στο GET https://api.doitong.com/v1/models/{model_id}:

Τιμή = ποσότητα × πιστώσεις API ανά μονάδα, στρογγυλοποιημένη προς τα πάνω σε ακέραιες πιστώσεις API (0,001 $), ποτέ μικρότερη από 1. Οι πολύ φθηνές μονάδες μπορεί να έχουν κλασματική τιμή ανά μονάδα (0.4 πιστώσεις API ανά δευτερόλεπτο)· στρογγυλοποιείται μόνο το σύνολο της κλήσης.

Ορισμένα μοντέλα χρεώνουν διαφορετική τιμή ανάλογα με την είσοδο: το βίντεο με ήχο κοστίζει περισσότερο από το βίντεο χωρίς ήχο, το 4K περισσότερο από το 1K και ούτω καθεξής. Αυτοί οι κανόνες παρατίθενται στη σελίδα κάθε μοντέλου. Μια παράμετρος που παραλείπετε υπολογίζεται ως η τιμή προεπιλογής της, επομένως η τιμή που βλέπετε για μια είσοδο είναι η τιμή που πληρώνετε.

Ακριβείς, μετρημένες, εκτιμώμενες τιμές και τιμές βάσει χρήσης#

Κάθε τιμή έχει ένα mode:

• exact: η τιμή υπολογίζεται από την είσοδό σας (δευτερόλεπτα, εικόνες, megapixel, χαρακτήρες, βήματα ή μία σταθερή τιμή ανά βίντεο ή κλήση).
• measured: η τιμή ακολουθεί τα αρχεία που στέλνετε: τη διάρκεια ενός βίντεο ή ήχου εισόδου, το μέγεθος μιας εικόνας εισόδου, τον ρυθμό καρέ ή τον αριθμό καρέ ενός βίντεο. Τα εργαλεία αναβάθμισης, συγχρονισμού χειλιών, βίντεο-σε-βίντεο, μεταγραφής και ήχου τιμολογούνται έτσι. Πριν από την εκτέλεση το API διαβάζει τη διάρκεια, την ανάλυση και τον ρυθμό καρέ του αρχείου (το ίδιο κάνει και η προσφορά), επομένως η προσφορά είναι ακριβώς αυτό που χρεώνει η εκτέλεση. Η σελίδα του μοντέλου αναφέρει για τι πληρώνετε («Τιμή ανά δευτερόλεπτο του βίντεο εισόδου σας») και ο υπολογιστής της χρησιμοποιεί τους αριθμούς του αρχείου σας. Αρχείο που δεν μπορεί να διαβαστεί απορρίπτεται με unmeasurable_input και δεν χρεώνεται τίποτα.
• estimate: το κόστος του μοντέλου εξαρτάται από κάτι που η είσοδος δεν μπορεί να αποκαλύψει εκ των προτέρων (token, χρόνο υπολογισμού). Ένα τέτοιο μοντέλο χρεώνει σταθερή εκτιμώμενη τιμή ανά εκτέλεση (ανά εικόνα εξόδου όταν έχει αριθμό εικόνων), η οποία ορίζεται από το μέσο κόστος πραγματικών εκτελέσεων του μοντέλου. Γνωρίζετε την τιμή πριν από την εκτέλεση: η προσφορά είναι αυτό που πληρώνετε.
• metered: το μοντέλο χρεώνεται βάσει της πραγματικής χρήσης, την οποία γνωρίζει μόνο η ίδια η εκτέλεση: τα token που διαβάζει και γράφει ένα γλωσσικό μοντέλο ή μοντέλο όρασης, τα δευτερόλεπτα ομιλίας που δημιουργεί ένα μοντέλο φωνής ή ο χρόνος επεξεργασίας του μοντέλου. Δείτε την ενότητα Χρέωση βάσει χρήσης παρακάτω.

Οι σελίδες των μοντέλων αναφέρουν «Τιμή ανά εκτέλεση», «Τιμή ανά δευτερόλεπτο του βίντεο εισόδου σας» (και παρόμοια), «Εκτιμώμενη τιμή ανά εκτέλεση» ή «Χρέωση βάσει χρήσης»· τα GET https://api.doitong.com/v1/models?mode=measured, ?mode=estimate και ?mode=metered τα παραθέτουν.

Χρέωση βάσει χρήσης#

Ένα μοντέλο metered έχει τιμή χρήσης («$0.01 ανά 1000 token», «$0.002 ανά δευτερόλεπτο δημιουργημένου ήχου», «$0.00111 ανά δευτερόλεπτο χρόνου επεξεργασίας») και ένα μέγιστο ανά εκτέλεση: το μεγαλύτερο ποσό που μπορεί να κοστίσει η εκτέλεση, με βάση όσα δηλώνει το αίτημά σας (max_tokens, το μήκος του κειμένου σας, την ανάλυση, τον αριθμό εξόδων) και τα δημοσιευμένα όρια του μοντέλου. Δεν εξαρτάται ποτέ από το περιεχόμενο αρχείου πίσω από URL. Για μοντέλο που χρεώνεται βάσει χρόνου επεξεργασίας ή μήκους συνεδρίας φωνής, το μέγιστο είναι η μεγαλύτερη διάρκεια που μπορεί να εκτελεστεί ένα αίτημα (15 λεπτά για εικόνες, 30 για ήχο, 60 για βίντεο), επομένως είναι πολύ μεγαλύτερο από μια τυπική εκτέλεση. Είσοδος της οποίας το μέγιστο θα ξεπερνούσε το όριο ανά εκτέλεση του μοντέλου (πολύ μεγάλο κείμενο) απορρίπτεται με 422 invalid_input:

1. Η προσφορά επιστρέφει αυτό το μέγιστο ως credits (μαζί με hold και typical, μια συνηθισμένη εκτέλεση). Όταν ξεκινά η εκτέλεση, το μέγιστο αφαιρείται από το υπόλοιπο API και αυτό είναι το ποσό που πρέπει να καλύπτουν το υπόλοιπο και ο προϋπολογισμός του κλειδιού σας.
2. Όταν η εκτέλεση ολοκληρωθεί επιτυχώς, το αίτημα εκκαθαρίζεται σύμφωνα με τη χρήση που αναφέρει το μοντέλο: χρήση × τιμή χρήσης, στρογγυλοποιημένη προς τα πάνω σε ακέραια πίστωση API. Το υπόλοιπο του μέγιστου επιστρέφεται αυτόματα, μία φορά, ως γραμμή refund του υπολοίπου API.
3. Μια εκτέλεση δεν κοστίζει ποτέ περισσότερο από το μέγιστό της, ακόμη κι αν η χρήση της το απαιτούσε. Αποτυχημένη ή ακυρωμένη εκτέλεση επιστρέφεται πλήρως, όπως πάντα.

Οι περισσότερες εκτελέσεις κοστίζουν πολύ λιγότερο από το μέγιστο· η σελίδα του μοντέλου εμφανίζει «Έως $X ανά εκτέλεση» για την είσοδο του builder και την τυπική εκτέλεση («από» στον κατάλογο). Για τα λίγα μοντέλα που χρεώνονται βάσει χρόνου επεξεργασίας, η χρήση είναι ο χρόνος επεξεργασίας του μοντέλου (σημειωμένος ως approximate).

{
  "object": "quote",
  "credits": 621,
  "usd": "0.621",
  "mode": "metered",
  "label": "Charged by usage",
  "hold": { "credits": 621, "usd": "0.621" },
  "typical": { "credits": 10, "usd": "0.01" },
  "settlement": "usage",
  "display": "$0.01 / 1000 tokens",
  "breakdown": "up to 62.035 × 1000 tokens × $0.01"
}

Μετά την εκτέλεση, το cost του αιτήματος εμφανίζει τι κρατήθηκε και ποια ήταν η χρήση:

{
  "cost": { "credits": 621, "usd": "0.621", "charged": 621, "refunded": 611, "mode": "metered", "held": 621,
            "typical": 10, "settled": { "status": "settled", "credits": 10, "usd": "0.01", "quantity": 1,
            "unit": "1000_tokens", "unit_usd": "0.01", "source": "billed_usage", "approximate": false } }
}

Το charged − refunded είναι το κόστος της εκτέλεσης. Το settled.status είναι pending για το διάστημα μεταξύ αποτελέσματος και εκκαθάρισης και no_usage στη σπάνια περίπτωση που το μοντέλο δεν ανέφερε καθόλου χρήση (τότε το μέγιστο παραμένει η τιμή).

Προσφορά πριν από την εκτέλεση#

Το POST https://api.doitong.com/v1/quote/{model_id} δέχεται ακριβώς το σώμα που θα στέλνατε στο run και επιστρέφει την τιμή αυτής της εισόδου: την ακριβή τιμή, εκτός από μοντέλο που χρεώνεται βάσει χρήσης, όπου είναι το μέγιστο κόστος της εκτέλεσης. Δεν χρειάζεται κλειδί και δεν κοστίζει τίποτα:

curl -X POST "https://api.doitong.com/v1/quote/flux/schnell" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A lighthouse at dusk", "num_images": 2}'

{
  "object": "quote",
  "model": "flux/schnell",
  "credits": 6,
  "usd": "0.006",
  "unit": "megapixel",
  "quantity": 2,
  "unit_credits": 3,
  "mode": "exact",
  "label": "Price per run",
  "display": "$0.003 / megapixel",
  "breakdown": "2 MP (2 images) × 3 API credits",
  "input": { "prompt": "A lighthouse at dusk", "num_images": 2 },
  "warnings": []
}

Με κλειδί, η προσφορά επιστρέφει επίσης balance_credits και balance_usd (το υπόλοιπο API σας), affordable και key_budget_remaining. Προσθέστε ?currency=rub για ποσό σε rub.

Αντικείμενα τιμής#

Κάθε τιμή στο API έχει την ίδια μορφή:

• models: price: { "credits": 112, "usd": "0.112", "unit": "second", "display": "$0.112 / second", "credits_display": "112 API credits / second", "from_credits": 560, "from_usd": "0.56", "mode": "exact" } — συν rub, rub_display και from_rub στη Ρωσία ή με ?currency=rub·
• requests: cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 } (πιστώσεις API· ένα αίτημα metered προσθέτει mode, held, typical και settled, δείτε Χρέωση βάσει χρήσης)·
• account: το GET https://api.doitong.com/v1/account επιστρέφει credits (το υπόλοιπο API), balance: { "credits", "usd" } και storage (τιμή αποθήκευσης αρχείων, χρήση και μηνιαία εκτίμηση).

Επιστροφές χρημάτων#

• Ένα μη έγκυρο αίτημα (οποιοδήποτε 4xx πριν ξεκινήσει η εκτέλεση) δεν χρεώνεται ποτέ.
• Αίτημα που ολοκληρώνεται ως failed (συμπεριλαμβανομένου του timeout) επιστρέφεται πλήρως στο υπόλοιπο API, αυτόματα.
• Αίτημα που ακυρώνετε πριν ξεκινήσει επιστρέφεται πλήρως. Μόλις το μοντέλο αρχίσει να δημιουργεί, η ακύρωση είναι μόνο αίτημα: αν το μοντέλο ολοκληρώσει, το αποτέλεσμα παραδίδεται και χρεώνεται.
• Επιτυχές αίτημα metered λαμβάνει πίσω το μέρος του μέγιστου που δεν χρησιμοποίησε.

Το αντικείμενο του αιτήματος εμφανίζει όλα τα στοιχεία: cost.credits, cost.charged και cost.refunded.

Αποθήκευση αρχείων#

Τα αρχεία εξόδου διατηρούνται στην αποθήκευσή μας. Επιλέγετε, στον λογαριασμό ή ανά εκτέλεση (?storage=):

Η μόνιμη αποθήκευση χρεώνεται μία φορά την ημέρα από το υπόλοιπο API: διατηρούμενα GB × μηνιαία τιμή ÷ ημέρες του μήνα, ως γραμμές καθολικού τύπου storage. Τα κλάσματα πίστωσης API μεταφέρονται στην επόμενη ημέρα, επομένως ένας μήνας αθροίζεται ακριβώς σε GB × 100 πιστώσεις API (1 GB = 1024³ byte· 10 GB που διατηρούνται για έναν μήνα κοστίζουν 1.000 πιστώσεις API). Το υπόλοιπο δεν γίνεται ποτέ αρνητικό: όταν δεν μπορεί να πληρώσει, η συγκεκριμένη ημέρα δεν χρεώνεται, λαμβάνετε email και έχετε 30 ημέρες για φόρτιση πριν τα διατηρούμενα αρχεία γίνουν προσωρινά και διαγραφούν 7 ημέρες αργότερα. Λεπτομέρειες: Αρχεία.

Τρέχουσες τιμές#

Αυτά είναι τα επιλεγμένα μοντέλα. Όλα τα 1.496 μοντέλα και οι τιμές τους βρίσκονται στον κατάλογο μοντέλων και στο GET /models (δεν απαιτείται κλειδί).

Φόρτιση#

Προσθέστε χρήματα στο υπόλοιπο API στη διεύθυνση https://doitong.com/developers/dashboard#balance. Όταν το υπόλοιπο είναι πολύ χαμηλό, μια εκτέλεση απαντά 402 insufficient_credits με ένα top_up_url. Κάθε κλειδί API μπορεί επίσης να περιοριστεί με δικό του προϋπολογισμό σε πιστώσεις API (δείτε Έλεγχος ταυτότητας).