# Parametry

Každý model zachovává své nativní názvy parametrů a každá stránka modelu je uvádí. Kromě toho API přijímá
**kanonické názvy** parametrů, které mají ve všech modelech stejný význam, takže kód napsaný pro jeden model funguje
i pro další model s menším počtem změn.

## Kanonické názvy

| Kanonický název | Význam | Typické nativní názvy |
|---|---|---|
| `image` | Vstupní obrázek nebo obrázek prvního snímku | `image_url`, `start_image_url`, `first_frame_url`, `first_image_url`, `source_image_url` |
| `end_image` | Obrázek posledního snímku | `end_image_url`, `last_frame_url`, `tail_image_url` |
| `images` | Seznam referenčních obrázků | `image_urls`, `reference_image_urls` |
| `video` | Vstupní video | `video_url` |
| `videos` | Seznam referenčních videí | `video_urls` |
| `audio` | Vstupní zvuk | `audio_url` |
| `audios` | Seznam referenčních zvukových klipů | `audio_urls` |
| `mask` | Obrázek masky | `mask_url` |
| `num_outputs` | Kolik výsledků vygenerovat | `num_images` |
| `generate_audio` | Generovat zvuk společně s videem | `generate_audio_switch`, `enable_audio` |

Na které nativní pole se kanonický název mapuje v každém aktuálním modelu:

| Kanonický název | Nativní pole (modely, které ho používají) |
|---|---|
| `audio` | `audio_url` (modelů: 126) |
| `audios` | `audio_urls` (modelů: 7), `reference_audio_urls` (modelů: 1) |
| `end_image` | `end_image_url` (modelů: 76), `last_frame_url` (modelů: 12), `tail_image_url` (modelů: 1) |
| `generate_audio` | `generate_audio_switch` (modelů: 16), `audio` (modelů: 3) |
| `image` | `image_url` (modelů: 529), `start_image_url` (modelů: 20), `first_frame_url` (modelů: 12), `first_image_url` (modelů: 7), `source_image_url` (modelů: 2) |
| `images` | `image_urls` (modelů: 148), `reference_image_urls` (modelů: 31) |
| `mask` | `mask_url` (modelů: 46) |
| `num_outputs` | `num_images` (modelů: 337) |
| `video` | `video_url` (modelů: 197) |
| `videos` | `video_urls` (modelů: 13), `reference_video_urls` (modelů: 1) |

Pravidla:

- Odešlete buď kanonický název, nebo nativní název. Pokud odešlete oba s různými hodnotami, volání selže s
  `422 invalid_input` u kanonického názvu.
- Parametr, který není nativním ani kanonickým názvem modelu, je odmítnut s `422 invalid_input`
  ("Unknown parameter") a jako návrh je uveden nejbližší platný název. Překlepy nikdy neprojdou bez upozornění.
- Každá stránka modelu zobrazuje oba názvy vedle sebe.

## Převod typů

Hodnoty se převádějí na typ očekávaný modelem, takže fungují všechny tyto varianty:

| Odešlete | Model očekává | Výsledek |
|---|---|---|
| `5`, `"5"`, `"5s"` | `duration` jako řetězec, například `"5"` | `"5"` |
| `"8"` | celé číslo | `8` |
| `"1080P"`, `"4K"` | `resolution`, například `"1080p"`, `"4k"` | přesný povolený zápis |
| `"true"`, `"false"`, `1`, `0` | logická hodnota | `true`, `false` |
| `"https://…/a.jpg"` | seznam URL | `["https://…/a.jpg"]` |
| `42` | řetězec | `"42"` |

Povolené hodnoty se nejprve porovnávají přesně, poté bez ohledu na velikost písmen a nakonec jako čísla (`5` odpovídá
hodnotám ve stylu `"5"`, `"5s"` a `"5 s"`).

## Výchozí hodnoty

Parametry, které vynecháte, použijí výchozí hodnotu modelu uvedenou v tabulce parametrů modelu. Cena se
vypočítává se stejnými výchozími hodnotami (například video model, jehož `generate_audio` má výchozí hodnotu `true`,
je oceněn včetně zvuku, pokud neodešlete `"generate_audio": false`).

## Parametry souborů

Parametry obrázků, videí a zvuku přijímají veřejnou URL, URI `data:` o velikosti až 10 MB nebo hodnotu `file_url` nahraného souboru.
Viz [Files](https://doitong.com/developers/docs/files).