Πώς λειτουργεί

Η μορφή καθορίζεται από τη διαδρομή του αιτήματος και όχι από το μοντέλο. Μπορείτε να καλέσετε το ίδιο μοντέλο Claude μέσω OpenAI Chat, OpenAI Responses ή Anthropic Messages — η απάντηση θα επιστραφεί στη μορφή της διαδρομής που καλέσατε.

• Πριν από την αποστολή ενός νέου αιτήματος κειμένου, το Ailoot δεσμεύει το εκτιμώμενο κόστος της εισόδου και μιας τυπικής απάντησης, λαμβάνοντας υπόψη το όριο (max_tokens) και τους όρους του συγκεκριμένου μοντέλου. Αν η δέσμευση υπερβαίνει το διαθέσιμο υπόλοιπο ή το όριο του κλειδιού, το όριο απάντησης που αποστέλλεται μπορεί να μειωθεί μόνο αν το συγκεκριμένο μοντέλο και η συγκεκριμένη μέθοδος πράγματι το τηρούν, χωρίς να παραβιάζονται ούτε το κατώτατο όριο των 256 tokens ούτε το καθορισμένο ελάχιστο όριο απάντησης. Για παραγόμενες εικόνες, βίντεο και ήχο, εξακολουθεί να δεσμεύεται ολόκληρο το κόστος του αποτελέσματος.
• Μετά την απάντηση — μία χρέωση βάσει της πραγματικής χρήσης. Η αχρησιμοποίητη δέσμευση επιστρέφεται αμέσως στο υπόλοιπο.
• Αν η απάντηση κοστίσει περισσότερο από τη δέσμευση, η διαφορά καλύπτεται από το διαθέσιμο υπόλοιπο. Το υπόλοιπο δεν γίνεται ποτέ αρνητικό.
• Αν τα χρήματα δεν επαρκούν ούτε για την ελάχιστη δέσμευση, το αίτημα δεν αποστέλλεται: λαμβάνετε κατανοητό σφάλμα 402 και δεν χρεώνεται τίποτα.
• Σφάλμα χωρίς αποτέλεσμα δεν χρεώνεται.

Λεπτομέρειες και παράδειγμα υπολογισμού βρίσκονται στη σελίδα Δέσμευση και χρέωση.

Κάθε απάντηση αποκτά αναγνωριστικό αιτήματος: στην κεφαλίδα X-Request-ID και στο κείμενο του σφάλματος. Τα σφάλματα επιστρέφονται σε JSON της μορφής που καλέσατε, οπότε τα SDK τα αναγνωρίζουν σωστά. Αν κάτι πάει στραβά, στείλτε το Request ID στην υποστήριξη — έτσι θα βρούμε το αίτημα σε ένα λεπτό.

{
  "code": "API_KEY_REQUIRED",
  "error": {
    "code": "invalid_api_key",
    "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer <key>\". Request ID: 3b28d3de-5b02-4d07-9f3c-4b9a7d0e68d6.",
    "param": null,
    "reason": "invalid_api_key",
    "request_id": "3b28d3de-5b02-4d07-9f3c-4b9a7d0e68d6",
    "type": "invalid_request_error"
  },
  "message": "No API key was sent with the request. Nothing was charged. …"
}

Οι απαντήσεις σε ροή (stream: true) μεταδίδονται ως Server-Sent Events. Το Ailoot παραδίδει τη χρεώσιμη απάντηση κειμένου μετά τον υπολογισμό του κόστους. Επομένως, με stream: true η μορφή παραμένει ροή (SSE), αλλά το κείμενο φτάνει σε ένα ενιαίο τμήμα όταν ολοκληρώσει το μοντέλο, και όχι λέξη προς λέξη. Αν η προετοιμασία της απάντησης διαρκεί περισσότερο από περίπου 15 δευτερόλεπτα, οι ροές Chat Completions, Responses και Messages στέλνουν πρώτα βοηθητικές γραμμές : ping (περίπου κάθε 10 δευτερόλεπτα), έπειτα τη γραμμή : ailoot-charged-usd … με το ποσό χρέωσης και, στη συνέχεια, τα ίδια τα δεδομένα. Τα SDK παραλείπουν αυτές τις γραμμές σχολίων.

Στη μορφή Gemini δεν υπάρχουν βοηθητικές γραμμές: η απάντηση :streamGenerateContent φτάνει ολόκληρη μετά τον υπολογισμό. Για τα μοντέλα συλλογισμού, αφήστε περιθώριο στο χρονικό όριο του πελάτη: μερικά λεπτά είναι φυσιολογικά.

X-Request-ID επιστρέφεται σε κάθε απάντηση. Το Ailoot προσθέτει τις υπόλοιπες κεφαλίδες στις πληρωμένες απαντήσεις κειμένου:

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

Αν το μοντέλο υποστηρίζει κρυφή μνήμη, ένα μεγάλο πρόθεμα που αποστέλλεται ξανά (οδηγία συστήματος, έγγραφα) μπορεί να κοστίζει λιγότερο. Οι τιμές ανάγνωσης και εγγραφής στην κρυφή μνήμη εμφανίζονται στην κάρτα του μοντέλου στον κατάλογο. Το αν θα υπάρξει εύρεση στην κρυφή μνήμη καθορίζεται από τον δημιουργό του μοντέλου· το Ailoot δεν το εγγυάται.