# Παράμετροι

Κάθε μοντέλο διατηρεί τα εγγενή ονόματα παραμέτρων του και κάθε σελίδα μοντέλου τα παραθέτει. Επιπλέον, το 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`).

## Παράμετροι αρχείων

Οι παράμετροι εικόνας, βίντεο και ήχου δέχονται δημόσιο URL, ένα URI `data:` έως 10 MB ή το `file_url` ενός μεταφορτωμένου αρχείου.
Δείτε [Αρχεία](https://doitong.com/developers/docs/files).