# Parametri

Svaki model zadržava svoje izvorne nazive parametara, a svaka stranica modela navodi ih. Osim toga, API prihvaća
**kanonske nazive** za parametre koji imaju isto značenje na svakom modelu, pa kod napisan za jedan model funkcionira
i za sljedeći uz manje izmjena.

## Kanonski nazivi

| Kanonski naziv | Značenje | Uobičajeni izvorni nazivi |
|---|---|---|
| `image` | Ulazna slika ili slika prvog kadra | `image_url`, `start_image_url`, `first_frame_url`, `first_image_url`, `source_image_url` |
| `end_image` | Slika posljednjeg kadra | `end_image_url`, `last_frame_url`, `tail_image_url` |
| `images` | Popis referentnih slika | `image_urls`, `reference_image_urls` |
| `video` | Ulazni videozapis | `video_url` |
| `videos` | Popis referentnih videozapisa | `video_urls` |
| `audio` | Ulazni zvuk | `audio_url` |
| `audios` | Popis referentnih zvučnih isječaka | `audio_urls` |
| `mask` | Slikovna maska | `mask_url` |
| `num_outputs` | Broj rezultata koje treba generirati | `num_images` |
| `generate_audio` | Generiranje zvuka uz videozapis | `generate_audio_switch`, `enable_audio` |

Na koje se izvorno polje kanonski naziv preslikava u svakom trenutačnom modelu:

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

Pravila:

- Pošaljite kanonski ili izvorni naziv. Ako pošaljete oba s različitim vrijednostima, poziv neće uspjeti s
  `422 invalid_input` na kanonskom nazivu.
- Parametar koji nije ni izvorni ni kanonski naziv modela odbija se s `422 invalid_input`
  ("Nepoznati parametar"), uz prijedlog najbližeg valjanog naziva. Tipfeleri nikad ne prolaze neprimijećeno.
- Svaka stranica modela prikazuje oba naziva jedan uz drugi.

## Prisilna konverzija tipova

Vrijednosti se pretvaraju u tip koji model očekuje, pa svi ovi primjeri funkcioniraju:

| Šaljete | Model očekuje | Postaje |
|---|---|---|
| `5`, `"5"`, `"5s"` | `duration` kao niz znakova, primjerice `"5"` | `"5"` |
| `"8"` | cijeli broj | `8` |
| `"1080P"`, `"4K"` | `resolution`, primjerice `"1080p"`, `"4k"` | točan dopušteni zapis |
| `"true"`, `"false"`, `1`, `0` | Booleova vrijednost | `true`, `false` |
| `"https://…/a.jpg"` | popis URL-ova | `["https://…/a.jpg"]` |
| `42` | niz znakova | `"42"` |

Dopuštene vrijednosti najprije se uspoređuju potpuno jednako, zatim bez obzira na velika i mala slova, a potom kao brojevi (`5` odgovara vrijednostima `"5"`, `"5s"` i oblika
`"5 s"`).

## Zadane vrijednosti

Parametri koje izostavite koriste zadanu vrijednost modela, navedenu u tablici parametara modela. Cijena se
izračunava s istim zadanim vrijednostima (na primjer, model videozapisa čiji je zadani `generate_audio` postavljen na
`true` obračunava se sa zvukom ako ne pošaljete `"generate_audio": false`).

## Datotečni parametri

Parametri za slike, videozapise i zvuk prihvaćaju javni URL, `data:` URI veličine do 10 MB ili `file_url` prenesene datoteke.
Pogledajte [Datoteke](https://doitong.com/developers/docs/files).