# Mga Parameter

Pinapanatili ng bawat modelo ang mga native na pangalan ng parameter nito, at inililista ang mga ito sa bawat pahina ng modelo. Bukod dito, tumatanggap ang API ng
**mga canonical na pangalan** para sa mga parameter na pareho ang kahulugan sa bawat modelo, kaya gumagana ang code na isinulat para sa isang modelo
sa susunod na modelo nang mas kaunti ang kailangang baguhin.

## Mga canonical na pangalan

| Canonical na pangalan | Kahulugan | Karaniwang native na pangalan |
|---|---|---|
| `image` | Ang input o larawan ng unang frame | `image_url`, `start_image_url`, `first_frame_url`, `first_image_url`, `source_image_url` |
| `end_image` | Ang larawan ng huling frame | `end_image_url`, `last_frame_url`, `tail_image_url` |
| `images` | Isang listahan ng mga reference na larawan | `image_urls`, `reference_image_urls` |
| `video` | Ang input na video | `video_url` |
| `videos` | Isang listahan ng mga reference na video | `video_urls` |
| `audio` | Ang input na audio | `audio_url` |
| `audios` | Isang listahan ng mga reference na audio clip | `audio_urls` |
| `mask` | Isang mask na larawan | `mask_url` |
| `num_outputs` | Kung ilang resulta ang bubuuin | `num_images` |
| `generate_audio` | Bumuo ng tunog kasama ng video | `generate_audio_switch`, `enable_audio` |

Aling native na field ang tinutukoy ng isang canonical na pangalan sa bawat kasalukuyang modelo:

| Canonical na pangalan | Native na field (mga modelong gumagamit nito) |
|---|---|
| `audio` | `audio_url` (mga modelo: 126) |
| `audios` | `audio_urls` (mga modelo: 7), `reference_audio_urls` (mga modelo: 1) |
| `end_image` | `end_image_url` (mga modelo: 76), `last_frame_url` (mga modelo: 12), `tail_image_url` (mga modelo: 1) |
| `generate_audio` | `generate_audio_switch` (mga modelo: 16), `audio` (mga modelo: 3) |
| `image` | `image_url` (mga modelo: 529), `start_image_url` (mga modelo: 20), `first_frame_url` (mga modelo: 12), `first_image_url` (mga modelo: 7), `source_image_url` (mga modelo: 2) |
| `images` | `image_urls` (mga modelo: 148), `reference_image_urls` (mga modelo: 31) |
| `mask` | `mask_url` (mga modelo: 46) |
| `num_outputs` | `num_images` (mga modelo: 337) |
| `video` | `video_url` (mga modelo: 197) |
| `videos` | `video_urls` (mga modelo: 13), `reference_video_urls` (mga modelo: 1) |

Mga panuntunan:

- Ipadala ang canonical na pangalan o ang native na pangalan. Kung pareho mong ipapadala ang mga ito na magkaiba ang halaga, mabibigo ang tawag sa
  `422 invalid_input` para sa canonical na pangalan.
- Tinatanggihan ang parameter na hindi native o canonical na pangalan ng modelo sa `422 invalid_input`
  ("Unknown parameter"), kasama ang pinakamalapit na wastong pangalan bilang mungkahi. Hindi kailanman tahimik na tinatanggap ang mga typo.
- Ipinapakita ng bawat pahina ng modelo ang parehong pangalan nang magkatabi.

## Pagko-convert ng type

Kino-convert ang mga value sa type na inaasahan ng modelo, kaya gumagana ang lahat ng ito:

| Ipinapadala mo | Inaasahan ng modelo | Nagiging |
|---|---|---|
| `5`, `"5"`, `"5s"` | `duration` bilang string gaya ng `"5"` | `"5"` |
| `"8"` | isang integer | `8` |
| `"1080P"`, `"4K"` | `resolution` gaya ng `"1080p"`, `"4k"` | ang eksaktong pinapahintulutang baybay |
| `"true"`, `"false"`, `1`, `0` | isang boolean | `true`, `false` |
| `"https://…/a.jpg"` | isang listahan ng mga URL | `["https://…/a.jpg"]` |
| `42` | isang string | `"42"` |

Eksaktong itinutugma muna ang mga pinapahintulutang value, pagkatapos ay hindi isinasaalang-alang ang laki ng titik, at pagkatapos ay bilang (`5` ay tumutugma sa mga value na gaya ng `"5"`, `"5s"` at
`"5 s"`).

## Mga Default

Ginagamit ng mga parameter na hindi mo isinama ang default ng modelo, na nakalista sa talahanayan ng mga parameter ng modelo. Kinukuwenta ang presyo
ayon sa parehong mga default (halimbawa, ang isang modelo ng video na ang default ng `generate_audio` ay `true` ay sinisingil nang may
tunog maliban kung ipapadala mo ang `"generate_audio": false`).

## Mga parameter ng file

Tumatanggap ang mga parameter ng larawan, video at audio ng pampublikong URL, isang `data:` URI na hanggang 10 MB, o ang `file_url` ng isang upload.
Tingnan ang [Mga file](https://doitong.com/developers/docs/files).