# Parametry

Każdy model zachowuje własne natywne nazwy parametrów, a na każdej stronie modelu znajduje się ich lista. Ponadto API akceptuje
**kanoniczne nazwy** parametrów, które oznaczają to samo w każdym modelu, dzięki czemu kod napisany dla jednego modelu działa
w kolejnym przy mniejszej liczbie zmian.

## Nazwy kanoniczne

| Nazwa kanoniczna | Znaczenie | Typowe nazwy natywne |
|---|---|---|
| `image` | Obraz wejściowy lub obraz pierwszej klatki | `image_url`, `start_image_url`, `first_frame_url`, `first_image_url`, `source_image_url` |
| `end_image` | Obraz ostatniej klatki | `end_image_url`, `last_frame_url`, `tail_image_url` |
| `images` | Lista obrazów referencyjnych | `image_urls`, `reference_image_urls` |
| `video` | Wideo wejściowe | `video_url` |
| `videos` | Lista referencyjnych plików wideo | `video_urls` |
| `audio` | Dźwięk wejściowy | `audio_url` |
| `audios` | Lista referencyjnych klipów audio | `audio_urls` |
| `mask` | Obraz maski | `mask_url` |
| `num_outputs` | Liczba wyników do wygenerowania | `num_images` |
| `generate_audio` | Generowanie dźwięku wraz z wideo | `generate_audio_switch`, `enable_audio` |

Natywne pole, na które mapuje nazwa kanoniczna w każdym obecnym modelu:

| Nazwa kanoniczna | Pole natywne (modele, które go używają) |
|---|---|
| `audio` | `audio_url` (modeli: 126) |
| `audios` | `audio_urls` (modeli: 7), `reference_audio_urls` (modeli: 1) |
| `end_image` | `end_image_url` (modeli: 76), `last_frame_url` (modeli: 12), `tail_image_url` (modeli: 1) |
| `generate_audio` | `generate_audio_switch` (modeli: 16), `audio` (modeli: 3) |
| `image` | `image_url` (modeli: 529), `start_image_url` (modeli: 20), `first_frame_url` (modeli: 12), `first_image_url` (modeli: 7), `source_image_url` (modeli: 2) |
| `images` | `image_urls` (modeli: 148), `reference_image_urls` (modeli: 31) |
| `mask` | `mask_url` (modeli: 46) |
| `num_outputs` | `num_images` (modeli: 337) |
| `video` | `video_url` (modeli: 197) |
| `videos` | `video_urls` (modeli: 13), `reference_video_urls` (modeli: 1) |

Zasady:

- Wyślij nazwę kanoniczną albo natywną. Jeśli wyślesz obie z różnymi wartościami, wywołanie zakończy się błędem
  `422 invalid_input` dla nazwy kanonicznej.
- Parametr, który nie jest nazwą natywną ani kanoniczną danego modelu, zostanie odrzucony z błędem `422 invalid_input`
  ("Unknown parameter"), wraz z sugestią najbliższej prawidłowej nazwy. Literówki nigdy nie są ignorowane.
- Na stronie każdego modelu obie nazwy są pokazane obok siebie.

## Konwersja typów

Wartości są konwertowane do typu oczekiwanego przez model, dlatego wszystkie poniższe przykłady działają:

| Wysyłasz | Model oczekuje | Wynik |
|---|---|---|
| `5`, `"5"`, `"5s"` | `duration` jako ciąg znaków, np. `"5"` | `"5"` |
| `"8"` | liczba całkowita | `8` |
| `"1080P"`, `"4K"` | `resolution`, np. `"1080p"`, `"4k"` | dokładna dozwolona pisownia |
| `"true"`, `"false"`, `1`, `0` | wartość logiczna | `true`, `false` |
| `"https://…/a.jpg"` | lista adresów URL | `["https://…/a.jpg"]` |
| `42` | ciąg znaków | `"42"` |

Dozwolone wartości są najpierw dopasowywane dokładnie, następnie bez uwzględniania wielkości liter, a na końcu jako liczby (`5` pasuje do wartości `"5"`, `"5s"` i
`"5 s"`).

## Wartości domyślne

Pominięte parametry używają wartości domyślnych modelu, które są podane w tabeli parametrów modelu. Cena jest
obliczana z użyciem tych samych wartości domyślnych (na przykład model wideo, którego `generate_audio` ma domyślną wartość
`true`, jest wyceniany z dźwiękiem, chyba że wyślesz `"generate_audio": false`).

## Parametry plików

Parametry obrazów, wideo i audio przyjmują publiczny adres URL, identyfikator URI `data:` o rozmiarze do 10 MB lub wartość `file_url` przesłanego pliku.
Zobacz [Pliki](https://doitong.com/developers/docs/files).