# Parameters

Mintga model conserva ses nums da parameter nativs, e mintga pagina dal model als enumera. Ultra da quai accepta l'API
**nums canonics** per ils parameters che han il medem senn en mintga model, uschia che il code scrit per in model funcziuna
per il proxim cun damain midadas.

## Numers canonics

| Num canonic | Senn | Numers nativs tipics |
|---|---|---|
| `image` | Il maletg d'input u dal prim frame | `image_url`, `start_image_url`, `first_frame_url`, `first_image_url`, `source_image_url` |
| `end_image` | Il maletg da l'ultim frame | `end_image_url`, `last_frame_url`, `tail_image_url` |
| `images` | Ina glista da maletgs da referenza | `image_urls`, `reference_image_urls` |
| `video` | Il video d'input | `video_url` |
| `videos` | Ina glista da videos da referenza | `video_urls` |
| `audio` | L'audio d'input | `audio_url` |
| `audios` | Ina glista da clips d'audio da referenza | `audio_urls` |
| `mask` | In maletg da mascrà | `mask_url` |
| `num_outputs` | Quantas resultatas generar | `num_images` |
| `generate_audio` | Generar tun cun il video | `generate_audio_switch`, `enable_audio` |

A qual champ nativ in num canonic correspunda en mintga model actual:

| Num canonic | Champ nativ (models che l’utiliseschan) |
|---|---|
| `audio` | `audio_url` (models: 126) |
| `audios` | `audio_urls` (models: 7), `reference_audio_urls` (models: 1) |
| `end_image` | `end_image_url` (models: 76), `last_frame_url` (models: 12), `tail_image_url` (models: 1) |
| `generate_audio` | `generate_audio_switch` (models: 16), `audio` (models: 3) |
| `image` | `image_url` (models: 529), `start_image_url` (models: 20), `first_frame_url` (models: 12), `first_image_url` (models: 7), `source_image_url` (models: 2) |
| `images` | `image_urls` (models: 148), `reference_image_urls` (models: 31) |
| `mask` | `mask_url` (models: 46) |
| `num_outputs` | `num_images` (models: 337) |
| `video` | `video_url` (models: 197) |
| `videos` | `video_urls` (models: 13), `reference_video_urls` (models: 1) |

Reglas:

- Trametta u il num canonic u quel nativ. Sche ti tramettas omisdus cun valurs differentas, la clamada vegn refusada cun
  `422 invalid_input` sin il num canonic.
- In parameter che n'è ni in num nativ ni in num canonic dal model vegn refusà cun `422 invalid_input`
  ("Unknown parameter"), cun il num valid il pli datiers sco proposta. Typoes na passan mai senza vegnir remartgads.
- Mintga pagina dal model mussa ils dus nums in sper l'auter.

## Converziun dal tip

Las valurs vegnan convertidas al tip che il model spetga, uschia che tut quai funcziuna:

| Ti tramettas | Il model spetga | Daventa |
|---|---|---|
| `5`, `"5"`, `"5s"` | `duration` sco stringa, per exempel `"5"` | `"5"` |
| `"8"` | in entir | `8` |
| `"1080P"`, `"4K"` | `resolution` sco `"1080p"`, `"4k"` | l'ortografia exacta permessa |
| `"true"`, `"false"`, `1`, `0` | in boolean | `true`, `false` |
| `"https://…/a.jpg"` | ina glista da URLs | `["https://…/a.jpg"]` |
| `42` | ina stringa | `"42"` |

Las valurs permessas vegnan cumparegliadas l'emprim exactamain, alura senza resguardar maiusclas e minusclas, ed alura sco
nums (`5` correspunda a valurs en il stil da `"5"`, `"5s"` e `"5 s"`).

## Standards

Ils parameters che ti omettas utiliseschan il standard dal model, che vegn mussà en la tabella da parameters dal model. Il pretsch vegn
calculà cun ils medems standards (per exempel, in model da video il cui `generate_audio` ha sco standard `true` vegn valità cun
tun, nun che ti tramettas `"generate_audio": false`).

## Parameters da datotecas

Ils parameters da maletg, video ed audio acceptan ina URL publica, ina URI `data:` fin a 10 MB, u il `file_url` d'ina chargiada.
Vesa [Datotecas](https://doitong.com/developers/docs/files).