Zhipu AI: CogVideoX 3
Το CogVideoX 3 δημιουργεί βίντεο από κείμενο, εικόνα ή ζεύγος πρώτου και τελευταίου καρέ στην τεκμηριωμένη ροή εργασίας του κατασκευαστή. Υποστηρίζει ακολουθίες πέντε ή δέκα δευτερολέπτων, διάφορες διαστάσεις εξόδου έως 4K, 30 ή 60 fps και προαιρετικά παραγόμενα ηχητικά εφέ.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το CogVideoX 3 είναι το μοντέλο βίντεο της Zhipu AI με τεκμηριωμένη δημιουργία από κείμενο, από εικόνα και από πρώτο και τελευταίο καρέ. Ο κατασκευαστής δίνει έμφαση στη σταθερότητα των καρέ, στην τήρηση των οδηγιών και σε ρεαλιστικά ή τρισδιάστατα οπτικά ύφη. Επιλέξτε κείμενο όταν η σκηνή ξεκινά ως γραπτή περιγραφή, μία εικόνα όταν υπάρχει ήδη η οπτική της βάση ή δύο εικόνες για το πρώτο και το τελευταίο καρέ όταν η ακολουθία χρειάζεται καθορισμένη αρχική και τελική όψη.
Για μια περιγραφή κειμένου, περιγράψτε το θέμα και μία ευδιάκριτη δράση. Δηλώστε το περιβάλλον, την οπτική γωνία και τις σημαντικές φυσικές σχέσεις, ώστε η σκηνή να μπορεί να αξιολογηθεί ως προς μια σαφή πρόθεση. Ένας χαρακτήρας που σηκώνει ένα αντικείμενο απαιτεί διαφορετική ακολουθία από μια κάμερα που αποκαλύπτει το αντικείμενο. Περιγράψτε και τα δύο μόνο όταν η σχέση τους έχει σημασία για το πλάνο.
Για μια ακολουθία από εικόνα, προετοιμάστε την αναφορά ώστε να είναι ορατά τα διακριτά χαρακτηριστικά του θέματος. Ο κατασκευαστής δέχεται εικόνες PNG, JPEG και JPG μεγέθους έως 5 MB, οι οποίες παρέχονται μέσω URL ή κωδικοποιημένων δεδομένων εικόνας. Διατηρήστε την πραγματική αναφορά μαζί με το παραγόμενο αποτέλεσμα, ώστε η εμφάνιση και το καδράρισμα να συγκρίνονται με την πηγή και όχι με μια εκδοχή της από τη μνήμη.
Η λειτουργία πρώτου και τελευταίου καρέ του κατασκευαστή δέχεται δύο εικόνες με σειρά: η πρώτη καθορίζει το αρχικό καρέ και η δεύτερη το τελικό. Προετοιμάστε τις ως τις δύο επιθυμητές καταστάσεις ενός πλάνου. Περιγράψτε τη μετάβαση ή τη δράση που τις συνδέει και ελέγξτε αν το θέμα παραμένει συνεπές μεταξύ του πρώτου και του τελευταίου καρέ. Ένα ζεύγος καλών στατικών εικόνων δεν δείχνει από μόνο του ότι η ενδιάμεση κίνηση ταιριάζει στην επιθυμητή ιστορία.
Η προτροπή μπορεί να περιέχει έως 512 χαρακτήρες. Χρησιμοποιήστε το διαθέσιμο κείμενο για τη δράση, την κατεύθυνσή της και τις οπτικές λεπτομέρειες που διακρίνουν ένα επιτυχημένο αποτέλεσμα. Κρατήστε την περιγραφή εστιασμένη σε όσα πρέπει να συμβούν στην οθόνη. Όταν οι εικόνες εισόδου καθορίζουν ήδη την εμφάνιση του θέματος, περιγράψτε την κίνηση και τον χρονισμό που πρέπει να αναπτυχθούν μεταξύ αυτών των εικόνων ή ξεκινώντας από αυτές.
Ο κατασκευαστής τεκμηριώνει έξοδο πέντε ή δέκα δευτερολέπτων, με προεπιλογή τα πέντε δευτερόλεπτα, και 30 ή 60 καρέ ανά δευτερόλεπτο. Οι υποστηριζόμενες διαστάσεις περιλαμβάνουν 1280×720, 720×1280, 1024×1024, 1920×1080, 1080×1920, 2048×1080 και 3840×2160. Επιλέξτε τις διαστάσεις και τον χρονισμό για τον προορισμό και εξετάστε το ολοκληρωμένο απόσπασμα ως προς το καδράρισμα και τον ρυθμό της πραγματικής δράσης.
Οι λειτουργίες ποιότητας και ταχύτητας τεκμηριώνονται χωριστά από την προαιρετική ρύθμιση ηχητικών εφέ AI. Διατηρήστε αυτές τις επιλογές μαζί με την προτροπή, τις εικόνες και το αποτέλεσμα. Οι οπτικές δυνατότητες και οι δυνατότητες εισόδου του κατασκευαστή περιγράφουν το μοντέλο· οι διαθέσιμες παράμετροι ελέγχου μιας συγκεκριμένης μεθόδου δημιουργίας παρέχονται από την τεχνική προδιαγραφή αυτής της μεθόδου. Διατηρήστε τις ρυθμίσεις που χρησιμοποιήθηκαν πραγματικά κατά τη σύγκριση υποψήφιων πλάνων.
Διατηρήστε την ταυτότητα της αρχικής εργασίας μέχρι να ολοκληρωθεί το βίντεο και αποθηκεύστε το υλικό που επιστρέφεται για επεξεργασία. Ελέγξτε ολόκληρη την ακολουθία, συμπεριλαμβανομένης της εμφάνισης του θέματος σε μεγάλες κινήσεις, των αλληλεπιδράσεων με αντικείμενα της σκηνής και της τελικής σύνθεσης. Για εργασία με πρώτο και τελευταίο καρέ, εξετάστε και τα δύο αυτά καρέ και τη μετάβαση μεταξύ τους. Αναθεωρήστε τη συγκεκριμένη οπτική ασυμφωνία διατηρώντας τις επιτυχημένες αναφορές και το σχέδιο του πλάνου, και συγκρίνετε τα ολοκληρωμένα βίντεο αντί μόνο για τις εικόνες προεπισκόπησής τους.
Ailoot Ultra · Βίντεο POST /v1/videos cogvideox-3
cogvideox-3Εισαγωγή
Το CogVideoX 3 δημιουργεί βίντεο από κείμενο, εικόνα ή ζεύγος πρώτου και τελευταίου καρέ στην τεκμηριωμένη ροή εργασίας του κατασκευαστή. Υποστηρίζει ακολουθίες πέντε ή δέκα δευτερολέπτων, διάφορες διαστάσεις εξόδου έως 4K, 30 ή 60 fps και προαιρετικά παραγόμενα ηχητικά εφέ.
- Αποδεκτές είσοδοι
- Κείμενο
- Αποτελέσματα
- Βίντεο
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Βίντεο POST /v1/videos
- Είσοδος
text- Έξοδος
video
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια cogvideox-3 Συνθήκες: Χρησιμοποιήστε τον ακριβή επιλογέα μοντέλου Ailoot. | Προεπιλογή— |
Πεδίοprompt | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Συνθήκες: Περιγράψτε τη σκηνή και την κίνηση. | Προεπιλογή— |
Πεδίοquality | Τύποςboolean | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Συνθήκες: Προαιρετική σημαία ποιότητας· αυτό το επιλεγμένο σχήμα δεν παρέχει συμβατή απαρίθμηση τιμών ή προεπιλογή. | Προεπιλογή— |
Πεδίοwith_audio | Τύποςboolean | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Συνθήκες: Δημιουργεί ηχητικά εφέ με τεχνητή νοημοσύνη όταν είναι ενεργοποιημένο. | Προεπιλογήfalse |
Πεδίοsize | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Συνθήκες: Δώστε την τεκμηριωμένη συμβολοσειρά μεγέθους όταν επιλέγετε ρητές διαστάσεις. | Προεπιλογή— |
Πεδίοfps | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 30, 60 Συνθήκες: Ο ρυθμός καρέ αναπαρίσταται ως συμβολοσειρά σε αυτή την επιλεγμένη εγγενή μέθοδο. | Προεπιλογή30 |
Πεδίοduration | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 5, 10 Συνθήκες: Η διάρκεια σε δευτερόλεπτα αναπαρίσταται ως συμβολοσειρά σε αυτή την επιλεγμένη εγγενή μέθοδο. | Προεπιλογή5 |
Παράμετροι και κύκλος ζωής μεθόδου
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςcontent_type | Σύμβασηapplication/json |
Παράμετροςrequired | Σύμβασηmodel, prompt |
Παράμετροςoptional | Σύμβασηquality, with_audio, size, fps, duration |
Παράμετροςmaterial_types | Σύμβασηtext |
Παράμετροςconditions | ΣύμβασηΧρησιμοποιήστε τον ακριβή επιλογέα μοντέλου Ailoot., Περιγράψτε τη σκηνή και την κίνηση., Προαιρετική σημαία ποιότητας· αυτό το επιλεγμένο σχήμα δεν παρέχει συμβατή απαρίθμηση τιμών ή προεπιλογή., Δημιουργεί ηχητικά εφέ με τεχνητή νοημοσύνη όταν είναι ενεργοποιημένο., Δώστε την τεκμηριωμένη συμβολοσειρά μεγέθους όταν επιλέγετε ρητές διαστάσεις., Ο ρυθμός καρέ αναπαρίσταται ως συμβολοσειρά σε αυτή την επιλεγμένη εγγενή μέθοδο., Η διάρκεια σε δευτερόλεπτα αναπαρίσταται ως συμβολοσειρά σε αυτή την επιλεγμένη εγγενή μέθοδο. |
Εναλλακτικά ονόματα μεθόδου: /v1/videos/generations
Κύκλος ζωής: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Τιμολόγηση
Πώς υπολογίζεται η τελική χρέωση
Οι εμφανιζόμενες τιμές χρησιμοποιούνται για την εκτίμηση του κόστους πριν από την παραγωγή. Η τελική χρέωση υπολογίζεται από το κόστος που καταγράφηκε για την αρχική παραγωγή. Η μετρημένη διάρκεια της εξόδου και οι προβλεπόμενες ποσότητες δεν αποτελούν την τελική χρεώσιμη ποσότητα.
Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο.
- Γρήγορη λειτουργία
- Δεν έχει οριστεί Όταν επιλέγεται η γρήγορη λειτουργία
- Λειτουργία flex
- Δεν έχει οριστεί Όταν επιλέγεται η λειτουργία flex
- Μέγιστη προσπάθεια συλλογισμού
- Δεν έχει οριστεί Όταν η μέγιστη προσπάθεια συλλογισμού χρησιμοποιεί την προσαρμογή default
Εκτιμώμενες χρεώσεις για σύγκριση
Τιμές ανά διαμόρφωση
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Πίνακας χρεώσεων | Προβλεπόμενη ποσότητα | Ποσότητα τιμολόγησης | Χρέωση |
|---|---|---|---|---|
| ΔιαμόρφωσηΒασικές χρεώσεις token | Πίνακας χρεώσεωνΒασική χρέωση | Προβλεπόμενη ποσότητα— | Ποσότητα τιμολόγησης— | Χρέωση Είσοδος · Token εισόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Έξοδος · Token εξόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα · Εκτίμηση μόνο για σύγκριση — / 1K token |
| ΔιαμόρφωσηΑνά αίτημα | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότητα— | Ποσότητα τιμολόγησηςένα αίτημα | Χρέωση Είσοδος · Εκτίμηση μόνο για σύγκριση $0.3 ανά αίτημα |
| ΔιαμόρφωσηΕκτιμώμενο κόστος δημιουργίας | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργία | Ποσότητα τιμολόγησης— | Χρέωση Έξοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $0.3 εκτίμηση πριν από τη δημιουργία Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή. |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Παραδείγματα αιτημάτων
Ailoot Ultra · Βίντεο
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
"model": "cogvideox-3",
"prompt": "A cat is walking on grass."
}
JSON
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Create once; retain id, polling_url, original task identifiers and every header.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("status.json").read_text())
roles={}
def visit(v,path=""):
if isinstance(v,dict):
for k,x in v.items(): visit(x,path+"/"+k)
elif isinstance(v,list):
for i,x in enumerate(v): visit(x,path+"/"+str(i))
elif isinstance(v,str):
u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
target=Path(f"asset-{i}.bin")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
raw=target.read_bytes()
if not raw: raise SystemExit("Empty asset; retain original status and metadata")
ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
name=f"asset-{i}.{ext}"
if target.name!=name: target.rename(name)
manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS
Λήψη και αποθήκευση αποτελεσμάτων
Ailoot Ultra · Βίντεο
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα
Αποθηκεύστε κάθε ολοκληρωμένο βίντεο ή αρχείο που επιστρέφεται· ανακτήστε κάθε πραγματικό URL αρχείου που επιστρέφεται.
Διατηρήστε ολόκληρη την απόκριση και τις κεφαλίδες, τα αρχικά αναγνωριστικά, κάθε πραγματική έξοδο και όλα τα πεδία χρήσης και λογιστικής καταγραφής. Αποθηκεύστε κάθε μοναδικό αρχείο πολυμέσων που σας ανήκει και διατηρήστε κάθε ρόλο που παραπέμπει σε αυτό.
Αν χρειάζεται έλεγχος της αρχικής απάντησης
Διατηρήστε το δημόσιο id εργασίας ή λειτουργίας που επιστρέφεται και όλες τις κεφαλίδες. Διαβάστε μόνο την αρχική εργασία· τα unknown ή result_pending_check δεν επιτρέπουν άλλη δημιουργία.
Πεδία απάντησης
| Πεδίο | Τύπος |
|---|---|
Πεδίοid | Τύποςstring |
Πεδίοpolling_url | Τύποςstring |
Πεδίοprovider_task_id | Τύποςstring |
Πεδίοid | Τύποςstring |
Πεδίοtask_status | Τύποςstring |
Πεδίοvideo_result[].url | Τύποςstring |
Εναλλακτικά ονόματα
Εναλλακτικά ονόματα μοντέλου
Ailoot Ultra cogvideox-3
Εναλλακτικές διαδρομές μεθόδων
/v1/videos/generations
Σχετικά ID μοντέλων
FAQ · Zhipu AI: CogVideoX 3
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/videos·cogvideox-3:text→video- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/videos·cogvideox-3:model,prompt,quality,with_audio,size,fps,duration