# Parametra

Sako modelo garavarel peske originalne parametrenca, thaj sako modelo página len sikavel. Upre kodoleske, API leske lidar mangipena
**kanonicko navenca** vaš e parametrura save značinen jekhajekh sar sa modelura, vašoda kodo ramome vaš jekh modelo kerel buti
avreha modelosa bi bare promena.

## Kanonicko nava

| Kanonicko nav | So značinel | Tipicko originalne nava |
|---|---|---|
| `image` | O inputo vaj e angluno-framako kipo | `image_url`, `start_image_url`, `first_frame_url`, `first_image_url`, `source_image_url` |
| `end_image` | O paluno-framako kipo | `end_image_url`, `last_frame_url`, `tail_image_url` |
| `images` | Jekh lista referencijake kipengo | `image_urls`, `reference_image_urls` |
| `video` | O inputo video | `video_url` |
| `videos` | Jekh lista referencijake videongo | `video_urls` |
| `audio` | O inputo audio | `audio_url` |
| `audios` | Jekh lista referencijake audio-klipongo | `audio_urls` |
| `mask` | Jekh maskako kipo | `mask_url` |
| `num_outputs` | Keci rezultatja te kerel | `num_images` |
| `generate_audio` | Te kerel šundipen jekhe videosa | `generate_audio_switch`, `enable_audio` |

Savo originalno fieldo savo kanonicko navik mapinel pe sako akana modelos:

| Kanonikano nav | Native field (modelura save les) |
|---|---|
| `audio` | `audio_url` (modelura: 126) |
| `audios` | `audio_urls` (modelura: 7), `reference_audio_urls` (modelura: 1) |
| `end_image` | `end_image_url` (modelura: 76), `last_frame_url` (modelura: 12), `tail_image_url` (modelura: 1) |
| `generate_audio` | `generate_audio_switch` (modelura: 16), `audio` (modelura: 3) |
| `image` | `image_url` (modelura: 529), `start_image_url` (modelura: 20), `first_frame_url` (modelura: 12), `first_image_url` (modelura: 7), `source_image_url` (modelura: 2) |
| `images` | `image_urls` (modelura: 148), `reference_image_urls` (modelura: 31) |
| `mask` | `mask_url` (modelura: 46) |
| `num_outputs` | `num_images` (modelura: 337) |
| `video` | `video_url` (modelura: 197) |
| `videos` | `video_urls` (modelura: 13), `reference_video_urls` (modelura: 1) |

Niyama:

- Bikin vaj e kanonicko nava vaj e originalno nava. Te bičhaves dujenca aver vrednostja, o callo našti kerel pes le `422 invalid_input` pe kanonicko nave.
- Jekh parametro savo na si ni originalno ni kanonicko nav le modelosko, palal pes le `422 invalid_input` ("Unknown parameter"), le pašutne validne naveha sar sugestia. Tipura nikdy na džan čhingardine.
- Sako modelo página sikavel duj nava paš paš.

## Tipako konverzia

E vrednostja paruvon ko tipo savo o modelo mangela, vašoda sa kadala kerena buti:

| So bičhaves | So o modelo mangel | Kerdyol |
|---|---|---|
| `5`, `"5"`, `"5s"` | `duration` sar stringo, vareso `"5"` | `"5"` |
| `"8"` | integero | `8` |
| `"1080P"`, `"4K"` | `resolution` vareso `"1080p"`, `"4k"` | o čačuno lilavipen savo si mangel | 
| `"true"`, `"false"`, `1`, `0` | booleano | `true`, `false` |
| `"https://…/a.jpg"` | jekh lista URL-engo | `["https://…/a.jpg"]` |
| `42` | stringo | `"42"` |

E dozvolime vrednostja anglunes paruven pes čačes, palal bi te dikhel pes o lilavipen, thaj palal sar nura (`5` arakhel `"5"`, `"5s"` thaj `"5 s"` stilosa vrednostja).

## Standardno vrednostja

E parametrura save mukhes avri len o standardno le modelosko, savo si lilondo ko modelosko parametrengo tabelo. O molipe kerel pes le sajekh standardne vrednostenca (vareso, jekh video-modelo savo `generate_audio` standardno si `true`, molinel pes šundipnaha, te na bičhaves `"generate_audio": false`).

## Fajlengo parametra

Kipengo, videongo thaj audioko parametra len jekh publiko URL, jekh `data:` URI dži ko 10 MB, vaj o `file_url` jekhe uploadosko.
Dikh [Files](https://doitong.com/developers/docs/files).