# Parametri

Vsak model ohrani svoja izvorna imena parametrov, vsaka stran modela pa jih tudi navaja. Poleg tega API sprejema
**kanonična imena** za parametre, ki imajo v vseh modelih enak pomen, zato koda, napisana za en model, deluje
tudi pri naslednjem z manj spremembami.

## Kanonična imena

| Kanonično ime | Pomen | Običajna izvorna imena |
|---|---|---|
| `image` | Vhodna slika ali slika prvega kadra | `image_url`, `start_image_url`, `first_frame_url`, `first_image_url`, `source_image_url` |
| `end_image` | Slika zadnjega kadra | `end_image_url`, `last_frame_url`, `tail_image_url` |
| `images` | Seznam referenčnih slik | `image_urls`, `reference_image_urls` |
| `video` | Vhodni videoposnetek | `video_url` |
| `videos` | Seznam referenčnih videoposnetkov | `video_urls` |
| `audio` | Vhodni zvok | `audio_url` |
| `audios` | Seznam referenčnih zvočnih posnetkov | `audio_urls` |
| `mask` | Maska slike | `mask_url` |
| `num_outputs` | Število rezultatov za ustvarjanje | `num_images` |
| `generate_audio` | Ustvari zvok z videoposnetkom | `generate_audio_switch`, `enable_audio` |

Na katero izvorno polje se kanonično ime preslika v vsakem trenutnem modelu:

| Kanonično ime | Izvorno polje (modeli, ki ga uporabljajo) |
|---|---|
| `audio` | `audio_url` (modelov: 126) |
| `audios` | `audio_urls` (modelov: 7), `reference_audio_urls` (modelov: 1) |
| `end_image` | `end_image_url` (modelov: 76), `last_frame_url` (modelov: 12), `tail_image_url` (modelov: 1) |
| `generate_audio` | `generate_audio_switch` (modelov: 16), `audio` (modelov: 3) |
| `image` | `image_url` (modelov: 529), `start_image_url` (modelov: 20), `first_frame_url` (modelov: 12), `first_image_url` (modelov: 7), `source_image_url` (modelov: 2) |
| `images` | `image_urls` (modelov: 148), `reference_image_urls` (modelov: 31) |
| `mask` | `mask_url` (modelov: 46) |
| `num_outputs` | `num_images` (modelov: 337) |
| `video` | `video_url` (modelov: 197) |
| `videos` | `video_urls` (modelov: 13), `reference_video_urls` (modelov: 1) |

Pravila:

- Pošljite kanonično ali izvorno ime. Če pošljete obe imeni z različnima vrednostma, klic ne uspe z
  `422 invalid_input` za kanonično ime.
- Parameter, ki ni niti izvorno niti kanonično ime modela, je zavrnjen z `422 invalid_input`
  (»Unknown parameter«), skupaj s predlogom najbližjega veljavnega imena. Tipkarske napake nikoli ne ostanejo neopažene.
- Vsaka stran modela prikazuje obe imeni drugo ob drugem.

## Pretvorba tipov

Vrednosti se pretvorijo v tip, ki ga pričakuje model, zato delujejo vsi ti primeri:

| Pošljete | Model pričakuje | Rezultat |
|---|---|---|
| `5`, `"5"`, `"5s"` | `duration` kot niz, na primer `"5"` | `"5"` |
| `"8"` | celo število | `8` |
| `"1080P"`, `"4K"` | `resolution`, na primer `"1080p"`, `"4k"` | natančen dovoljeni zapis |
| `"true"`, `"false"`, `1`, `0` | logična vrednost | `true`, `false` |
| `"https://…/a.jpg"` | seznam URL-jev | `["https://…/a.jpg"]` |
| `42` | niz | `"42"` |

Dovoljene vrednosti se najpre primerjajo natančno, nato brez upoštevanja velikosti črk in nazadnje kot števila (`5` se ujema z vrednostmi
`"5"`, `"5s"` in v slogu `"5 s"`).

## Privzete vrednosti

Parametri, ki jih izpustite, uporabijo privzeto vrednost modela, navedeno v tabeli parametrov modela. Cena se
izračuna z enakimi privzetimi vrednostmi (na primer model videoposnetkov, pri katerem je `generate_audio` privzeto
`true`, se obračuna z zvokom, razen če pošljete `"generate_audio": false`).

## Datotečni parametri

Parametri za slike, videoposnetke in zvok sprejemajo javni URL, `data:` URI do velikosti 10 MB ali `file_url` naložene datoteke.
Glejte [Datoteke](https://doitong.com/developers/docs/files).