# Paraiméadair

Coinníonn gach samhail a hainmneacha paraiméadar dúchasacha, agus liostaíonn gach leathanach samhla iad. Ina theannta sin, glacann an API le
**hainmneacha canónacha** do na paraiméadair a chiallaíonn an rud céanna i ngach samhail, ionas go n-oibríonn cód a scríobhadh do shamhail amháin
leis an gcéad cheann eile agus níos lú athruithe de dhíth.

## Ainmneacha canónacha

| Ainm canónach | Brí | Ainmneacha dúchasacha tipiciúla |
|---|---|---|
| `image` | An íomhá ionchuir nó íomhá an chéad fhráma | `image_url`, `start_image_url`, `first_frame_url`, `first_image_url`, `source_image_url` |
| `end_image` | Íomhá an fhráma dheireanaigh | `end_image_url`, `last_frame_url`, `tail_image_url` |
| `images` | Liosta íomhánna tagartha | `image_urls`, `reference_image_urls` |
| `video` | An físeán ionchuir | `video_url` |
| `videos` | Liosta físeán tagartha | `video_urls` |
| `audio` | An fhuaim ionchuir | `audio_url` |
| `audios` | Liosta gearrthóg fuaime tagartha | `audio_urls` |
| `mask` | Íomhá masc | `mask_url` |
| `num_outputs` | Cé mhéad toradh atá le giniúint | `num_images` |
| `generate_audio` | Fuaim a ghiniúint leis an bhfíseán | `generate_audio_switch`, `enable_audio` |

Cén réimse dúchasach a mapáiltear ainm canónach chuige i ngach samhail reatha:

| Ainm canónach | Réimse dúchasach (samhlacha a úsáideann é) |
|---|---|
| `audio` | `audio_url` (samhlacha: 126) |
| `audios` | `audio_urls` (samhlacha: 7), `reference_audio_urls` (samhlacha: 1) |
| `end_image` | `end_image_url` (samhlacha: 76), `last_frame_url` (samhlacha: 12), `tail_image_url` (samhlacha: 1) |
| `generate_audio` | `generate_audio_switch` (samhlacha: 16), `audio` (samhlacha: 3) |
| `image` | `image_url` (samhlacha: 529), `start_image_url` (samhlacha: 20), `first_frame_url` (samhlacha: 12), `first_image_url` (samhlacha: 7), `source_image_url` (samhlacha: 2) |
| `images` | `image_urls` (samhlacha: 148), `reference_image_urls` (samhlacha: 31) |
| `mask` | `mask_url` (samhlacha: 46) |
| `num_outputs` | `num_images` (samhlacha: 337) |
| `video` | `video_url` (samhlacha: 197) |
| `videos` | `video_urls` (samhlacha: 13), `reference_video_urls` (samhlacha: 1) |

Rialacha:

- Seol an t-ainm canónach nó an t-ainm dúchasach. Má sheolann tú an dá cheann le luachanna éagsúla, teipeann ar an nglao le
  `422 invalid_input` ar an ainm canónach.
- Diúltaítear do pharaiméadar nach ainm dúchasach ná ainm canónach de chuid na samhla é le `422 invalid_input`
  ("Unknown parameter"), agus taispeántar an t-ainm bailí is gaire mar mholadh. Ní ghlactar le botúin litrithe go ciúin riamh.
- Taispeánann gach leathanach samhla an dá ainm taobh le taobh.

## Comhéigean cineáil

Tiontaítear luachanna chuig an gcineál a bhfuil súil ag an tsamhail leis, mar sin oibríonn siad seo go léir:

| Seolann tú | Tá an tsamhail ag súil le | Éiríonn sé |
|---|---|---|
| `5`, `"5"`, `"5s"` | `duration` mar theaghrán amhail `"5"` | `"5"` |
| `"8"` | slánuimhir | `8` |
| `"1080P"`, `"4K"` | `resolution` amhail `"1080p"`, `"4k"` | an litriú cruinn ceadaithe |
| `"true"`, `"false"`, `1`, `0` | booleán | `true`, `false` |
| `"https://…/a.jpg"` | liosta URLanna | `["https://…/a.jpg"]` |
| `42` | teaghrán | `"42"` |

Déantar na luachanna ceadaithe a mheaitseáil go cruinn ar dtús, ansin gan aird ar chás, agus ansin mar uimhreacha (`5` meaitseálann `"5"`, `"5s"` agus
luachanna den stíl `"5 s"`).

## Réamhshocruithe

Úsáideann paraiméadair a fhágann tú ar lár réamhshocrú na samhla, atá liostaithe i dtábla paraiméadar na samhla. Ríomhtar an praghas
leis na réamhshocruithe céanna (mar shampla, gearrtar praghas ar shamhail físeáin a bhfuil `generate_audio` réamhshocraithe aici mar `true` le fuaim,
mura seolann tú `"generate_audio": false`).

## Paraiméadair chomhaid

Glacann paraiméadair íomhá, físeáin agus fuaime le URL poiblí, URI `data:` suas le 10 MB, nó `file_url` uaslódála.
Féach [Comhaid](https://doitong.com/developers/docs/files).