Higgsfield: DOP Preview
Το DOP Preview μετατρέπει τις εικόνες που παρέχετε σε βίντεο μέσω της τεκμηριωμένης ροής προτύπων κίνησης. Το ακριβές αναγνωριστικό επιλογής dop-preview υποστηρίζει ένα ή δύο εφέ, με τα στοιχεία ελέγχου έντασης, prompt και seed να διατηρούνται μαζί με το ολοκληρωμένο αποτέλεσμα.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το DOP Preview ζωντανεύει τις εικόνες που παρέχετε μέσω της τεκμηριωμένης ροής μετατροπής εικόνας σε βίντεο του Higgsfield. Το ακριβές αναγνωριστικό επιλογής είναι dop-preview. Χρησιμοποιήστε το dop-preview ως επιλογή μοντέλου στο ανώτερο επίπεδο και ως τιμή του model μέσα στο τεκμηριωμένο αντικείμενο params. Η εικόνα παρέχει το οπτικό υλικό, ενώ τα πρότυπα κίνησης και οι γραπτές οδηγίες καθορίζουν την επιθυμητή κίνηση και το εφέ.
Ετοιμάστε μια εικόνα αναφοράς στην οποία διακρίνονται καθαρά το επιθυμητό θέμα, οι σημαντικές λεπτομέρειες και ο χώρος γύρω του. Ο οδηγός συνιστά εικόνα υψηλής ανάλυσης για ευκρινέστερες λεπτομέρειες. Για μια σκηνή προϊόντος, επιλέξτε μια όψη που δείχνει το σχήμα του αντικειμένου και τις επιφάνειες που πρέπει να παραμένουν αναγνωρίσιμες κατά την κίνηση. Για ένα πρόσωπο ή περιβάλλον, προσδιορίστε το οπτικό χαρακτηριστικό που πρέπει να αναδείξει η κίνηση. Δώστε το πραγματικό URL της εικόνας αναφοράς μέσω της εισόδου εικόνας που χρησιμοποιείται στο παράδειγμα της μεθόδου.
Η τεκμηρίωση της λειτουργίας προβλέπει ένα ή δύο πρότυπα κίνησης. Όταν δίνονται δύο, ο οδηγός περιγράφει τα εφέ τους ως συνδυασμένα. Οι περιγραφές των προεπιλογών περιλαμβάνουν κίνηση κάμερας, περιστροφή θέματος και οπτικούς μετασχηματισμούς· για παράδειγμα, το Dolly In περιγράφει προσέγγιση της κάμερας, ενώ το 3D Rotation περιγράφει ένα θέμα ή προϊόν που περιστρέφεται επί τόπου. Επιλέξτε τα τεκμηριωμένα αναγνωριστικά προτύπων που αντιστοιχούν στην επιθυμητή ακολουθία και κρατήστε κάθε αναγνωριστικό μαζί με την τιμή έντασής του.
Η ένταση κίνησης είναι αριθμός από 0 έως 1, με τεκμηριωμένη προεπιλογή το 0.8. Ο οδηγός περιγράφει το 0.3 ως διακριτικό εφέ και το 1 ως έντονη κίνηση. Επιλέξτε την ένταση ανάλογα με τη λεπτομέρεια που πρέπει να παραμένει ευδιάκριτη και ελέγξτε ολόκληρη την παραγόμενη κίνηση. Η περιγραφή της κίνησης και η έντασή της εξυπηρετούν διαφορετικούς σκοπούς: το πρότυπο επιλέγει το εφέ, ενώ η ένταση καθορίζει πόσο έντονο θα είναι.
Σύμφωνα με την περιγραφή του, το πεδίο prompt πρέπει να υπάρχει, αλλά επιτρέπεται κενή συμβολοσειρά. Για εφέ που βασίζονται σε πρότυπα, ο οδηγός συνιστά να αφήνετε το prompt κενό· όταν δίνετε κείμενο, συνιστά να συμπεριλαμβάνετε την περιγραφή του προτύπου, επειδή το prompt μπορεί να αλλάξει σημαντικά το αποτέλεσμα. Το στοιχείο ελέγχου enhance_prompt ενεργοποιεί τη βελτιστοποίηση του prompt και έχει τεκμηριωμένη προεπιλογή true. Κρατήστε το κείμενο και αυτό το στοιχείο ελέγχου μαζί με την εικόνα αναφοράς και τα επιλεγμένα πρότυπα όταν συγκρίνετε εκδοχές.
Το στοιχείο ελέγχου seed δέχεται ακέραιο από 1 έως και 1000000. Καταγράψτε το επιλεγμένο seed μαζί με τις ρυθμίσεις παραγωγής. Το αίτημα διαθέτει επίσης ένα ακέραιο πεδίο seconds· κρατήστε την τιμή που χρησιμοποιήθηκε μαζί με το παραγόμενο κλιπ και ελέγξτε τον πραγματικό χρονισμό και το καδράρισμά του. Το boolean check_nsfw ενεργοποιεί το τεκμηριωμένο φίλτρο περιεχομένου και έχει προεπιλογή true. Αυτά τα στοιχεία ελέγχου ανήκουν στο αίτημα μετατροπής εικόνας σε βίντεο και πρέπει να παραμένουν συνδεδεμένα με το ακριβές επιλεγμένο μοντέλο.
Η παραγωγή είναι ασύγχρονη. Διατηρήστε το αναγνωριστικό εργασίας που επιστρέφεται καθώς ακολουθείτε τη ρυθμισμένη διαδικασία ελέγχου κατάστασης και αποτελέσματος. Η αντιστοίχιση ολοκλήρωσης διαβάζει τις εγγραφές των ολοκληρωμένων εργασιών και τα ανεπεξέργαστα URL των αποτελεσμάτων τους. Αποθηκεύστε κάθε ολοκληρωμένο αποτέλεσμα βίντεο και διατηρήστε το αναγνωριστικό εργασίας του μαζί με το URL που επιστράφηκε, κρατώντας όλες τις ολοκληρωμένες εγγραφές μαζί ως αποτέλεσμα της λειτουργίας.
Ελέγξτε ολόκληρο το βίντεο σε σχέση με την εικόνα που δόθηκε, το επιλεγμένο εφέ και τις γραπτές οδηγίες: εμφάνιση θέματος, κίνηση, καδράρισμα και τελική όψη. Για μια διόρθωση, προσδιορίστε τη συγκεκριμένη οπτική λεπτομέρεια που πρέπει να αλλάξει και διατηρήστε τα επιτυχημένα μέρη του αιτήματος. Κρατήστε μαζί την αρχική εικόνα αναφοράς, το ακριβές αναγνωριστικό επιλογής, το prompt, τα αναγνωριστικά κίνησης, τις εντάσεις, το seed, τις ζητούμενες ρυθμίσεις και τα ολοκληρωμένα αρχεία, ώστε η επόμενη σύγκριση να βασίζεται στην πραγματική παραγωγή.
Ailoot Ultra · Βίντεο POST /v1/videos dop-preview
dop-previewΕισαγωγή
Το DOP Preview μετατρέπει τις εικόνες που παρέχετε σε βίντεο μέσω της τεκμηριωμένης ροής προτύπων κίνησης. Το ακριβές αναγνωριστικό επιλογής dop-preview υποστηρίζει ένα ή δύο εφέ, με τα στοιχεία ελέγχου έντασης, prompt και seed να διατηρούνται μαζί με το ολοκληρωμένο αποτέλεσμα.
- Αποδεκτές είσοδοι
- Εικόνες · Κείμενο
- Αποτελέσματα
- Βίντεο
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Βίντεο POST /v1/videos
- Είσοδος
image,text- Έξοδος
video
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια dop-preview Συνθήκες: Επιλογέας μοντέλου Ailoot. | Προεπιλογή— |
Πεδίοparams | Τύποςobject | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Συνθήκες: Παράμετροι εικόνας σε βίντεο· διατηρήστε αυτό το περίβλημα. | Προεπιλογή— |
Πεδίοparams.model | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια dop-preview Συνθήκες: Χρησιμοποιήστε τον ίδιο επιλογέα με το model στο ανώτατο επίπεδο. | Προεπιλογή— |
Πεδίοparams.prompt | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Συνθήκες: Διατηρήστε αυτό το πεδίο· τεκμηριώνεται η κενή συμβολοσειρά. Η γραπτή καθοδήγηση επηρεάζει έντονα το επιλεγμένο εφέ κίνησης. | Προεπιλογή— |
Πεδίοparams.seconds | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Συνθήκες: Ζητούμενη διάρκεια· δεν δηλώνεται τεκμηριωμένο εύρος ή προεπιλογή. | Προεπιλογή— |
Πεδίοparams.motions | Τύποςarray | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Συνθήκες: Επιλέξτε ένα ή δύο τεκμηριωμένα πρότυπα κίνησης. | Προεπιλογή— |
Πεδίοparams.motions[].id | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Συνθήκες: Αναγνωριστικό κίνησης στο τεκμηριωμένο λειτουργικό παράδειγμα αιτήματος. | Προεπιλογή— |
Πεδίοparams.motions[].strength | Τύποςnumber | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Ελάχιστο: 0 Μέγιστο: 1 Συνθήκες: Ένταση κίνησης: το 0.3 περιγράφεται ως ήπιο και το 1 ως έντονο. | Προεπιλογή0,8 |
Πεδίοparams.input_images | Τύποςarray | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Συνθήκες: Εικόνες αναφοράς με τον πίνακα αντικειμένων image_url που εμφανίζεται στο λειτουργικό παράδειγμα. | Προεπιλογή— |
Πεδίοparams.input_images[].type | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια image_url Συνθήκες: Αναπαράσταση υλικού αναφοράς. | Προεπιλογή— |
Πεδίοparams.input_images[].image_url | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Συνθήκες: Το πραγματικό, προσβάσιμο URL της εικόνας αναφοράς σας. | Προεπιλογή— |
Πεδίοparams.enhance_prompt | Τύποςboolean | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Συνθήκες: Βελτίωση προτροπής. | Προεπιλογήtrue |
Πεδίοparams.check_nsfw | Τύποςboolean | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Συνθήκες: Φιλτράρισμα περιεχομένου. | Προεπιλογήtrue |
Πεδίοparams.seed | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο: 1 Μέγιστο: 1.000.000 Συνθήκες: Τιμή seed για συνεπή έξοδο. | Προεπιλογή— |
Πεδίοwebhook | Τύποςobject | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Συνθήκες: Προαιρετικές τεκμηριωμένες ρυθμίσεις webhook· η ανάκτηση αποτελεσμάτων που σας ανήκουν χρησιμοποιεί τις διαδρομές εργασιών του Ailoot. | Προεπιλογή— |
Πεδίοwebhook.url | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Συνθήκες: Το URL του παραλήπτη σας. | Προεπιλογή— |
Πεδίοwebhook.secret | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Συνθήκες: Το μυστικό του παραλήπτη σας. | Προεπιλογή— |
Πεδίοcallback | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Συνθήκες: Προαιρετικός παραλήπτης callback· ο τεκμηριωμένος παραλήπτης απαντά με HTTP 200. | Προεπιλογή— |
Συνδυασμοί υλικών εισόδου
Παράμετροι και κύκλος ζωής μεθόδου
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςcontent_type | Σύμβασηapplication/json |
Παράμετροςrequired | Σύμβασηmodel, params |
Παράμετροςoptional | Σύμβασηparams.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback |
Παράμετροςmaterial_types | Σύμβασηimage, text |
Παράμετροςadditional_properties | Σύμβασηtrue |
Παράμετροςvalidation_scope | ΣύμβασηΤο model δρομολογεί το αίτημα· το περίβλημα παραμέτρων ακολουθεί το παρουσιαζόμενο αίτημα εικόνας σε βίντεο. |
Εναλλακτικά ονόματα μεθόδου: /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/videos/generations/{request_id}/content
Χρησιμοποιήστε τον ίδιο επιλογέα μοντέλου στο ανώτατο επίπεδο και μέσα στο params.
Δημιουργήστε μία φορά και μετά χρησιμοποιήστε το δημόσιο id και το polling_url που επιστρέφονται για την αρχική λειτουργία.
Ανακτήστε κάθε ολοκληρωμένο βίντεο που σας ανήκει· ελέγξτε την πραγματική διάρκεια και τις διαστάσεις στο αποτέλεσμα.
Αντικαταστήστε το YOUR_ACCESSIBLE_IMAGE_URL στο παράδειγμα με το πραγματικό URL της εικόνας αναφοράς σας.
Τιμολόγηση
Πώς υπολογίζεται η τελική χρέωση
Οι εμφανιζόμενες τιμές χρησιμοποιούνται για την εκτίμηση του κόστους πριν από την παραγωγή. Η τελική χρέωση υπολογίζεται από το κόστος που καταγράφηκε για την αρχική παραγωγή. Η μετρημένη διάρκεια της εξόδου και οι προβλεπόμενες ποσότητες δεν αποτελούν την τελική χρεώσιμη ποσότητα.
Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο.
- Γρήγορη λειτουργία
- Δεν έχει οριστεί Όταν επιλέγεται η γρήγορη λειτουργία
- Λειτουργία flex
- Δεν έχει οριστεί Όταν επιλέγεται η λειτουργία flex
- Μέγιστη προσπάθεια συλλογισμού
- Δεν έχει οριστεί Όταν η μέγιστη προσπάθεια συλλογισμού χρησιμοποιεί την προσαρμογή default
Εκτιμώμενες χρεώσεις για σύγκριση
Τιμές ανά διαμόρφωση
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Πίνακας χρεώσεων | Προβλεπόμενη ποσότητα | Χρέωση |
|---|---|---|---|
| ΔιαμόρφωσηΒασικές χρεώσεις token | Πίνακας χρεώσεωνΒασική χρέωση | Προβλεπόμενη ποσότητα— | Χρέωση Είσοδος · Token εισόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Έξοδος · Token εξόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα · Εκτίμηση μόνο για σύγκριση — / 1K token |
| ΔιαμόρφωσηΕκτιμώμενο κόστος δημιουργίας | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργία | Χρέωση Έξοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $1.24 εκτίμηση πριν από τη δημιουργία Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή. |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Παραδείγματα αιτημάτων
Ailoot Ultra · Βίντεο
{
"model": "dop-preview",
"params": {
"model": "dop-preview",
"prompt": "a cat",
"seed": 500000,
"motions": [
{
"id": "2bae49e6-ffe7-42a8-a73f-d44632c4acaa",
"strength": 0.5
}
],
"input_images": [
{
"type": "image_url",
"image_url": "YOUR_ACCESSIBLE_IMAGE_URL"
}
],
"enhance_prompt": true,
"check_nsfw": true
}
}set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_POLL'
import json
from pathlib import Path
from urllib.parse import quote,urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
i=r.get("id")
if not isinstance(i,str) or not i:raise SystemExit("Keep original response/headers/id; do not resubmit creation.")
u=urljoin("https://api.ailoot.ai",r.get("polling_url") or "/v1/videos/"+quote(i,safe=""))
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/videos/"):raise SystemExit("Use the actual Ailoot lookup path.")
Path("poll-url.txt").write_text(u)
PY_POLL
curl --fail-with-body --silent --show-error "$(cat poll-url.txt)" -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
Λήψη και αποθήκευση αποτελεσμάτων
Ailoot Ultra · Βίντεο
Διατηρήστε τις εργασίες που επιστρέφονται και τις καταστάσεις τους. Διαβάστε κάθε ολοκληρωμένο αποτέλεσμα βίντεο που σας ανήκει.
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα
Αποθηκεύστε κάθε ολοκληρωμένο βίντεο ή αρχείο που επιστρέφεται· ανακτήστε κάθε πραγματικό URL αρχείου που επιστρέφεται.
Ανακτήστε κάθε πραγματική ολοκληρωμένη έξοδο· μην υποθέτετε σταθερό πλήθος.
Αν χρειάζεται έλεγχος της αρχικής απάντησης
Διατηρήστε την αρχική απόκριση και την ταυτότητα εργασίας που επιστρέφεται· μη αναγνωρισμένη κατάσταση ή αποστολή με αβέβαιο αποτέλεσμα δεν επιτρέπει νέα δημιουργία.
Πεδία απάντησης
| Πεδίο | Τύπος | Σημασία |
|---|---|---|
Πεδίοid | Τύποςstring | ΣημασίαΔημόσιο αναγνωριστικό εργασίας ή λειτουργίας του Ailoot. |
Πεδίοprovider_task_id | Τύποςstring | ΣημασίαΑρχικό αναγνωριστικό εργασίας, ξεχωριστό από το δημόσιο id. |
Πεδίοpolling_url | Τύποςstring | ΣημασίαΔιαδρομή αναζήτησης Ailoot που επιστρέφεται. |
Πεδίοjobs[].id | Τύποςstring | ΣημασίαΠραγματικό αναγνωριστικό εργασίας που επιστρέφεται. |
Πεδίοjobs[].status | Τύποςstring | ΣημασίαΚατάσταση κάθε εργασίας που επιστρέφεται. |
Πεδίοjobs[].results.raw.url | Τύποςstring | ΣημασίαΚάθε ολοκληρωμένο βίντεο διατίθεται μέσω υπογεγραμμένου URL που ανήκει στο Ailoot. |
Σφάλματα και επόμενα βήματα
| Απάντηση | Συνθήκη | Επόμενο βήμα |
|---|---|---|
Απάντηση400 · invalid_request_error | ΣυνθήκηΜη έγκυρο JSON ή μοντέλο, ή μη έγκυρος δείκτης περιεχομένου. | Επόμενο βήμα |
Απάντηση401 · authentication_error | ΣυνθήκηΜη έγκυρο κλειδί API του Ailoot. | Επόμενο βήμα |
Απάντηση403 · permission_error | ΣυνθήκηΗ ομάδα του κλειδιού API δεν έχει άδεια πρόσβασης σε αυτή τη διαδρομή πολυμέσων. | Επόμενο βήμα |
Απάντηση404 · not_found_error | ΣυνθήκηΗ αρχική εργασία ή η ζητούμενη έξοδος απουσιάζει ή δεν ανήκει στον ίδιο χρήστη, κλειδί API ή ομάδα. | Επόμενο βήμα |
Απάντηση502 · result_pending_check | ΣυνθήκηΗ αρχική υποβολή ή η κατάστασή της είναι ελλιπής ή δεν μπορεί να αντιστοιχιστεί στα διαθέσιμα στοιχεία· διατηρήστε το αρχικό ID και μην επανυποβάλετε το αίτημα. | Επόμενο βήμα |
Απάντηση503 · result_pending_check | ΣυνθήκηΗ αρχική συσχέτιση, η διαδρομή ή τα πολυμέσα που σας ανήκουν εξακολουθούν να ελέγχονται· συνεχίστε τον έλεγχο αυτής της αρχικής λειτουργίας. | Επόμενο βήμα |
Απάντηση503 · server_error | ΣυνθήκηΗ υπηρεσία πολυμέσων ή ο χώρος αποθήκευσης της αρχικής εργασίας δεν είναι διαθέσιμος. | Επόμενο βήμα |
Εναλλακτικά ονόματα
Εναλλακτικά ονόματα μοντέλου
Ailoot Ultra dop-preview
Εναλλακτικές διαδρομές μεθόδων
/v1/videos/generations
Σχετικά ID μοντέλων
FAQ · Higgsfield: DOP Preview
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/videos·dop-preview:image,text→video- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/videos·dop-preview:model,params,webhook,callback- Ποια όρια ισχύουν;
POST /v1/videos·dop-preview:params.motions[].strength.minimum:0;params.motions[].strength.maximum:1;params.seed.minimum:1;params.seed.maximum:1000000