Zhipu AI: CogVideoX 2
Το CogVideoX 2 δημιουργεί βίντεο από περιγραφή κειμένου ή από εικόνα που παρέχεται. Ο κατασκευαστής τεκμηριώνει επιλέξιμες διαστάσεις καρέ, 30 ή 60 fps, λειτουργίες ποιότητας ή ταχύτητας και προαιρετικά παραγόμενα ηχητικά εφέ για τη διαμόρφωση μιας σύντομης οπτικής σκηνής.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το CogVideoX 2 είναι το μοντέλο δημιουργίας βίντεο της Zhipu AI για γραπτή περιγραφή σκηνής ή εικόνα που παρέχεται. Το κείμενο καθορίζει το θέμα, το περιβάλλον και τη δράση· μια εικόνα μπορεί να προσφέρει την οπτική βάση για την παραγόμενη ακολουθία. Χρησιμοποιήστε την είσοδο που αντιπροσωπεύει καλύτερα το υλικό που είναι ήδη διαθέσιμο για το πλάνο και περιγράψτε την ορατή κίνηση που πρέπει να περιέχει το ολοκληρωμένο βίντεο.
Για δημιουργία από κείμενο, ορίστε ένα συνεκτικό γεγονός. Ένα άτομο που ανοίγει την πόρτα ενός εργαστηρίου, μια μικρή βάρκα που περνά δίπλα από μια προβλήτα ή ένα αντικείμενο που περιστρέφεται υπό σταθερό φωτισμό δίνουν στο πλάνο έναν ευδιάκριτο σκοπό. Δηλώστε τα σημαντικά χαρακτηριστικά του θέματος, την οπτική γωνία και την κατεύθυνση της κίνησης. Επιλέξτε ένα τέλος που μπορεί να χρησιμοποιηθεί στο επιθυμητό μοντάζ, αντί να αφήνετε ακαθόριστη την τελική σύνθεση της σκηνής.
Για δημιουργία από εικόνα, προετοιμάστε μια καθαρή όψη του θέματος και περιγράψτε πώς πρέπει να κινηθεί η σκηνή ξεκινώντας από αυτή. Ο κατασκευαστής δέχεται αναφορές PNG, JPEG και JPG έως 5 MB, οι οποίες παρέχονται μέσω URL εικόνας ή κωδικοποιημένων δεδομένων εικόνας. Διατηρήστε ορατά στην αναφορά τα σημαντικά περιγράμματα, τα χαρακτηριστικά του προσώπου και τις λεπτομέρειες των αντικειμένων, αφήνοντας χώρο στη σύνθεση για τη ζητούμενη δράση.
Ο κατασκευαστής περιορίζει τη γραπτή προτροπή σε 512 χαρακτήρες. Χρησιμοποιήστε αυτόν τον χώρο για τις καθοριστικές λεπτομέρειες: θέμα, δράση, περιβάλλον και οπτική γωνία. Μια σύντομη περιγραφή που εξηγεί ποιο αντικείμενο κινείται και τι παραμένει σταθερό αξιολογείται ευκολότερα από μια λίστα γενικών επιθέτων ύφους. Αν το αποτέλεσμα δεν πετυχαίνει τον στόχο, αναθεωρήστε την οδηγία που συνδέεται με το παρατηρούμενο πρόβλημα κίνησης ή καδραρίσματος.
Οι δημοσιευμένες διαστάσεις εξόδου περιλαμβάνουν τετράγωνες, οριζόντιες και κατακόρυφες μορφές, με επιλογές από 720×480 έως 3840×2160 pixel. Ο κατασκευαστής τεκμηριώνει επίσης 30 ή 60 καρέ ανά δευτερόλεπτο. Επιλέξτε τη μορφή και τον ρυθμό καρέ για τον προορισμό πριν από τη δημιουργία και εξετάστε το πραγματικό απόσπασμα για να δείτε αν το θέμα και οι σημαντικές λεπτομέρειές του παραμένουν ευδιάκριτα σε αυτό το κάδρο.
Η ποιότητα και η ταχύτητα είναι ονομασμένες λειτουργίες εξόδου στη ροή εργασίας του κατασκευαστή. Τα προαιρετικά ηχητικά εφέ που δημιουργούνται με AI ελέγχονται χωριστά από την οπτική περιγραφή. Διατηρήστε την επιλεγμένη λειτουργία και τη ρύθμιση ηχητικών εφέ μαζί με την προτροπή και τυχόν εικόνα αναφοράς, ώστε τα διαφορετικά υποψήφια αποσπάσματα να συγκρίνονται με βάση τις πραγματικές ρυθμίσεις δημιουργίας τους.
Η δημιουργία είναι ασύγχρονη: επιστρέφεται μια ταυτότητα εργασίας πριν γίνει διαθέσιμο το ολοκληρωμένο βίντεο. Διατηρήστε αυτή την ταυτότητα σε όλη τη διάρκεια του ελέγχου του αποτελέσματος και κρατήστε όλα τα ολοκληρωμένα αρχεία βίντεο που συνδέονται με τη λειτουργία. Αποθηκεύστε το ίδιο το απόσπασμα για επεξεργασία, μαζί με την εικόνα προέλευσης όταν χρησιμοποιείται, αντί να εξαρτάστε από μια προσωρινή θέση αποτελέσματος ή ένα καρέ προεπισκόπησης.
Ελέγξτε ολόκληρη την ακολουθία ως προς τη συνέχεια, τον χρονισμό και τη ζητούμενη δράση. Ένα πλάνο προϊόντος χρειάζεται σταθερό σχήμα και λεπτομέρειες υλικού κατά την κίνηση· ένα πλάνο χαρακτήρα χρειάζεται συνεπή εμφάνιση και χειρονομίες. Ελέγξτε την τελική σύνθεση και τυχόν παραγόμενο ήχο ως προς τον σκοπό του πλάνου. Διατηρήστε τα επιτυχημένα στοιχεία της σκηνής όταν διορθώνετε μια συγκεκριμένη ασυμφωνία και χρησιμοποιήστε τις ίδιες συνθήκες θέασης για να συγκρίνετε το αρχικό και το αναθεωρημένο βίντεο.
Ailoot Ultra · Βίντεο POST /v1/videos cogvideox-2
cogvideox-2Εισαγωγή
Το CogVideoX 2 δημιουργεί βίντεο από περιγραφή κειμένου ή από εικόνα που παρέχεται. Ο κατασκευαστής τεκμηριώνει επιλέξιμες διαστάσεις καρέ, 30 ή 60 fps, λειτουργίες ποιότητας ή ταχύτητας και προαιρετικά παραγόμενα ηχητικά εφέ για τη διαμόρφωση μιας σύντομης οπτικής σκηνής.
- Αποδεκτές είσοδοι
- Κείμενο
- Αποτελέσματα
- Βίντεο
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Βίντεο POST /v1/videos
- Είσοδος
text- Έξοδος
video
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια cogvideox-2 Συνθήκες: Χρησιμοποιήστε τον ακριβή επιλογέα μοντέλου 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.2 ανά αίτημα |
| ΔιαμόρφωσηΕκτιμώμενο κόστος δημιουργίας | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργία | Ποσότητα τιμολόγησης— | Χρέωση Έξοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $0.2 εκτίμηση πριν από τη δημιουργία Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή. |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Παραδείγματα αιτημάτων
Ailoot Ultra · Βίντεο
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
"model": "cogvideox-2",
"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-2
Εναλλακτικές διαδρομές μεθόδων
/v1/videos/generations
Σχετικά ID μοντέλων
FAQ · Zhipu AI: CogVideoX 2
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/videos·cogvideox-2:text→video- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/videos·cogvideox-2:model,prompt,quality,with_audio,size,fps,duration