# Paramadairean

Bidh gach modail a’ cumail nan ainmean paramadair dùthchasach aige, agus tha gach duilleag modail gan liostadh. A bharrachd air sin, gabhaidh an API ri
**ainmean canonical** airson nam paramadairean aig a bheil an aon chiall anns gach modail, gus am bi còd a chaidh a sgrìobhadh airson aon mhodail ag obair
airson an ath mhodail le nas lugha de dh’atharrachaidhean.

## Ainmean canonical

| Ainm canonical | Ciall | Ainmean dùthchasach àbhaisteach |
|---|---|---|
| `image` | An ìomhaigh ion-chuir no a’ chiad fhrèam | `image_url`, `start_image_url`, `first_frame_url`, `first_image_url`, `source_image_url` |
| `end_image` | An ìomhaigh den fhrèam mu dheireadh | `end_image_url`, `last_frame_url`, `tail_image_url` |
| `images` | Liosta de dh’ìomhaighean iomraidh | `image_urls`, `reference_image_urls` |
| `video` | A’ bhidio ion-chuir | `video_url` |
| `videos` | Liosta de bhideothan iomraidh | `video_urls` |
| `audio` | Am fuaim ion-chuir | `audio_url` |
| `audios` | Liosta de chriomagan fuaim iomraidh | `audio_urls` |
| `mask` | Ìomhaigh masg | `mask_url` |
| `num_outputs` | Cia mheud toradh a ghineas | `num_images` |
| `generate_audio` | Gineadh fuaim leis a’ bhidio | `generate_audio_switch`, `enable_audio` |

Dè an raon dùthchasach ris a bheil ainm canonical a’ mapadh anns gach modail làithreach:

| Ainm canonaigeach | Raon dùthchasach (modailean a chleachdas e) |
|---|---|
| `audio` | `audio_url` (modailean: 126) |
| `audios` | `audio_urls` (modailean: 7), `reference_audio_urls` (modailean: 1) |
| `end_image` | `end_image_url` (modailean: 76), `last_frame_url` (modailean: 12), `tail_image_url` (modailean: 1) |
| `generate_audio` | `generate_audio_switch` (modailean: 16), `audio` (modailean: 3) |
| `image` | `image_url` (modailean: 529), `start_image_url` (modailean: 20), `first_frame_url` (modailean: 12), `first_image_url` (modailean: 7), `source_image_url` (modailean: 2) |
| `images` | `image_urls` (modailean: 148), `reference_image_urls` (modailean: 31) |
| `mask` | `mask_url` (modailean: 46) |
| `num_outputs` | `num_images` (modailean: 337) |
| `video` | `video_url` (modailean: 197) |
| `videos` | `video_urls` (modailean: 13), `reference_video_urls` (modailean: 1) |

Riaghailtean:

- Cuir an t-ainm canonical no an t-ainm dùthchasach. Ma chuireas tu an dà chuid le luachan eadar-dhealaichte, fàilligidh a’ ghairm le
  `422 invalid_input` air an ainm canonical.
- Thèid paramadair nach eil na ainm dùthchasach no canonical den mhodail a dhiùltadh le `422 invalid_input`
  ("Unknown parameter"), leis an ainm dhligheach as fhaisge air a mholadh. Cha tèid mearachdan litreachaidh seachad gu sàmhach idir.
- Seallaidh gach duilleag modail an dà ainm taobh ri taobh.

## Co-èigneachadh seòrsaichean

Thèid luachan atharrachadh dhan t-seòrsa ris a bheil am modail an dùil, mar sin obraichidh iad sin uile:

| Na chuireas tu | Na tha am modail an dùil | Na thig às |
|---|---|---|
| `5`, `"5"`, `"5s"` | `duration` mar shreang leithid `"5"` | `"5"` |
| `"8"` | Slàn-àireamh | `8` |
| `"1080P"`, `"4K"` | `resolution` leithid `"1080p"`, `"4k"` | An litreachadh cheart cheadaichte |
| `"true"`, `"false"`, `1`, `0` | Boolean | `true`, `false` |
| `"https://…/a.jpg"` | Liosta de URLan | `["https://…/a.jpg"]` |
| `42` | Sreang | `"42"` |

Thèid luachan ceadaichte a choimeasadh gu mionaideach an toiseach, an uair sin gun aire a thoirt do litrichean mòra is beaga, agus mu dheireadh mar àireamhan (`5` a’ maidseadh ri luachan ann an stoidhle `"5"`, `"5s"` agus
`"5 s"`).

## Bun-roghainnean

Cleachdaidh paramadairean a dh’fhàgas tu a-mach bun-roghainn a’ mhodail, a tha air a liostadh ann an clàr pharamadairean a’ mhodail. Tha a’ phrìs
air a tomhas leis na h-aon bhun-roghainnean (mar eisimpleir, ma tha `generate_audio` aig modail bhidio mar `true` a ghnàth, thèid a phrìs a thomhas le
fuaim mura cuir thu `"generate_audio": false`).

## Paramadairean fhaidhlichean

Gabhaidh paramadairean ìomhaigh, bhidio agus fuaim ri URL poblach, URI `data:` suas ri 10 MB, no `file_url` de luchdachadh suas.
Faic [Faidhlichean](https://doitong.com/developers/docs/files).