# Parametri

Kull mudell iżomm l-ismijiet nattivi tal-parametri tiegħu, u kull paġna tal-mudell telenkahom. Barra minn hekk, l-API taċċetta
**ismijiet kanoniċi** għall-parametri li jfissru l-istess ħaġa fuq kull mudell, sabiex il-kodiċi miktub għal mudell wieħed jaħdem
mal-mudell li jmiss b’inqas bidliet.

## Ismijiet kanoniċi

| Isem kanoniku | Tifsira | Ismijiet nattivi tipiċi |
|---|---|---|
| `image` | L-immaġni tal-input jew tal-ewwel frejm | `image_url`, `start_image_url`, `first_frame_url`, `first_image_url`, `source_image_url` |
| `end_image` | L-immaġni tal-aħħar frejm | `end_image_url`, `last_frame_url`, `tail_image_url` |
| `images` | Lista ta’ immaġnijiet ta’ referenza | `image_urls`, `reference_image_urls` |
| `video` | Il-vidjo tal-input | `video_url` |
| `videos` | Lista ta’ vidjos ta’ referenza | `video_urls` |
| `audio` | L-awdjo tal-input | `audio_url` |
| `audios` | Lista ta’ klipps tal-awdjo ta’ referenza | `audio_urls` |
| `mask` | Immaġni maskra | `mask_url` |
| `num_outputs` | Kemm għandhom jiġu ġġenerati riżultati | `num_images` |
| `generate_audio` | Iġġenera ħoss mal-vidjo | `generate_audio_switch`, `enable_audio` |

Liema qasam nattiv jiġi mmappjat ma’ isem kanoniku fuq kull mudell attwali:

| Isem kanoniku | Qasam nattiv (mudelli li jużawh) |
|---|---|
| `audio` | `audio_url` (mudelli: 126) |
| `audios` | `audio_urls` (mudelli: 7), `reference_audio_urls` (mudelli: 1) |
| `end_image` | `end_image_url` (mudelli: 76), `last_frame_url` (mudelli: 12), `tail_image_url` (mudelli: 1) |
| `generate_audio` | `generate_audio_switch` (mudelli: 16), `audio` (mudelli: 3) |
| `image` | `image_url` (mudelli: 529), `start_image_url` (mudelli: 20), `first_frame_url` (mudelli: 12), `first_image_url` (mudelli: 7), `source_image_url` (mudelli: 2) |
| `images` | `image_urls` (mudelli: 148), `reference_image_urls` (mudelli: 31) |
| `mask` | `mask_url` (mudelli: 46) |
| `num_outputs` | `num_images` (mudelli: 337) |
| `video` | `video_url` (mudelli: 197) |
| `videos` | `video_urls` (mudelli: 13), `reference_video_urls` (mudelli: 1) |

Regoli:

- Ibgħat jew l-isem kanoniku jew dak nattiv. Jekk tibgħat it-tnejn b’valuri differenti, is-sejħa tfalli bi
  `422 invalid_input` fuq l-isem kanoniku.
- Parametru li la huwa isem nattiv u lanqas isem kanoniku tal-mudell jiġi rrifjutat bi `422 invalid_input`
  ("Parametru mhux magħruf"), bl-eqreb isem validu bħala suġġeriment. Żbalji fit-tajpjar qatt ma jgħaddu mingħajr avviż.
- Kull paġna tal-mudell turi ż-żewġ ismijiet ħdejn xulxin.

## Konverżjoni tat-tip

Il-valuri jiġu kkonvertiti għat-tip li jistenna l-mudell, għalhekk dawn kollha jaħdmu:

| Int tibgħat | Il-mudell jistenna | Isir |
|---|---|---|
| `5`, `"5"`, `"5s"` | `duration` bħala string bħal `"5"` | `"5"` |
| `"8"` | numru sħiħ | `8` |
| `"1080P"`, `"4K"` | `resolution` bħal `"1080p"`, `"4k"` | l-ortografija eżatta permessa |
| `"true"`, `"false"`, `1`, `0` | valur Boolean | `true`, `false` |
| `"https://…/a.jpg"` | lista ta’ URLs | `["https://…/a.jpg"]` |
| `42` | string | `"42"` |

Il-valuri permessi jiġu mqabbla l-ewwel eżattament, imbagħad mingħajr ma jitqiesu l-ittri kbar u żgħar, u mbagħad bħala numri (`5` jaqbel ma’ `"5"`, `"5s"` u
valuri fl-istil ta’ `"5 s"`).

## Valuri prestabbiliti

Il-parametri li tħalli barra jużaw il-valur prestabbilit tal-mudell, li huwa elenkat fit-tabella tal-parametri tal-mudell. Il-prezz jiġi
kkalkulat bl-istess valuri prestabbiliti (pereżempju, mudell tal-vidjo li l-valur prestabbilit ta’ `generate_audio` tiegħu huwa `true` jiġi pprezzat bil-ħoss
sakemm ma tibgħatx `"generate_audio": false`).

## Parametri tal-fajls

Il-parametri tal-immaġni, tal-vidjo u tal-awdjo jaċċettaw URL pubbliku, URI `data:` sa 10 MB, jew `file_url` ta’ upload.
Ara [Fajls](https://doitong.com/developers/docs/files).