# Tawhā

Ka pupuri ia tauira i ōna ake ingoa tawhā taketake, ā, ka whakarārangihia aua ingoa ki te whārangi o ia tauira. Hei tāpiri atu, ka whakaae te API ki ngā **ingoa paerewa** mō ngā tawhā he ōrite te tikanga puta noa i ngā tauira katoa, nō reira ka mahi tonu te waehere i tuhia mō tētahi tauira mō tētahi atu tauira, me iti ake ngā whakarerekētanga.

## Ngā ingoa paerewa

| Ingoa paerewa | Tikanga | Ngā ingoa taketake e whakamahia nuitia ana |
|---|---|---|
| `image` | Te atahanga tāuru, te atahanga o te anga tuatahi rānei | `image_url`, `start_image_url`, `first_frame_url`, `first_image_url`, `source_image_url` |
| `end_image` | Te atahanga o te anga whakamutunga | `end_image_url`, `last_frame_url`, `tail_image_url` |
| `images` | He rārangi atahanga tohutoro | `image_urls`, `reference_image_urls` |
| `video` | Te ataata tāuru | `video_url` |
| `videos` | He rārangi ataata tohutoro | `video_urls` |
| `audio` | Te oro tāuru | `audio_url` |
| `audios` | He rārangi topenga oro tohutoro | `audio_urls` |
| `mask` | He atahanga ārai | `mask_url` |
| `num_outputs` | E hia ngā hua hei whakaputa | `num_images` |
| `generate_audio` | Whakaputa oro me te ataata | `generate_audio_switch`, `enable_audio` |

Ko tēhea āpure taketake ka hāngai ki tētahi ingoa paerewa i ia tauira o nāianei:

| Ingoa canonical | Āpure taketake (ngā tauira e whakamahi ana) |
|---|---|
| `audio` | `audio_url` (ngā tauira: 126) |
| `audios` | `audio_urls` (ngā tauira: 7), `reference_audio_urls` (ngā tauira: 1) |
| `end_image` | `end_image_url` (ngā tauira: 76), `last_frame_url` (ngā tauira: 12), `tail_image_url` (ngā tauira: 1) |
| `generate_audio` | `generate_audio_switch` (ngā tauira: 16), `audio` (ngā tauira: 3) |
| `image` | `image_url` (ngā tauira: 529), `start_image_url` (ngā tauira: 20), `first_frame_url` (ngā tauira: 12), `first_image_url` (ngā tauira: 7), `source_image_url` (ngā tauira: 2) |
| `images` | `image_urls` (ngā tauira: 148), `reference_image_urls` (ngā tauira: 31) |
| `mask` | `mask_url` (ngā tauira: 46) |
| `num_outputs` | `num_images` (ngā tauira: 337) |
| `video` | `video_url` (ngā tauira: 197) |
| `videos` | `video_urls` (ngā tauira: 13), `reference_video_urls` (ngā tauira: 1) |

Ngā ture:

- Tukuna te ingoa paerewa, te ingoa taketake rānei. Ki te tukuna e koe ngā mea e rua me ngā uara rerekē, ka rahua te tono me te `422 invalid_input` mō te ingoa paerewa.
- Ki te kore te tawhā e noho hei ingoa taketake, hei ingoa paerewa rānei mō te tauira, ka whakakorehia me te `422 invalid_input` ("Unknown parameter"), ā, ka tukuna te ingoa whaimana e tino tata ana hei whakaaro. E kore rawa ngā hapa patopato e tukuna puku.
- Ka whakaaturia ngā ingoa e rua ki ia whārangi tauira, kei te taha ki te taha.

## Te whakahāngai momo

Ka hurihia ngā uara kia rite ki te momo e tūmanakohia ana e te tauira, nō reira ka mahi katoa ēnei:

| Ko tāu e tuku | Ko tā te tauira e tūmanako ana | Ka noho hei |
|---|---|---|
| `5`, `"5"`, `"5s"` | `duration` hei aho pērā i `"5"` | `"5"` |
| `"8"` | He tauoti | `8` |
| `"1080P"`, `"4K"` | `resolution` pērā i `"1080p"`, `"4k"` | Te tuhi tika e whakaaetia ana |
| `"true"`, `"false"`, `1`, `0` | He uara Boolean | `true`, `false` |
| `"https://…/a.jpg"` | He rārangi URL | `["https://…/a.jpg"]` |
| `42` | He aho | `"42"` |

Ka whakatauritea ngā uara e whakaaetia ana kia tino ōrite i te tuatahi, kātahi ka waiho te rerekētanga pū matua ki te taha, ā, kātahi hei tau (`5` ka hāngai ki ngā uara pērā i `"5"`, `"5s"` me `"5 s"`).

## Ngā uara taunoa

Ko ngā tawhā ka waiho e koe ki waho ka whakamahi i te uara taunoa o te tauira, e whakarārangihia ana ki te ripanga tawhā o te tauira. Ka tatau te utu mā te whakamahi i aua uara taunoa anō (hei tauira, ki te taunoa te `generate_audio` o tētahi tauira ataata ki `true`, ka utu te ataata me te oro, engari mēnā ka tukuna e koe `"generate_audio": false`).

## Ngā tawhā kōnae

Ka whakaae ngā tawhā atahanga, ataata me te oro ki tētahi URL tūmatanui, ki tētahi URI `data:` tae atu ki te 10 MB, ki te `file_url` rānei o tētahi tukunga kōnae. Tirohia [Ngā kōnae](https://doitong.com/developers/docs/files).