sora-2
Το Sora 2 δημιουργεί βίντεο με συγχρονισμένο διάλογο, ηχητικά εφέ και ήχο περιβάλλοντος από κείμενο ή εικόνα αναφοράς. Το βασικό προφίλ υποστηρίζει οπτική εξερεύνηση και κλιπ ιδεών, με χωριστές ροές του παραγωγού για επαναχρησιμοποιήσιμους μη ανθρώπινους χαρακτήρες, συνέχεια και στοχευμένες επεξεργασίες βίντεο.
- Ailoot Ultra · Chat Completions
POST /v1/chat/completionssora-2 - Ailoot Ultra · Anthropic Messages
POST /v1/messagessora-2
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το Sora 2 είναι το μοντέλο παραγωγής βίντεο και ήχου της OpenAI για δυναμικά κλιπ από γραπτή περιγραφή σκηνής ή εικόνα αναφοράς. Παράγει την οπτική ακολουθία μαζί με συγχρονισμένη ομιλία, εφέ και ήχο περιβάλλοντος. Το βασικό προφίλ Sora 2 προορίζεται για οπτική εξερεύνηση, ανάπτυξη ιδεών, πρωτότυπα και πρόχειρο μοντάζ. Το Sora 2 Pro είναι χωριστή έκδοση για μεγαλύτερη οπτική πιστότητα και τελική επεξεργασία υψηλότερης ανάλυσης.
Περιγράψτε ένα πλάνο που βλέπεται και ακούγεται
Ο οδηγός prompting του κατασκευαστή οργανώνει ένα χρήσιμο brief γύρω από το κάδρο, το θέμα, τη δράση, το σκηνικό και το φως. Δώστε στη σκηνή συνεκτικό οπτικό ύφος και περιγράψτε την κίνηση σε σαφή στάδια. Μια πρωτότυπη ιδέα προϊόντος μπορεί να δείχνει ένα μικρό μηχανικό αντικείμενο που περιστρέφεται μία φορά σε πάγκο εργασίας, ενώ η κάμερα πλησιάζει αργά, με απαλό φως από παράθυρο και διακριτικό ήχο μοτέρ. Δηλώστε τι πρέπει να προσέξει ο θεατής και πώς τελειώνει η δράση.
Κρατήστε κατανοητές την κίνηση της κάμερας και τη δράση του θέματος σε κάθε πλάνο. Μια σύνθετη ακολουθία μπορεί να χωριστεί σε διακριτά τμήματα πλάνων, καθένα με δικό του κάδρο, δράση και φωτισμό. Διατηρήστε τις ίδιες λεπτομέρειες θέματος και παλέτα όταν πολλά κλιπ προορίζονται να αποτελέσουν μία ακολουθία. Ο οδηγός τονίζει ότι τα συντομότερα πλάνα γενικά ακολουθούν πιο αξιόπιστα τις οδηγίες και ότι επαναλαμβανόμενες παραγωγές με το ίδιο prompt δίνουν διαφορετικές λήψεις.
Η παρουσίαση του μοντέλου περιγράφει βελτιωμένη φυσική συμπεριφορά και συνέχεια μεταξύ πλάνων, σε ρεαλιστικό, κινηματογραφικό και anime ύφος. Πρόκειται για δυνατότητες που πρέπει να κατευθύνετε και να εξετάζετε. Ελέγξτε την κίνηση, την επαφή αντικειμένων, τις αναλογίες και τη συνέχεια, χωρίς να θεωρείτε ότι ένα πειστικό πρώτο καρέ εγγυάται συνεκτική ακολουθία. Αν μια δράση είναι ασαφής, απλοποιήστε την και δώστε της ορατή αρχή και τέλος.
Κατευθύνετε χωριστά τον διάλογο και τον ήχο
Προσδιορίστε τις ατάκες χωριστά από την οπτική περιγραφή και χρησιμοποιήστε σταθερές ετικέτες για τους ομιλητές. Κρατήστε τον διάλογο αρκετά σύντομο ώστε να χωρά στη δράση και στην επιθυμητή διάρκεια του κλιπ. Σε κινούμενο σχέδιο με δύο χαρακτήρες, εναλλάξτε μια σύντομη ερώτηση και απάντηση, αντί να ζητάτε να χωρέσει μακρύς λόγος σε σύντομο πλάνο. Ο οδηγός προειδοποιεί ότι ο σύνθετος, εκτενής διάλογος μπορεί να διαταράξει τον ρυθμό και τον συγχρονισμό.
Περιγράψτε το ηχητικό τοπίο της σκηνής: τον ήχο μιας μικρής κίνησης, την ατμόσφαιρα του χώρου ή τον ρυθμό ενός περιβαλλοντικού εφέ. Εξηγήστε ποιος ήχος πρέπει να συμπίπτει με τη δράση. Ακούστε την παραγόμενη ομιλία και τα εφέ μαζί με την εικόνα, ελέγχοντας την αντιστοίχιση ομιλητών, τις λέξεις και τον χρονισμό. Ο συγχρονισμένος ήχος αποτελεί μέρος του κλιπ και όχι χωριστή απάντηση κειμένου.
Μέγεθος, διάρκεια και άνοιγμα καθοδηγούμενο από εικόνα
Τα τεκμηριωμένα μεγέθη εξόδου του βασικού μοντέλου είναι 720×1280 κατακόρυφα και 1280×720 οριζόντια. Τα μεγέθη υψηλότερης ανάλυσης του προφίλ Pro δεν πρέπει να αποδίδονται στο βασικό Sora 2. Το μέγεθος και η διάρκεια είναι ρητές ρυθμίσεις του αιτήματος· η αναγραφή άλλου μεγέθους ή το αίτημα για μεγαλύτερη ταινία στο prompt δεν τις αλλάζει. Η αναφορά δημιουργίας περιλαμβάνει ρυθμίσεις κλιπ 4, 8 και 12 δευτερολέπτων, οπότε προετοιμάστε ένα σύντομο, καθορισμένο στάδιο δράσης. Η διευρυμένη ροή του παραγωγού τεκμηριώνει επίσης ρυθμίσεις 16 και 20 δευτερολέπτων.
Η εικόνα αναφοράς καθορίζει το πρώτο καρέ και το κείμενο περιγράφει τι ακολουθεί. Ο παραγωγός υποστηρίζει αναφορές JPEG, PNG και WebP και απαιτεί η εικόνα να έχει το επιλεγμένο μέγεθος βίντεο. Προετοιμάστε το θέμα, το περιβάλλον και τη σύνθεση σε αυτή την αρχική εικόνα και ζητήστε συγκεκριμένη κίνηση. Πρόκειται για αναφορά αρχικού καρέ και όχι εγγύηση διατήρησης κάθε λεπτομέρειας σε όλο το κλιπ.
Επαναχρησιμοποιήσιμοι μη ανθρώπινοι χαρακτήρες
Η διευρυμένη ροή του παραγωγού μπορεί να δημιουργήσει επαναχρησιμοποιήσιμο στοιχείο χαρακτήρα από σύντομο βίντεο αναφοράς ζώου, μασκότ ή αντικειμένου. Οι οδηγίες προετοιμασίας ζητούν κλιπ MP4 περίπου δύο έως τεσσάρων δευτερολέπτων, 720p έως 1080p, σε 16:9 ή 9:16. Η αντιστοίχιση αναλογίας διαστάσεων πηγής και εξόδου βοηθά να αποφευχθεί παραμορφωμένη εμφάνιση. Η παραγωγή μπορεί να αναφέρεται σε έως δύο χαρακτήρες.
Κρατήστε το αναγνωριστικό χαρακτήρα και αναφέρετε το όνομά του στο prompt· η απλή αποστολή του αναγνωριστικού δεν αποτελεί όλη την προετοιμασία του οδηγού. Τα στοιχεία χαρακτήρων μπορούν να συνοδεύουν παραγωγή από εικόνα, αλλά οι επεκτάσεις βίντεο δεν τα δέχονται. Ο παραγωγός αποκλείει από προεπιλογή μεταφορτώσεις χαρακτήρων με ανθρώπινη ομοιότητα και απορρίπτει εικόνες αναφοράς με ανθρώπινα πρόσωπα στην τεκμηριωμένη ροή API. Οι δυνατότητες προσωπικών χαρακτήρων της εφαρμογής Sora είναι χωριστή ροή προϊόντος.
Συνεχίστε ή επεξεργαστείτε ολοκληρωμένο κλιπ
Μια επέκταση λαμβάνει ολοκληρωμένο αρχικό βίντεο και prompt συνέχειας, χρησιμοποιώντας ολόκληρο το αρχικό κλιπ ως συμφραζόμενα για την κίνηση, την κατεύθυνση της κάμερας και τη συνέχεια της σκηνής. Ο οδηγός περιγράφει προσθήκες έως 20 δευτερολέπτων ανά επέκταση. Η τεκμηριωμένη είσοδος επέκτασης είναι βίντεο και κείμενο· πρόσθετες αναφορές χαρακτήρων ή εικόνων αποκλείονται από αυτήν τη λειτουργία. Περιγράψτε πώς συνεχίζεται η υπάρχουσα δράση, αντί να εισάγετε άσχετη σκηνή χωρίς μετάβαση.
Η επεξεργασία βίντεο στοχεύει σε σαφή αλλαγή υπάρχοντος κλιπ. Μια εστιασμένη αναθεώρηση μπορεί να αλλάζει το χρώμα αντικειμένου ή την παλέτα της σκηνής, διατηρώντας το υπόλοιπο πλάνο. Ο οδηγός του παραγωγού συνιστά μία σαφώς ορισμένη αλλαγή κάθε φορά και διακρίνει την επεξεργασία παραγόμενου βίντεο από τη μεταφόρτωση αυθαίρετου υλικού, η οποία έχει χωριστή προϋπόθεση επιλεξιμότητας. Κρατήστε την ολοκληρωμένη πηγή και προσδιορίστε την ακριβή ζητούμενη αναθεώρηση πριν από νέα επεξεργασία.
Εργασίες απόδοσης και τελικό βίντεο
Η τεκμηριωμένη ροή βίντεο του παραγωγού είναι ασύγχρονη: μια υποβληθείσα εργασία μπορεί να βρίσκεται σε ουρά ή σε εξέλιξη πριν ολοκληρωθεί ή αποτύχει. Η ολοκληρωμένη εργασία δίνει βίντεο MP4· οι μικρογραφίες και τα φύλλα καρέ υποστηρίζουν προεπισκόπηση και περιήγηση. Κρατήστε την ταυτότητα της εργασίας συνδεδεμένη με το prompt, τις αναφορές και τα επιστρεφόμενα αρχεία. Η αρχική απάντηση εργασίας δεν είναι το τελικό βίντεο προς αναπαραγωγή.
Η συνήθης ροή λήψης περιγράφει διάρκεια ζωής URL λήψης μίας ώρας. Η διευρυμένη μαζική ροή προετοιμάζει ανεξάρτητα αιτήματα απόδοσης JSON με σταθερά αναγνωριστικά στοιχείων, μεταφορτωμένες αναφορές και αποτέλεσμα αντιστοιχισμένο σε κάθε πλάνο· τα ολοκληρωμένα αρχεία της έχουν χωριστή περίοδο λήψης έως 24 ώρες. Αποθηκεύστε έγκαιρα το ολοκληρωμένο κλιπ και εξετάστε την πραγματική εικόνα και τον ήχο πριν το θεωρήσετε επιλεγμένη λήψη.
Οι τεκμηριωμένοι περιορισμοί περιεχομένου του API του παραγωγού απαιτούν υλικό κατάλληλο για κοινό κάτω των 18 και απορρίπτουν χαρακτήρες ή μουσική που προστατεύονται από πνευματικά δικαιώματα και την παραγωγή πραγματικών ανθρώπων. Προετοιμάστε ανάλογα τη σκηνή και τις αναφορές. Το άμεσο αποτέλεσμα του μοντέλου είναι βίντεο με ήχο, όχι παραγόμενες στατικές εικόνες, απόκριση εργαλείου συνομιλίας ή ταινία απεριόριστης διάρκειας. Διατηρήστε την ακριβή ταυτότητα του βασικού μοντέλου και το αποδεκτό αρχικό κλιπ όταν συνεχίζετε μια οπτική ιδέα.
Ailoot Ultra · Chat Completions POST /v1/chat/completions sora-2
sora-2Εισαγωγή
Το Sora 2 δημιουργεί βίντεο με συγχρονισμένο διάλογο, ηχητικά εφέ και ήχο περιβάλλοντος από κείμενο ή εικόνα αναφοράς. Το βασικό προφίλ υποστηρίζει οπτική εξερεύνηση και κλιπ ιδεών, με χωριστές ροές του παραγωγού για επαναχρησιμοποιήσιμους μη ανθρώπινους χαρακτήρες, συνέχεια και στοχευμένες επεξεργασίες βίντεο.
- Αποδεκτές είσοδοι
- Κείμενο
- Αποτελέσματα
- json · sse
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Chat Completions POST /v1/chat/completions
- Είσοδος
text- Έξοδος
json,sse- Μορφή εξόδου
- JSON ή text/event-stream
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια sora-2 | Προεπιλογή— |
Πεδίοmessages | Τύποςmessage[] | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοmessages[].role | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοmessages[].content | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοstream | Τύποςboolean | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογήfalse |
Συνδυασμοί υλικών εισόδου
owned_text_messages
Παράμετροι και κύκλος ζωής μεθόδου
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςcontent_type | Σύμβασηapplication/json |
Παράμετροςrequired | Σύμβασηmodel, messages |
Παράμετροςmaterial_types | Σύμβασηtext |
Παράμετροςmessages | Σύμβασηπίνακας μηνυμάτων με role και content ως κυριολεκτική συμβολοσειρά |
Παράμετροςfile_material | ΣύμβασηΠραγματικό υλικό UTF-8 μπορεί να εισαχθεί ως περιεχόμενο κυριολεκτικής συμβολοσειράς· δεν συνάγεται αναφορά σε αρχείο. |
Παράμετροςoptional_controls | Σύμβασηstream |
Κύκλος ζωής: synchronous_json_or_sse
Τιμολόγηση
Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο.
- Γρήγορη λειτουργία
- Δεν έχει οριστεί Όταν επιλέγεται η γρήγορη λειτουργία
- Λειτουργία flex
- Δεν έχει οριστεί Όταν επιλέγεται η λειτουργία flex
- Μέγιστη προσπάθεια συλλογισμού
- Δεν έχει οριστεί Όταν η μέγιστη προσπάθεια συλλογισμού χρησιμοποιεί την προσαρμογή default
Χρεώσεις Ailoot
Τιμές ανά διαμόρφωση
| Διαμόρφωση | Πίνακας χρεώσεων | Χρέωση |
|---|---|---|
| ΔιαμόρφωσηΒασικές χρεώσεις ανά token | Πίνακας χρεώσεωνΒασική χρέωση | Χρέωση Είσοδος · Token εισόδου $0 / 1K token Έξοδος · Token εξόδου $0.2 / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη $0 / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη $0 / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα — / 1K token |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Παραδείγματα αιτημάτων
Ailoot Ultra · Chat Completions
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model":"sora-2","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'
from pathlib import Path
print(Path("result.json").read_text(encoding="utf-8"))
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="sora-2", messages=[{"role":"user","content":"hello"}], stream=False)
import json
from pathlib import Path
data = result.to_dict(mode="json")
Path("result.json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")
print(json.dumps(data, ensure_ascii=False, indent=2))
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model":"sora-2","messages":[{"role":"user","content":"hello"}],"stream":true}')
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.sse
Λήψη και αποθήκευση αποτελεσμάτων
Ailoot Ultra · Chat Completions
JSON ή text/event-stream
Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα
Διατηρήστε κάθε πλήρη απάντηση, αρχείο και τμήμα περιεχομένου που επιστρέφεται.
Διατηρήστε όλα τα byte JSON ή SSE, τις κεφαλίδες απόκρισης, τη χρήση που επιστρέφεται και όλα τα παρεχόμενα πεδία αποτελέσματος. Δεν δηλώνεται οικογένεια εξόδων ειδική για το μοντέλο.
Αν χρειάζεται έλεγχος της αρχικής απάντησης
Διατηρήστε την αρχική απόκριση και την ταυτότητα της προσπάθειας· δεν συνάγεται περιοδικός έλεγχος νέας εργασίας ή επανυποβολή.
Πεδία απάντησης
| Πεδίο | Τύπος | Σημασία |
|---|---|---|
Πεδίοcomplete response JSON | Τύποςobject | ΣημασίαΔιατηρήστε κάθε πεδίο που επιστρέφεται, χωρίς να υποθέτετε οικογένεια αποτελεσμάτων ειδική για το μοντέλο. |
ΠεδίοSSE data events | Τύποςstream | ΣημασίαΔιατηρήστε κάθε συμβάν και δείκτη τερματισμού που επιστρέφεται, χωρίς να επιλέγετε μόνο πεδία κειμένου. |
Εναλλακτικά ονόματα
Εναλλακτικά ονόματα μοντέλου
Ailoot Ultra sora-2
Εναλλακτικές διαδρομές μεθόδων
Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.
Σχετικά ID μοντέλων
Ailoot Ultra · Anthropic Messages POST /v1/messages sora-2
sora-2Εισαγωγή
Το Sora 2 δημιουργεί βίντεο με συγχρονισμένο διάλογο, ηχητικά εφέ και ήχο περιβάλλοντος από κείμενο ή εικόνα αναφοράς. Το βασικό προφίλ υποστηρίζει οπτική εξερεύνηση και κλιπ ιδεών, με χωριστές ροές του παραγωγού για επαναχρησιμοποιήσιμους μη ανθρώπινους χαρακτήρες, συνέχεια και στοχευμένες επεξεργασίες βίντεο.
- Αποδεκτές είσοδοι
- Κείμενο
- Αποτελέσματα
- json · sse
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Anthropic Messages POST /v1/messages
- Είσοδος
text- Έξοδος
json,sse- Μορφή εξόδου
- JSON ή SSE
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια sora-2 | Προεπιλογή— |
Πεδίο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 / 1K token Έξοδος · Token εξόδου $0.2 / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη $0 / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη $0 / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα — / 1K token |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Παραδείγματα αιτημάτων
Ailoot Ultra · Anthropic Messages
{
"model": "sora-2",
"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': 'sora-2', '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': 'sora-2', '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 sora-2
Εναλλακτικές διαδρομές μεθόδων
Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.
Σχετικά ID μοντέλων
FAQ · sora-2
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/chat/completions·sora-2:text→json,ssePOST /v1/messages·sora-2:text→json,sse- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/chat/completions·sora-2:model,messages,streamPOST /v1/messages·sora-2:model,messages,max_tokens,stream