Mistral: Codestral 2508
Το Codestral 2508 είναι το μοντέλο κειμένου της Mistral AI για παραγωγή κώδικα και συμπλήρωση με επίγνωση των συμφραζομένων. Είναι βελτιστοποιημένο για συχνές εργασίες επεξεργαστή, όπως συμπλήρωση στο μέσο και αλλαγές πολλών γραμμών, με πλαίσιο 128 χιλ. token σύμφωνα με τον κατασκευαστή και τεκμηριωμένες λειτουργίες συνομιλίας, δομημένης εξόδου και εργαλείων.
- Ailoot Ultra · OpenAI Chat
POST /v1/chat/completionsmistralai/codestral-2508 - Ailoot Ultra · Anthropic Messages
POST /v1/messagesmistralai/codestral-2508
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το Codestral 2508 είναι το μοντέλο προγραμματισμού της Mistral AI για συχνές εργασίες συμπλήρωσης και παραγωγής που είναι ευαίσθητες στην καθυστέρηση. Λαμβάνει πηγαίο κώδικα και απαιτήσεις σε κείμενο και επιστρέφει κείμενο που μπορεί να περιέχει μια υλοποίηση, συμπλήρωση, διόρθωση ή εξήγηση. Η συγκεκριμένη έκδοση 2508 εστιάζει στο τρέχον πλαίσιο επεξεργασίας του προγραμματιστή και δεν είναι μοντέλο embeddings ούτε, από μόνη της, ολοκληρωμένος πράκτορας αποθετηρίου.
Συμπλήρωση κώδικα και ενημέρωση 2508
Ο κατασκευαστής προορίζει το Codestral για συμπλήρωση στο μέσο και επεξεργασία πολλών γραμμών. Η έκδοση περιγράφει βελτιώσεις στη συμπεριφορά συμπλήρωσης, μεταξύ των οποίων ο περιορισμός της ανεξέλεγκτης παραγωγής, καθώς και βελτιώσεις στην τήρηση οδηγιών και στις εργασίες κώδικα σε λειτουργία συνομιλίας. Πρόκειται για αλλαγές στη συγκεκριμένη έκδοση του Codestral· οι λειτουργίες ανάκτησης πληροφοριών και αυτόνομων πρακτόρων της περιβάλλουσας στοίβας προγραμματισμού ανήκουν σε ξεχωριστά κατονομαζόμενα συστατικά.
Για μια εργασία συμπλήρωσης, κρατήστε τη σχετική υπογραφή συνάρτησης, τις δηλώσεις και τα συμφραζόμενα κλήσης μαζί με τη θέση του δρομέα. Προσδιορίστε αν το επιθυμητό αποτέλεσμα είναι μόνο ο κώδικας που λείπει ή μια ολόκληρη αναθεωρημένη συνάρτηση. Ένα αίτημα για επεξεργαστή κώδικα μπορεί να ζητά σώμα βρόχου που διατηρεί τον υπάρχοντα τύπο επιστροφής, κρατά τις διπλότυπες τιμές και δεν μεταβάλλει την είσοδο του καλούντος. Το αποτέλεσμα αποκτά έτσι συγκεκριμένο σημείο εισαγωγής και καθορισμένη συμπεριφορά.
Προετοιμασία συμπλήρωσης στο μέσο
Στη διεπαφή FIM του κατασκευαστή, το prompt παρέχει κείμενο ή κώδικα προς συμπλήρωση και ένα προαιρετικό επίθημα παρέχει το υλικό μετά το κενό. Όταν παρέχονται και τα δύο, το μοντέλο συμπληρώνει τον χώρο ανάμεσά τους. Χωρίς επίθημα, συνεχίζει από το prompt. Αυτό διαφέρει από ένα συνηθισμένο αίτημα συνομιλίας που ζητά μια αλλαγή κώδικα και μια εξήγηση· κάθε τρόπος προετοιμασίας καθορίζει διαφορετικό συμβόλαιο εξόδου.
Μια χρήσιμη είσοδος για συμπλήρωση κενού περιλαμβάνει την αρχή της συνάρτησης, τον κώδικα που πρέπει να ακολουθήσει την εισαγωγή και τυχόν σχετικούς ορισμούς τύπων ή βοηθητικών συναρτήσεων. Διατηρήστε τις εσοχές και τους οριοθέτες, ώστε το επιστρεφόμενο κείμενο να μπορεί να ενσωματωθεί στο υπάρχον απόσπασμα. Αν χρειάζεται μόνο το σώμα που λείπει, ζητήστε αυτό και όχι επανεγγραφή ολόκληρου του αρχείου. Μια ξεχωριστή ερώτηση συνομιλίας μπορεί να εξηγεί γιατί το συμπληρωμένο απόσπασμα ικανοποιεί την απαίτηση.
Η επίσημη τεκμηρίωση FIM επιτρέπει προϋπολογισμό token εξόδου και απαιτεί το prompt μαζί με αυτόν τον προϋπολογισμό να παραμένουν μέσα στο πλαίσιο συμφραζομένων του μοντέλου. Τεκμηριώνει επίσης ακολουθίες τερματισμού και συνεχή ροή του παραγόμενου περιεχομένου. Επιλέξτε ροή συμπλήρωσης όταν το αποτέλεσμα πρέπει να ταιριάζει στο κενό του κώδικα και ροή συνομιλίας όταν η εργασία ζητά κώδικα μαζί με εξήγηση.
Συμφραζόμενα και υποστηρικτικές δυνατότητες
Η σελίδα του μοντέλου αναφέρει παράθυρο συμφραζομένων 128 χιλ. token. Χρησιμοποιήστε το για να διατηρείτε τον πηγαίο κώδικα και τις δηλώσεις που καθορίζουν την επιδιωκόμενη αλλαγή, κρατώντας παράλληλα ρητή την πραγματική εργασία επεξεργασίας. Για αίτημα διόρθωσης σφάλματος, δώστε την επηρεαζόμενη συνάρτηση, μια συγκεκριμένη είσοδο που αποτυγχάνει, το αναμενόμενο αποτέλεσμα και το σφάλμα ή την παρατηρούμενη συμπεριφορά. Ζητήστε την προτεινόμενη διόρθωση χωριστά από την εξήγηση και τα παραδείγματά της.
Η σελίδα αναφέρει επίσης δομημένες εξόδους, κλήση συναρτήσεων, προβλεπόμενες εξόδους, απαντήσεις σε ερωτήσεις εγγράφων, προθέματα απάντησης και ομαδική επεξεργασία, μαζί με τις δυνατότητες συνομιλίας και FIM. Για ένα δομημένο αποτέλεσμα ελέγχου κώδικα, ορίστε πεδία όπως το επηρεαζόμενο σύμβολο, η παρατηρούμενη ασυμφωνία, η προτεινόμενη αλλαγή και η παραδοχή που χρειάζεται ακόμη διευκρίνιση. Οι οδηγίες της Mistral για δομημένη έξοδο διακρίνουν τη λειτουργία JSON από ένα προσαρμοσμένο σχήμα, με την επιθυμητή μορφή JSON να δηλώνεται στο prompt.
Οι προβλεπόμενες έξοδοι προορίζονται για περιεχόμενο όπου σημαντικά μέρη της απάντησης είναι ήδη γνωστά. Μπορούν να χρησιμοποιηθούν κατά την αναδημιουργία εγγράφου ή αρχείου κώδικα με περιορισμένη αλλαγή, διατηρώντας το υπόλοιπο περιεχόμενο. Ορίστε την ακριβή αλλαγή και το υλικό που πρέπει να παραμείνει. Αντίθετα, ένα πρόθεμα απάντησης δίνει μια γνωστή αρχή από την οποία συνεχίζεται η παραγωγή· διαφέρει τόσο από ένα γνωστό πλήρες σώμα όσο και από ένα επίθημα FIM.
Μια ερώτηση τεκμηρίωσης μπορεί να χρησιμοποιήσει τη ροή επεξεργασίας εγγράφων του κατασκευαστή για την προετοιμασία κειμένου και δομής με OCR πριν από την ανάλυση του γλωσσικού μοντέλου. Για προγραμματιστικό υλικό που είναι ήδη διαθέσιμο ως κείμενο, δώστε τα σχετικά αποσπάσματα τεκμηρίωσης και ρωτήστε ποια προϋπόθεση διέπει την υλοποίηση. Κρατήστε κάθε εξαγόμενη απαίτηση συνδεδεμένη με την ενότητα πηγής της, ώστε ο παραγόμενος κώδικας ή η εξήγηση να παραμένει συνδεδεμένος με την παρεχόμενη προδιαγραφή.
Εργαλεία και πρακτικά αποτελέσματα
Η κλήση συναρτήσεων επιτρέπει στην εφαρμογή να παρέχει περιγεγραμμένες λειτουργίες και τις παραμέτρους τους. Το μοντέλο προετοιμάζει μια κλήση, η εφαρμογή την εκτελεί και το επιστρεφόμενο αποτέλεσμα γίνεται πλαίσιο για την επόμενη απάντηση. Ένας βοηθός κώδικα μπορεί να λάβει αποτέλεσμα αναζήτησης ή υπολογισμού μέσα από αυτόν τον κύκλο, αλλά η μεταγλώττιση, οι δοκιμές ή η εφαρμογή μιας προτεινόμενης αλλαγής εξακολουθούν να απαιτούν το περιβάλλον ανάπτυξης.
Για μια πρακτική διόρθωση, ορίστε τη δημόσια διεπαφή που πρέπει να παραμείνει συμβατή και ζητήστε το αναθεωρημένο απόσπασμα, μια συνοπτική εξήγηση και παραδείγματα εισόδων με αναμενόμενες εξόδους. Για μια παραγόμενη συνάρτηση, δηλώστε τους αποδεκτούς τύπους και τις οριακές συνθήκες. Για μια εξήγηση, δώστε την είσοδο της οποίας η εκτέλεση πρέπει να ανιχνευθεί, ώστε η απάντηση να συνδέει μια συγκεκριμένη διαδρομή εκτέλεσης με την επιστρεφόμενη τιμή.
Το Codestral παράγει κείμενο. Δεν κληρονομεί διανύσματα αναζήτησης κώδικα από το Codestral Embed, αυτοματοποίηση αποθετηρίου από το Devstral ή παραγωγή εικόνας από κάποιο οπτικό μοντέλο. Η συγκεκριμένη σελίδα του μοντέλου 2508 δεν δημοσιεύει πλήθος παραμέτρων ή αυτοτελές μέγιστο μήκος απάντησης που θα μπορούσε να δανειστεί από άλλη έκδοση. Διατηρήστε την ονομασμένη έκδοση, το πλαίσιο κώδικα και το απαιτούμενο παραδοτέο όταν προετοιμάζετε μια επαναλήψιμη ροή επεξεργαστή ή συνομιλίας.
Πρακτική εργασία
Πρακτική εργασία
Τεχνικό παράδειγμα στα αγγλικά
Fill a nonmutating loop body
Complete only the missing body in this Python function: 'def doubled(values):
result = []
# missing body
return result'. It must append twice every input value, preserve order and duplicate values, and leave values unchanged. Return the indented insertion followed by assert tests for [2, 2, -1] and []. This is a chat completion request, not a FIM transport request.Αναμενόμενο αποτέλεσμα
Only the missing indented loop body, then two tests verifying [4, 4, -2] and an empty result.Έλεγχος αποτελέσματος
The insertion fits before return result and never deduplicates or mutates the input.Ailoot Ultra · OpenAI Chat POST /v1/chat/completions mistralai/codestral-2508
mistralai/codestral-2508Εισαγωγή
Το Codestral 2508 είναι το μοντέλο κειμένου της Mistral AI για παραγωγή κώδικα και συμπλήρωση με επίγνωση των συμφραζομένων. Είναι βελτιστοποιημένο για συχνές εργασίες επεξεργαστή, όπως συμπλήρωση στο μέσο και αλλαγές πολλών γραμμών, με πλαίσιο 128 χιλ. token σύμφωνα με τον κατασκευαστή και τεκμηριωμένες λειτουργίες συνομιλίας, δομημένης εξόδου και εργαλείων.
- Αποδεκτές είσοδοι
- Κείμενο
- Αποτελέσματα
- Κείμενο
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · OpenAI Chat POST /v1/chat/completions
- Είσοδος
text- Έξοδος
text- Μορφή εξόδου
- json ή SSE
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια mistralai/codestral-2508 | Προεπιλογή— |
Πεδίοmessages | Τύποςmessage[] | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Ελάχιστο πλήθος στοιχείων: 1 | Προεπιλογή— |
Πεδίοmessages[].role | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Παραδείγματα: system, user, assistant, tool, function Συνθήκες: Αυτοί οι ρόλοι αναπαρίστανται ρητά από τους τύπους συμβατότητας του πηγαίου κώδικα· το ακριβές σύνολο ρόλων παραμένει ειδικό για κάθε μοντέλο. Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοmessages[].content | Τύποςstring|content_part[]|null | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοmessages[].tool_calls | Τύποςtool_call[] | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοmessages[].tool_call_id | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εφαρμόζεται όταν: role=tool· χρησιμοποιήστε το πραγματικό ID που επιστράφηκε | Προεπιλογή— |
Πεδίοmessages[].name | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοmessages[].reasoning_content | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εφαρμόζεται όταν: Επαναποστείλετε το πραγματικό περιεχόμενο συλλογιστικής που επιστράφηκε, όταν το μοντέλο το χρησιμοποιεί | Προεπιλογή— |
Πεδίοmessages[].reasoning_details | Τύποςobject|array | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοmax_tokens | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο: 1 Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοmax_completion_tokens | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο: 1 Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοstream | Τύποςboolean | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογήfalse |
Πεδίοstream_options.include_usage | Τύποςboolean | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοtemperature | Τύποςnumber | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοtop_p | Τύποςnumber | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοstop | Τύποςstring|string[] | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοtools | Τύποςfunction_tool[] | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοtools[].type | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια function Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοtools[].function.name | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Εφαρμόζεται όταν: Παρεχόμενο εργαλείο τύπου συνάρτησης | Προεπιλογή— |
Πεδίοtools[].function.description | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοtools[].function.parameters | ΤύποςJSON_schema | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοtool_choice | Τύποςstring|object | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοparallel_tool_calls | Τύποςboolean | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοresponse_format | Τύποςobject | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοreasoning_effort | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοreasoning | Τύποςobject | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοservice_tier | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοinstructions | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Πεδίο συμβατότητας | Προεπιλογή— |
Πεδίοfunctions | Τύποςfunction[] | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοfunction_call | Τύποςstring|object | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοprompt_cache_options | Τύποςobject | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοmodalities | Τύποςstring[] | ΑπαίτησηΠροαιρετικό | Τιμές και όρια text | Προεπιλογή— |
Πεδίοprovider | Τύποςobject | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Συνθήκες: Το provider.options απορρίπτεται σε αυτή τη διαδρομή κειμένου Ultra | Προεπιλογή— |
Πεδίοcache_control.ttl | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Συνθήκες: Το 1h απορρίπτεται στα πραγματικά πεδία κρυφής μνήμης προτροπών | Προεπιλογή— |
Συνδυασμοί υλικών εισόδου
Κείμενο · Κείμενο UTF8
messages[].content
Παράμετροι και κύκλος ζωής μεθόδου
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςcontent_type | Σύμβασηapplication/json |
Παράμετροςrequired | Σύμβασηmodel, messages |
Παράμετροςmaterial_types | Σύμβασηtext |
Παράμετροςmessages | ΣύμβασηΠίνακας μηνυμάτων με δομή role/content |
Παράμετροςfile_material | Σύμβασηπραγματικό έγγραφο UTF-8 που εισάγεται ως αυτούσιο κείμενο· δεν συνάγεται ID αρχείου |
Παράμετροςoptional_controls | Σύμβασηstream, temperature, top_p, stop, max_tokens, max_completion_tokens, reasoning, response_format, tools, tool_choice |
Παράμετροςcontrol_scope | Σύμβασηεξαρτάται από το μοντέλο· τα εργαλεία συναρτήσεων του χρήστη διαφέρουν από τα φιλοξενούμενα εργαλεία |
Παράμετροςoutput_modalities | Σύμβασηtext |
Παράμετροςhosted_operations | Σύμβασηfalse |
Παράμετροςmultimodal_input_binding | Σύμβασηnull |
Κύκλος ζωής: synchronous_or_streamed
Στείλτε το ακριβές ID μοντέλου μαζί με το messages.
Το μήκος συμφραζομένων δεν είναι ανώτατο όριο εξόδου.
Ένα αρχείο κειμένου μπορεί να παρέχει αυτούσιο κείμενο· οι είσοδοι εικόνας/ήχου/αντικειμένων αρχείων χρειάζονται ακριβή αντιστοίχιση.
Τιμολόγηση
Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο.
- Γρήγορη λειτουργία
- Τυπική χρέωση Όταν επιλέγεται η γρήγορη λειτουργία
- Λειτουργία flex
- Τυπική χρέωση Όταν επιλέγεται η λειτουργία flex
- Μέγιστη προσπάθεια συλλογισμού
- Τυπική χρέωση Όταν η μέγιστη προσπάθεια συλλογισμού χρησιμοποιεί την προσαρμογή default
Χρεώσεις Ailoot
Τιμές ανά διαμόρφωση
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Πίνακας χρεώσεων | Token συμφραζομένων, πάνω από | Token συμφραζομένων, έως και | Χρέωση |
|---|---|---|---|---|
| ΔιαμόρφωσηΒασικές χρεώσεις ανά token | Πίνακας χρεώσεωνΒασική χρέωση | Token συμφραζομένων, πάνω από— | Token συμφραζομένων, έως καιΧωρίς ανώτατο όριο | Χρέωση Είσοδος · Token εισόδου $0.0006 / 1K token Έξοδος · Token εξόδου $0.0018 / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη $0.00006 / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα — / 1K token |
| ΔιαμόρφωσηΕπίπεδο 1 βάσει μήκους αιτήματος | Πίνακας χρεώσεων— | Token συμφραζομένων, πάνω από0 | Token συμφραζομένων, έως καιΧωρίς ανώτατο όριο | Χρέωση Είσοδος · Token εισόδου $0.0006 / 1K token Έξοδος · Token εξόδου $0.0018 / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη $0.00006 / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα — / 1K token |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Παραδείγματα αιτημάτων
Ailoot Ultra · OpenAI Chat
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "mistralai/codestral-2508", "messages": [{"role": "user", "content": "Explain the difference between an observation and a hypothesis in three sentences."}]}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path("result.json").read_text())
for x in r.get("choices",[]):
if x.get("message",{}).get("content"): print(x["message"]["content"])
PY_RESULT
from openai import OpenAI
import os
if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")
client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.chat.completions.create(model='mistralai/codestral-2508',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}])
import base64, json
from pathlib import Path
def save_result(data, stem="result"):
# Keep every field, including usage, IDs, reasoning and tool requests.
Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")
print(json.dumps(data, ensure_ascii=False, indent=2))
def save_blob(encoded, suffix, label):
raw = base64.b64decode(encoded, altchars=b"-_", validate=True)
ext = "png" if raw.startswith(b"\x89PNG\r\n\x1a\n") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix
file = Path(stem + "-" + label + "." + ext)
file.write_bytes(raw)
print("Saved", file)
for index, block in enumerate(data.get("content") or []):
print("Content", index, json.dumps(block, ensure_ascii=False))
for choice in data.get("choices") or []:
print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))
for index, item in enumerate(data.get("output") or []):
print("Output", index, json.dumps(item, ensure_ascii=False))
if item.get("type") == "image_generation_call" and item.get("result"):
save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))
for ci, candidate in enumerate(data.get("candidates") or []):
for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):
print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))
blob = part.get("inlineData") or part.get("inline_data")
if blob and blob.get("data"):
mime = blob.get("mimeType") or blob.get("mime_type")
suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")
save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))
save_result(result.to_dict(mode="json"))
from openai import OpenAI
import os
from pathlib import Path
if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")
client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
import base64, json
from pathlib import Path
def save_result(data, stem="result"):
# Keep every field, including usage, IDs, reasoning and tool requests.
Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")
print(json.dumps(data, ensure_ascii=False, indent=2))
def save_blob(encoded, suffix, label):
raw = base64.b64decode(encoded, altchars=b"-_", validate=True)
ext = "png" if raw.startswith(b"\x89PNG\r\n\x1a\n") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix
file = Path(stem + "-" + label + "." + ext)
file.write_bytes(raw)
print("Saved", file)
for index, block in enumerate(data.get("content") or []):
print("Content", index, json.dumps(block, ensure_ascii=False))
for choice in data.get("choices") or []:
print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))
for index, item in enumerate(data.get("output") or []):
print("Output", index, json.dumps(item, ensure_ascii=False))
if item.get("type") == "image_generation_call" and item.get("result"):
save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))
for ci, candidate in enumerate(data.get("candidates") or []):
for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):
print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))
blob = part.get("inlineData") or part.get("inline_data")
if blob and blob.get("data"):
mime = blob.get("mimeType") or blob.get("mime_type")
suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")
save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))
with client.chat.completions.stream(model='mistralai/codestral-2508',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) as stream:
with Path("stream-events.jsonl").open("w",encoding="utf-8") as log:
for event in stream:
payload=event.to_dict(mode="json")
log.write(json.dumps(payload,ensure_ascii=False)+"\n"); log.flush()
print(json.dumps(payload,ensure_ascii=False))
final=stream.get_final_completion()
save_result(final.to_dict(mode="json"),"stream-result")
Λήψη και αποθήκευση αποτελεσμάτων
Ailoot Ultra · OpenAI Chat
json ή SSE
Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα
Διατηρήστε κάθε πλήρη απάντηση, αρχείο και τμήμα περιεχομένου που επιστρέφεται.
Διατηρήστε κάθε επιλογή και το περιεχόμενο/τις κλήσεις εργαλείων/το περιεχόμενο συλλογιστικής της. Στο SSE συνθέστε τις διαφορικές ενημερώσεις ανά δείκτη επιλογής/εργαλείου και κρατήστε την τελική αιτία τερματισμού και τα στοιχεία χρήσης.
Αν χρειάζεται έλεγχος της αρχικής απάντησης
Διατηρήστε τα ID αιτήματος/απάντησης και τις κεφαλίδες. Δεν παρέχεται γενικό URL ανάκτησης εργασιών κειμένου.
Πεδία απάντησης
| Πεδίο | Τύπος |
|---|---|
Πεδίοchoices[].index | Τύποςinteger |
Πεδίοchoices[].message.content | Τύποςstring|null |
Πεδίοchoices[].message.tool_calls | Τύποςtool_call[] |
Πεδίοchoices[].message.reasoning_content | Τύποςstring |
Πεδίοchoices[].message.reasoning_details | Τύποςobject|array |
Πεδίοchoices[].finish_reason | Τύποςstring|null |
Πεδίοusage | Τύποςobject |
Σφάλματα και επόμενα βήματα
| Απάντηση | Συνθήκη | Επόμενο βήμα |
|---|---|---|
Απάντηση400 · invalid_request_error | ΣυνθήκηΜη έγκυρα υποχρεωτικά πεδία, μη έγκυρη αναπαράσταση υλικού ή μη έγκυρη τιμή παραμέτρου | Επόμενο βήμαΔιορθώστε τα υποδεικνυόμενα πεδία πριν από νέο αίτημα δημιουργίας. |
Εναλλακτικά ονόματα
Εναλλακτικά ονόματα μοντέλου
Ailoot Ultra mistralai/codestral-2508
Εναλλακτικές διαδρομές μεθόδων
Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.
Σχετικά ID μοντέλων
Ailoot Ultra · Anthropic Messages POST /v1/messages mistralai/codestral-2508
mistralai/codestral-2508Εισαγωγή
Το Codestral 2508 είναι το μοντέλο κειμένου της Mistral AI για παραγωγή κώδικα και συμπλήρωση με επίγνωση των συμφραζομένων. Είναι βελτιστοποιημένο για συχνές εργασίες επεξεργαστή, όπως συμπλήρωση στο μέσο και αλλαγές πολλών γραμμών, με πλαίσιο 128 χιλ. token σύμφωνα με τον κατασκευαστή και τεκμηριωμένες λειτουργίες συνομιλίας, δομημένης εξόδου και εργαλείων.
- Αποδεκτές είσοδοι
- Κείμενο
- Αποτελέσματα
- json · sse
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Anthropic Messages POST /v1/messages
- Είσοδος
text- Έξοδος
json,sse- Μορφή εξόδου
- JSON ή SSE
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια mistralai/codestral-2508 | Προεπιλογή— |
Πεδίοmessages | Τύποςmessage[] | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοmessages[].role | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια user, assistant | Προεπιλογή— |
Πεδίοmessages[].content | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοmax_tokens | Τύποςinteger | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοstream | Τύποςboolean | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογήfalse |
Συνδυασμοί υλικών εισόδου
Κείμενο · Κείμενο UTF-8
Συμβολοσειρά messages[].content
Παράμετροι και κύκλος ζωής μεθόδου
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςcontent_type | Σύμβασηapplication/json |
Παράμετροςrequired | Σύμβασηmodel, messages, max_tokens |
Παράμετροςoptional_controls | Σύμβασηstream |
Παράμετροςmaterial_types | Σύμβασηtext |
Παράμετροςtext_file_material | ΣύμβασηΔιαβάστε το πραγματικό έγγραφο UTF-8 και τοποθετήστε το κείμενό του στην υποδεικνυόμενη συμβολοσειρά εισόδου ή περιεχομένου του μηνύματος. |
Κύκλος ζωής: synchronous_or_streamed
Τιμολόγηση
Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο.
- Γρήγορη λειτουργία
- Τυπική χρέωση Όταν επιλέγεται η γρήγορη λειτουργία
- Λειτουργία flex
- Τυπική χρέωση Όταν επιλέγεται η λειτουργία flex
- Μέγιστη προσπάθεια συλλογισμού
- Τυπική χρέωση Όταν η μέγιστη προσπάθεια συλλογισμού χρησιμοποιεί την προσαρμογή default
Χρεώσεις Ailoot
Τιμές ανά διαμόρφωση
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Πίνακας χρεώσεων | Token συμφραζομένων, πάνω από | Token συμφραζομένων, έως και | Χρέωση |
|---|---|---|---|---|
| ΔιαμόρφωσηΒασικές χρεώσεις ανά token | Πίνακας χρεώσεωνΒασική χρέωση | Token συμφραζομένων, πάνω από— | Token συμφραζομένων, έως καιΧωρίς ανώτατο όριο | Χρέωση Είσοδος · Token εισόδου $0.0006 / 1K token Έξοδος · Token εξόδου $0.0018 / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη $0.00006 / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα — / 1K token |
| ΔιαμόρφωσηΕπίπεδο 1 βάσει μήκους αιτήματος | Πίνακας χρεώσεων— | Token συμφραζομένων, πάνω από0 | Token συμφραζομένων, έως καιΧωρίς ανώτατο όριο | Χρέωση Είσοδος · Token εισόδου $0.0006 / 1K token Έξοδος · Token εξόδου $0.0018 / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη $0.00006 / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα — / 1K token |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Παραδείγματα αιτημάτων
Ailoot Ultra · Anthropic Messages
{
"model": "mistralai/codestral-2508",
"max_tokens": 128,
"messages": [
{
"role": "user",
"content": "Summarize the incident report."
}
],
"stream": false
}set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 document}"
export AILOOT_TEXT_FILE
python3 - <<'PY_REQUEST'
import json, os
from pathlib import Path
source_file = Path(os.environ['AILOOT_TEXT_FILE'])
if not source_file.is_file():
raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')
text = source_file.read_text(encoding='utf-8')
if not text.strip():
raise SystemExit('Choose a document containing text')
payload = {'model': 'mistralai/codestral-2508', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}
payload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\n\n' + text
Path('request.json').write_text(json.dumps(payload, ensure_ascii=False), encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/messages \
-H "x-api-key: $AILOOT_API_KEY" -H 'anthropic-version: 2023-06-01' -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
result = json.loads(Path('result.json').read_text(encoding='utf-8'))
print(json.dumps(result, ensure_ascii=False, indent=2))
PY_RESULT
import json, os
from pathlib import Path
source_file = Path(os.environ['AILOOT_TEXT_FILE'])
if not source_file.is_file():
raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')
text = source_file.read_text(encoding='utf-8')
if not text.strip():
raise SystemExit('Choose a document containing text')
payload = {'model': 'mistralai/codestral-2508', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}
payload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\n\n' + text
from urllib.request import Request, urlopen
from urllib.error import HTTPError
api_key = os.environ['AILOOT_API_KEY']
if not api_key.strip():
raise SystemExit('Set AILOOT_API_KEY before making a request')
headers = {'x-api-key': 'PLACEHOLDER_KEY', 'anthropic-version': '2023-06-01', 'Content-Type': 'application/json'}
headers['x-api-key'] = api_key
request = Request('https://api.ailoot.ai/v1/messages', data=json.dumps(payload, ensure_ascii=False).encode('utf-8'), headers=headers, method='POST')
try:
with urlopen(request, timeout=120) as response:
raw = response.read()
Path('response-headers.txt').write_text(str(response.headers), encoding='utf-8')
except HTTPError as error:
Path('result.json').write_bytes(error.read())
Path('response-headers.txt').write_text(str(error.headers), encoding='utf-8')
raise
Path('result.json').write_bytes(raw)
import json
from pathlib import Path
result = json.loads(Path('result.json').read_text(encoding='utf-8'))
print(json.dumps(result, ensure_ascii=False, indent=2))
Λήψη και αποθήκευση αποτελεσμάτων
Ailoot Ultra · Anthropic Messages
JSON ή SSE
Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα
Διατηρήστε κάθε πλήρη απάντηση, αρχείο και τμήμα περιεχομένου που επιστρέφεται.
Διατηρήστε όλα τα μπλοκ περιεχομένου, τις υπογραφές συλλογιστικής και τα πραγματικά ID χρήσης εργαλείων. Συνθέστε όλες τις διαφορικές ενημερώσεις μπλοκ SSE· το πρώτο μπλοκ κειμένου δεν είναι η πλήρης έξοδος.
Αν χρειάζεται έλεγχος της αρχικής απάντησης
Διατηρήστε τα ID αιτήματος/απάντησης και τις κεφαλίδες. Δεν παρέχεται γενικό URL ανάκτησης εργασιών κειμένου.
Πεδία απάντησης
| Πεδίο | Τύπος |
|---|---|
Πεδίοid | Τύποςstring |
Πεδίοmodel | Τύποςstring |
Πεδίοcontent[] | Τύποςtext|thinking|tool_use|other content block |
Πεδίοstop_reason | Τύποςstring|null |
Πεδίοusage | Τύποςobject |
Σφάλματα και επόμενα βήματα
| Απάντηση | Συνθήκη | Επόμενο βήμα |
|---|---|---|
Απάντηση400 · invalid_request_error | ΣυνθήκηΜη έγκυρα υποχρεωτικά πεδία, μη έγκυρη αναπαράσταση υλικού ή μη έγκυρη τιμή παραμέτρου | Επόμενο βήμαΔιορθώστε τα υποδεικνυόμενα πεδία πριν από νέο αίτημα δημιουργίας. |
Εναλλακτικά ονόματα
Εναλλακτικά ονόματα μοντέλου
Ailoot Ultra mistralai/codestral-2508
Εναλλακτικές διαδρομές μεθόδων
Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.
Σχετικά ID μοντέλων
FAQ · Mistral: Codestral 2508
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/chat/completions·mistralai/codestral-2508:text→textPOST /v1/messages·mistralai/codestral-2508:text→json,sse- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/chat/completions·mistralai/codestral-2508:model,messages,stream,modalities,providerPOST /v1/messages·mistralai/codestral-2508:model,messages,max_tokens,stream- Ποια όρια ισχύουν;
POST /v1/chat/completions·mistralai/codestral-2508:messages.min_items:1