Οδηγός API

Παράμετροι

Προβολή ως Markdown Ενημερώθηκε 2026-10-22

Κάθε μοντέλο διατηρεί τα εγγενή ονόματα παραμέτρων του και κάθε σελίδα μοντέλου τα παραθέτει. Επιπλέον, το API αποδέχεται κανονικοποιημένα ονόματα για τις παραμέτρους που σημαίνουν το ίδιο σε κάθε μοντέλο, ώστε ο κώδικας που γράφτηκε για ένα μοντέλο να λειτουργεί στο επόμενο με λιγότερες αλλαγές.

Κανονικοποιημένα ονόματα

Κανονικοποιημένο όνομα	Σημασία	Συνήθη εγγενή ονόματα
`image`	Η εικόνα εισόδου ή του πρώτου καρέ	`image_url`, `start_image_url`, `first_frame_url`, `first_image_url`, `source_image_url`
`end_image`	Η εικόνα του τελευταίου καρέ	`end_image_url`, `last_frame_url`, `tail_image_url`
`images`	Μια λίστα εικόνων αναφοράς	`image_urls`, `reference_image_urls`
`video`	Το βίντεο εισόδου	`video_url`
`videos`	Μια λίστα βίντεο αναφοράς	`video_urls`
`audio`	Ο ήχος εισόδου	`audio_url`
`audios`	Μια λίστα κλιπ ήχου αναφοράς	`audio_urls`
`mask`	Μια εικόνα μάσκας	`mask_url`
`num_outputs`	Πόσα αποτελέσματα θα δημιουργηθούν	`num_images`
`generate_audio`	Δημιουργία ήχου μαζί με το βίντεο	`generate_audio_switch`, `enable_audio`

Σε ποιο εγγενές πεδίο αντιστοιχίζεται ένα κανονικοποιημένο όνομα σε κάθε τρέχον μοντέλο:

Κανονικό όνομα	Εγγενές πεδίο (μοντέλα που το χρησιμοποιούν)
`audio`	`audio_url` (μοντέλα: 126)
`audios`	`audio_urls` (μοντέλα: 7), `reference_audio_urls` (μοντέλα: 1)
`end_image`	`end_image_url` (μοντέλα: 76), `last_frame_url` (μοντέλα: 12), `tail_image_url` (μοντέλα: 1)
`generate_audio`	`generate_audio_switch` (μοντέλα: 16), `audio` (μοντέλα: 3)
`image`	`image_url` (μοντέλα: 529), `start_image_url` (μοντέλα: 20), `first_frame_url` (μοντέλα: 12), `first_image_url` (μοντέλα: 7), `source_image_url` (μοντέλα: 2)
`images`	`image_urls` (μοντέλα: 148), `reference_image_urls` (μοντέλα: 31)
`mask`	`mask_url` (μοντέλα: 46)
`num_outputs`	`num_images` (μοντέλα: 337)
`video`	`video_url` (μοντέλα: 197)
`videos`	`video_urls` (μοντέλα: 13), `reference_video_urls` (μοντέλα: 1)

Κανόνες:

Στείλτε είτε το κανονικοποιημένο είτε το εγγενές όνομα. Αν στείλετε και τα δύο με διαφορετικές τιμές, η κλήση αποτυγχάνει με 422 invalid_input για το κανονικοποιημένο όνομα.
Μια παράμετρος που δεν είναι ούτε εγγενές ούτε κανονικοποιημένο όνομα του μοντέλου απορρίπτεται με 422 invalid_input ("Unknown parameter"), μαζί με πρόταση για το πλησιέστερο έγκυρο όνομα. Τα τυπογραφικά λάθη δεν περνούν ποτέ σιωπηρά.
Κάθε σελίδα μοντέλου εμφανίζει και τα δύο ονόματα το ένα δίπλα στο άλλο.

Μετατροπή τύπων

Οι τιμές μετατρέπονται στον τύπο που αναμένει το μοντέλο, επομένως όλα τα παρακάτω λειτουργούν:

Στέλνετε	Το μοντέλο αναμένει	Μετατρέπεται σε
`5`, `"5"`, `"5s"`	`duration` ως συμβολοσειρά, όπως `"5"`	`"5"`
`"8"`	έναν ακέραιο	`8`
`"1080P"`, `"4K"`	`resolution`, όπως `"1080p"`, `"4k"`	την ακριβή επιτρεπόμενη γραφή
`"true"`, `"false"`, `1`, `0`	μια δυαδική τιμή	`true`, `false`
`"https://…/a.jpg"`	μια λίστα URL	`["https://…/a.jpg"]`
`42`	μια συμβολοσειρά	`"42"`

Οι επιτρεπόμενες τιμές αντιστοιχίζονται πρώτα ακριβώς, έπειτα χωρίς διάκριση πεζών-κεφαλαίων και τέλος ως αριθμοί (5 αντιστοιχεί σε τιμές όπως "5", "5s" και "5 s").

Προεπιλογές

Οι παράμετροι που παραλείπετε χρησιμοποιούν την προεπιλογή του μοντέλου, η οποία αναφέρεται στον πίνακα παραμέτρων του μοντέλου. Η τιμή υπολογίζεται με τις ίδιες προεπιλογές (για παράδειγμα, ένα μοντέλο βίντεο του οποίου το generate_audio έχει προεπιλογή true τιμολογείται με ήχο, εκτός αν στείλετε "generate_audio": false).