gemini-3-pro-preview
Το Gemini 3 Pro Preview είναι το πολυτροπικό μοντέλο συλλογιστικής της Google για κείμενο, εικόνες, ήχο, βίντεο και PDF, με έξοδο κειμένου. Το μεγάλο όριο εισόδου, οι δυνατότητες προγραμματισμού και οι υποστηριζόμενες ροές εργαλείων το καθιστούν κατάλληλο για λεπτομερή ανάλυση, σύγκριση εγγράφων και εκτέλεση εργασιών βάσει τεκμηρίων.
- Ailoot Ultra · OpenAI Chat
POST /v1/chat/completionsgemini-3-pro-preview - Ailoot Ultra · Anthropic Messages
POST /v1/messagesgemini-3-pro-preview
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το Gemini 3 Pro Preview είναι το προφίλ προεπισκόπησης Gemini 3 Pro της Google για πολυτροπική συλλογιστική και παραγωγή κειμένου. Μπορεί να επεξεργάζεται κείμενο, εικόνες, ήχο, βίντεο και έγγραφα PDF και να επιστρέφει γραπτό αποτέλεσμα. Οι προβλεπόμενες χρήσεις περιλαμβάνουν σύνθετη ανάλυση, προχωρημένο προγραμματισμό, ανάπτυξη αλγορίθμων και εργασίες που συνδυάζουν ένα εκτεταμένο σύνολο πηγών με συγκεκριμένο ερώτημα.
Μοντέλο και δομή εισόδου
Το Gemini 3 Pro είναι μοντέλο αραιού μείγματος ειδικών, βασισμένο σε transformer, με εγγενή υποστήριξη πολυτροπικής εισόδου. Η αρχιτεκτονική του δρομολογεί κάθε token μέσα από επιλεγμένο υποσύνολο ειδικών. Πρόκειται για χαρακτηριστικό σχεδιασμού του μοντέλου και όχι για ρύθμιση του χρήστη που επιλέγει έναν συγκεκριμένο ειδικό ή καθορίζει μια διαμόρφωση εξυπηρέτησης.
Προετοιμάστε τις εισόδους με βάση τις πληροφορίες που χρειάζεται η εργασία. Ένα έγγραφο, ένα στιγμιότυπο οθόνης και μια ηχογράφηση μπορούν να παρέχουν διαφορετικά τεκμήρια. Προσδιορίστε τι περιέχει κάθε αρχείο και πώς πρέπει να συμβάλει στην απάντηση. Η έξοδος παραμένει κείμενο· η κατανόηση οπτικού ή προφορικού υλικού δεν μετατρέπει αυτή την προεπισκόπηση σε γεννήτρια εικόνας, ομιλίας ή βίντεο.
Πολυτροπική ανάλυση
Χρησιμοποιήστε εικόνες για ερωτήματα σχετικά με ορατό περιεχόμενο, ήχο για προφορικές ή ακουστικές πληροφορίες και βίντεο για ακολουθίες των οποίων οι αλλαγές έχουν σημασία στον χρόνο. Συνοδεύστε το ερώτημα με το πραγματικό αρχείο, αντί να το περιγράφετε μόνο από μνήμης. Όταν συγκρίνετε πολλά αρχεία, επισημάνετέ τα καθαρά ώστε η απάντηση να μπορεί να αναφέρεται στη σωστή πηγή.
Για παράδειγμα, μια ανάθεση ανάλυσης προϊόντος μπορεί να συνδυάζει μια γραπτή προδιαγραφή, ένα στιγμιότυπο της διεπαφής και μια καταγεγραμμένη επίδειξη. Ζητήστε σύγκριση που διαχωρίζει όσα υπόσχεται η προδιαγραφή από όσα είναι ορατά ή ακούγονται στο παρεχόμενο υλικό. Ορίστε το επιθυμητό αποτέλεσμα ως ευρήματα, παρατηρήσεις που τα υποστηρίζουν και εκκρεμή ερωτήματα.
Για εργασία σε PDF, παρέχετε το έγγραφο και προσδιορίστε τις ενότητες ή τους ισχυρισμούς που θα εξεταστούν. Ένα χρήσιμο ερώτημα ζητά σύγκριση, εξαγωγή ή εξήγηση συνδεδεμένη με την πηγή, αντί να ζητά μόνο μια γενική περίληψη ενός μεγάλου αρχείου.
Μεγάλο πλαίσιο και όριο εξόδου
Η ακριβής προδιαγραφή της προεπισκόπησης αναφέρει όριο εισόδου 1.048.576 token και όριο εξόδου 65.536 token. Ο κατασκευαστής ορίζει τον Ιανουάριο του 2025 ως χρονικό όριο γνώσεων· παρέχετε νεότερα τεκμήρια όταν το ερώτημα εξαρτάται από μεταγενέστερα γεγονότα ή πληροφορίες. Πρόκειται για διαφορετικά όρια. Ένα μεγάλο σύνολο πηγών μπορεί να διαβαστεί για μια εστιασμένη απάντηση χωρίς να απαιτείται το μοντέλο να αναπαράγει κάθε τμήμα της εισόδου.
Οργανώστε το εκτεταμένο υλικό ώστε να διακρίνεται η δομή του: τίτλοι εγγράφων, όρια ενοτήτων, διαδρομές κώδικα και το ερώτημα στο οποίο πρέπει να απαντά η έξοδος. Διατηρήστε τις σχετικές εξαιρέσεις και τους ορισμούς κοντά στο περιεχόμενο που προσδιορίζουν. Αν μια εργασία χρειάζεται μεγάλη έκθεση, ορίστε τις ενότητές της και τα τεκμήρια που αναμένονται σε καθεμία.
Ένα μεγάλο παράθυρο πλαισίου δεν εγγυάται ότι κάθε λεπτομέρεια θα λάβει την ίδια προσοχή ή ότι κάθε συμπέρασμα θα είναι σωστό. Η Google αναγνωρίζει επίσης πιθανή υποβάθμιση σε συνομιλίες πολλών γύρων· επανεξετάζετε σημαντικά γεγονότα των πηγών και επαναχρησιμοποιούμενο πλαίσιο καθώς εξελίσσεται η συζήτηση. Ελέγξτε την απάντηση ως προς τα συγκεκριμένα αποσπάσματα ή αρχεία που στηρίζουν τους σημαντικούς ισχυρισμούς της.
Προγραμματισμός και ανάπτυξη αλγορίθμων
Οι προβλεπόμενες χρήσεις του παραγωγού περιλαμβάνουν προχωρημένο προγραμματισμό και αλγοριθμική εργασία. Παρέχετε τον σχετικό κώδικα, τις παραδοχές για το περιβάλλον, την παρατηρούμενη αστοχία και την αναμενόμενη συμπεριφορά. Για εργασία σε αλγόριθμο, ορίστε την είσοδο, την επιθυμητή έξοδο και συνθήκες όπως η ταξινόμηση, οι διπλότυπες εγγραφές ή τα μη έγκυρα δεδομένα.
Μια χρήσιμη ανάθεση εντοπισμού σφαλμάτων συνδυάζει την είσοδο που αποτυγχάνει και το σφάλμα με το μικρότερο σχετικό τμήμα κώδικα. Ζητήστε διάγνωση και εστιασμένη αλλαγή και, στη συνέχεια, εξετάστε αν η προτεινόμενη αλλαγή αντιμετωπίζει την αναφερθείσα συμπεριφορά. Ο παραγόμενος κώδικας και ο ισχυρισμός ότι θα πρέπει να λειτουργεί διαφέρουν από μια υλοποίηση που έχει εκτελεστεί και επαληθευτεί.
Για ένα ευρύτερο ερώτημα αποθετηρίου, αξιοποιήστε το όριο εισόδου για να παρέχετε τα απαραίτητα αρχεία με σαφείς ετικέτες διαδρομών. Δηλώστε αν το επιθυμητό παραδοτέο είναι εξήγηση, προτεινόμενη ενημέρωση κώδικα ή ανάλυση εναλλακτικών, ώστε το αποτέλεσμα να έχει συγκεκριμένο σκοπό.
Εργαλεία, πηγές και δομημένα αποτελέσματα
Η προδιαγραφή του παραγωγού για την προεπισκόπηση υποστηρίζει κλήση συναρτήσεων, εκτέλεση κώδικα, αναζήτηση αρχείων, τεκμηρίωση μέσω αναζήτησης και πλαίσιο URL. Αυτές οι δυνατότητες έχουν διακριτούς ρόλους. Μια κλήση συνάρτησης περιγράφει ενέργεια προς εκτέλεση από μια εφαρμογή· στη συνέχεια, ένα αποτέλεσμα εργαλείου παρέχει τεκμήρια για το επόμενο βήμα του μοντέλου. Η εκτέλεση κώδικα είναι ροή εργασίας εργαλείου και όχι εγγύηση ότι αυθαίρετος παραγόμενος κώδικας εφαρμογής έχει ήδη δοκιμαστεί.
Η τεκμηρίωση μέσω αναζήτησης και το πλαίσιο URL παρέχουν ροές εργασίας βασισμένες σε πηγές, ενώ η αναζήτηση αρχείων λειτουργεί με προετοιμασμένη συλλογή αρχείων. Διατηρήστε τα αποτελέσματα εργαλείων και τις συσχετίσεις πηγών μαζί με την απάντηση ώστε να μπορεί να ελεγχθεί ένα συμπέρασμα. Σύμφωνα με την προδιαγραφή του, το προφίλ δεν υποστηρίζει χρήση υπολογιστή ή τεκμηρίωση μέσω Maps.
Η υποστήριξη δομημένης εξόδου μπορεί να εκφράσει ένα αποτέλεσμα σε καθορισμένο σχήμα. Προσδιορίστε τα πεδία και τη σημασία τους πριν από την παραγωγή και ελέγξτε τόσο το περιεχόμενο όσο και τη μορφή. Ένα έγκυρο δομημένο αντικείμενο εξακολουθεί να χρειάζεται πραγματολογικό έλεγχο και έλεγχο ως προς τη συγκεκριμένη εργασία.
Συλλογιστική, επαναχρησιμοποίηση και όρια εκδόσεων
Η προεπισκόπηση υποστηρίζει λειτουργία σκέψης. Χρησιμοποιήστε σαφή εργασία, σχετικά τεκμήρια και ρητούς περιορισμούς για εργασίες που απαιτούν πολλά βήματα συλλογιστικής. Το αποτέλεσμα πρέπει να εξηγεί τις παραδοχές και το χρήσιμο συμπέρασμα· η κρυφή συλλογιστική ή η ύπαρξη λειτουργίας σκέψης δεν αποτελεί από μόνη της επαλήθευση.
Ο παραγωγός αναφέρει επίσης υποστήριξη προσωρινής αποθήκευσης και μαζικής επεξεργασίας. Πρόκειται για δυνατότητες επεξεργασίας χωριστές από τις δυνατότητες περιεχομένου του μοντέλου, και η παρουσία τους δεν αποδεικνύει ότι ένα συγκεκριμένο αίτημα αποθηκεύτηκε στην προσωρινή μνήμη ή ότι ένα μαζικό αποτέλεσμα είναι σωστό.
Διατηρήστε το Gemini 3 Pro Preview διακριτό από τα Gemini 3.1 Pro Preview, Gemini 3 Pro Image και τα προφίλ ήχου ή Live. Η έξοδος αυτής της προεπισκόπησης είναι κείμενο και η προδιαγραφή της δεν περιλαμβάνει παραγωγή εικόνας, παραγωγή ήχου ή λειτουργία Live. Αξιολογήστε την επιστρεφόμενη απάντηση, τον κώδικα ή το δομημένο αποτέλεσμα ως προς το παρεχόμενο σύνολο πηγών και την προβλεπόμενη εργασία.
Ailoot Ultra · OpenAI Chat POST /v1/chat/completions gemini-3-pro-preview
gemini-3-pro-previewΕισαγωγή
Το Gemini 3 Pro Preview είναι το πολυτροπικό μοντέλο συλλογιστικής της Google για κείμενο, εικόνες, ήχο, βίντεο και PDF, με έξοδο κειμένου. Το μεγάλο όριο εισόδου, οι δυνατότητες προγραμματισμού και οι υποστηριζόμενες ροές εργαλείων το καθιστούν κατάλληλο για λεπτομερή ανάλυση, σύγκριση εγγράφων και εκτέλεση εργασιών βάσει τεκμηρίων.
- Αποδεκτές είσοδοι
- Κείμενο
- Αποτελέσματα
- Κείμενο
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · OpenAI Chat POST /v1/chat/completions
- Είσοδος
text- Έξοδος
text- Μορφή εξόδου
- json ή SSE
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια gemini-3-pro-preview | Προεπιλογή— |
Πεδίοmessages | Τύποςmessage[] | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Ελάχιστο πλήθος στοιχείων: 1 | Προεπιλογή— |
Πεδίοmessages[].role | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοmessages[].content | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εφαρμόζεται όταν: Συνομιλία κειμένου | Προεπιλογή— |
Πεδίοstream | Τύποςboolean | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογήfalse |
Συνδυασμοί υλικών εισόδου
Κείμενο · Κείμενο UTF8
messages[].content
Παράμετροι και κύκλος ζωής μεθόδου
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςcontent_type | Σύμβασηapplication/json |
Παράμετροςrequired | Σύμβασηmodel, messages |
Παράμετροςmaterial_types | Σύμβασηtext |
Παράμετροςmessages | ΣύμβασηΠίνακας μηνυμάτων με δομή role/content |
Παράμετροςfile_material | Σύμβασηπραγματικό έγγραφο UTF-8 που εισάγεται ως αυτούσιο κείμενο· δεν συνάγεται ID αρχείου |
Παράμετροςoptional_controls | Σύμβασηstream |
Παράμετροςcontrol_scope | ΣύμβασηΣυνομιλία κειμένου· το stream είναι λογική τιμή και έχει προεπιλογή false. |
Παράμετροςoutput_modalities | Σύμβασηtext |
Παράμετροςhosted_operations | Σύμβασηfalse |
Παράμετροςmultimodal_input_binding | Σύμβασηnull |
Εναλλακτικά ονόματα μεθόδου: /chat/completions
Κύκλος ζωής: synchronous_or_streamed
Στείλτε το ακριβές ID μοντέλου μαζί με το messages.
Το μήκος συμφραζομένων δεν είναι ανώτατο όριο εξόδου.
Ένα αρχείο κειμένου μπορεί να παρέχει αυτούσιο κείμενο· οι είσοδοι εικόνας/ήχου/αντικειμένων αρχείων χρειάζονται ακριβή αντιστοίχιση.
Τιμολόγηση
Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο.
- Γρήγορη λειτουργία
- Δεν έχει οριστεί Όταν επιλέγεται η γρήγορη λειτουργία
- Λειτουργία flex
- Δεν έχει οριστεί Όταν επιλέγεται η λειτουργία flex
- Μέγιστη προσπάθεια συλλογισμού
- Δεν έχει οριστεί Όταν η μέγιστη προσπάθεια συλλογισμού χρησιμοποιεί την προσαρμογή default
- Τιμολόγηση ρητής αποθήκευσης στην κρυφή μνήμη
- Δεν είναι ενεργοποιημένο Όταν ζητείται ρητή αποθήκευση στην κρυφή μνήμη
Χρεώσεις Ailoot
Τιμές ανά διαμόρφωση
| Διαμόρφωση | Πίνακας χρεώσεων | Χρέωση |
|---|---|---|
| ΔιαμόρφωσηΒασικές χρεώσεις ανά token | Πίνακας χρεώσεωνΒασική χρέωση | Χρέωση Είσοδος · Token εισόδου $0.004 / 1K token Έξοδος · Token εξόδου $0.024 / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη $0 / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη $0 / 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":"gemini-3-pro-preview","messages":[{"role":"user","content":"hello"}],"stream":false}')
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="gemini-3-pro-preview", messages=[{"role":"user","content":"hello"}], stream=False)
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"))
Λήψη και αποθήκευση αποτελεσμάτων
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 gemini-3-pro-preview
Εναλλακτικές διαδρομές μεθόδων
/chat/completions
Σχετικά ID μοντέλων
Ailoot Ultra · Anthropic Messages POST /v1/messages gemini-3-pro-preview
gemini-3-pro-previewΕισαγωγή
Το Gemini 3 Pro Preview είναι το πολυτροπικό μοντέλο συλλογιστικής της Google για κείμενο, εικόνες, ήχο, βίντεο και PDF, με έξοδο κειμένου. Το μεγάλο όριο εισόδου, οι δυνατότητες προγραμματισμού και οι υποστηριζόμενες ροές εργαλείων το καθιστούν κατάλληλο για λεπτομερή ανάλυση, σύγκριση εγγράφων και εκτέλεση εργασιών βάσει τεκμηρίων.
- Αποδεκτές είσοδοι
- Κείμενο
- Αποτελέσματα
- json · sse
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Anthropic Messages POST /v1/messages
- Είσοδος
text- Έξοδος
json,sse- Μορφή εξόδου
- JSON ή SSE
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια gemini-3-pro-preview | Προεπιλογή— |
Πεδίο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 εισόδου $0.004 / 1K token Έξοδος · Token εξόδου $0.024 / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη $0 / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη $0 / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα — / 1K token |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Παραδείγματα αιτημάτων
Ailoot Ultra · Anthropic Messages
{
"model": "gemini-3-pro-preview",
"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': 'gemini-3-pro-preview', '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': 'gemini-3-pro-preview', '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 gemini-3-pro-preview
Εναλλακτικές διαδρομές μεθόδων
/chat/completions
Σχετικά ID μοντέλων
FAQ · gemini-3-pro-preview
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/chat/completions·gemini-3-pro-preview:text→textPOST /v1/messages·gemini-3-pro-preview:text→json,sse- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/chat/completions·gemini-3-pro-preview:model,messages,streamPOST /v1/messages·gemini-3-pro-preview:model,messages,max_tokens,stream- Ποια όρια ισχύουν;
POST /v1/chat/completions·gemini-3-pro-preview:messages.min_items:1