# Parametrai

Kiekvienas modelis išsaugo savo vietinius parametrų pavadinimus, o kiekviename modelio puslapyje jie pateikiami. Be to, API priima
**kanoninius pavadinimus** parametrams, kurie visuose modeliuose reiškia tą patį, todėl vienam modeliui parašytas kodas veikia
ir su kitu, atliekant mažiau pakeitimų.

## Kanoniniai pavadinimai

| Kanoninis pavadinimas | Reikšmė | Įprasti vietiniai pavadinimai |
|---|---|---|
| `image` | Įvesties arba pirmojo kadro vaizdas | `image_url`, `start_image_url`, `first_frame_url`, `first_image_url`, `source_image_url` |
| `end_image` | Paskutinio kadro vaizdas | `end_image_url`, `last_frame_url`, `tail_image_url` |
| `images` | Etaloninių vaizdų sąrašas | `image_urls`, `reference_image_urls` |
| `video` | Įvesties vaizdo įrašas | `video_url` |
| `videos` | Etaloninių vaizdo įrašų sąrašas | `video_urls` |
| `audio` | Įvesties garsas | `audio_url` |
| `audios` | Etaloninių garso įrašų sąrašas | `audio_urls` |
| `mask` | Kaukės vaizdas | `mask_url` |
| `num_outputs` | Kiek rezultatų sugeneruoti | `num_images` |
| `generate_audio` | Generuoti garsą kartu su vaizdo įrašu | `generate_audio_switch`, `enable_audio` |

Į kurį vietinį lauką kiekviename dabartiniame modelyje susiejamas kanoninis pavadinimas:

| Kanoninis pavadinimas | Gimtasis laukas (jį naudojantys modeliai) |
|---|---|
| `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) |

Taisyklės:

- Siųskite arba kanoninį pavadinimą, arba vietinį. Jei siunčiate abu su skirtingomis reikšmėmis, iškvietimas nepavyksta su
  `422 invalid_input` kanoniniam pavadinimui.
- Parametras, kuris nėra nei vietinis, nei kanoninis modelio pavadinimas, atmetamas su `422 invalid_input`
  ("Unknown parameter"), kartu pateikiant artimiausią tinkamą pavadinimą kaip pasiūlymą. Rašybos klaidos niekada nepraleidžiamos nepastebėtos.
- Kiekviename modelio puslapyje abu pavadinimai rodomi greta.

## Tipų konvertavimas

Reikšmės konvertuojamos į modelio laukiamą tipą, todėl veikia visi šie variantai:

| Siunčiate | Modelis tikisi | Tampa |
|---|---|---|
| `5`, `"5"`, `"5s"` | `duration` kaip eilutės, pvz., `"5"` | `"5"` |
| `"8"` | sveikojo skaičiaus | `8` |
| `"1080P"`, `"4K"` | `resolution`, pvz., `"1080p"`, `"4k"` | tikslus leidžiamas rašybos variantas |
| `"true"`, `"false"`, `1`, `0` | loginės reikšmės | `true`, `false` |
| `"https://…/a.jpg"` | URL sąrašo | `["https://…/a.jpg"]` |
| `42` | eilutės | `"42"` |

Pirmiausia leidžiamos reikšmės sutapatinamos tiksliai, tada neatsižvelgiant į raidžių registrą, o galiausiai kaip skaičiai (`5` sutampa su `"5"`, `"5s"` ir
`"5 s"` tipo reikšmėmis).

## Numatytoji reikšmė

Nepateikti parametrai naudoja modelio numatytąsias reikšmes, kurios nurodytos modelio parametrų lentelėje. Kaina
apskaičiuojama naudojant tas pačias numatytąsias reikšmes (pavyzdžiui, vaizdo įrašų modelio, kurio `generate_audio` numatytoji reikšmė yra `true`, kaina skaičiuojama
su garsu, nebent siunčiate `"generate_audio": false`).

## Failų parametrai

Vaizdo, vaizdo įrašų ir garso parametrai priima viešą URL, ne didesnį nei 10 MB `data:` URI arba įkelto failo `file_url`.
Žr. [Failai](https://doitong.com/developers/docs/files).