# Vigezo

Kila modeli huhifadhi majina yake asilia ya vigezo, na kila ukurasa wa modeli huyataja. Zaidi ya hayo, API inakubali
**majina sanifu** kwa vigezo vinavyomaanisha kitu kilekile kwenye kila modeli, hivyo msimbo ulioandikwa kwa modeli moja hufanya kazi
kwenye modeli inayofuata kwa mabadiliko machache zaidi.

## Majina sanifu

| Jina sanifu | Maana | Majina asilia ya kawaida |
|---|---|---|
| `image` | Picha ya ingizo au fremu ya kwanza | `image_url`, `start_image_url`, `first_frame_url`, `first_image_url`, `source_image_url` |
| `end_image` | Picha ya fremu ya mwisho | `end_image_url`, `last_frame_url`, `tail_image_url` |
| `images` | Orodha ya picha za marejeo | `image_urls`, `reference_image_urls` |
| `video` | Video ya ingizo | `video_url` |
| `videos` | Orodha ya video za marejeo | `video_urls` |
| `audio` | Sauti ya ingizo | `audio_url` |
| `audios` | Orodha ya klipu za sauti za marejeo | `audio_urls` |
| `mask` | Picha ya maski | `mask_url` |
| `num_outputs` | Idadi ya matokeo ya kuzalisha | `num_images` |
| `generate_audio` | Kuzalisha sauti pamoja na video | `generate_audio_switch`, `enable_audio` |

Ni sehemu gani asilia ambayo jina sanifu linaunganishwa nayo kwenye kila modeli ya sasa:

| Jina rasmi | Sehemu asili (miundo inayotumia) |
|---|---|
| `audio` | `audio_url` (miundo: 126) |
| `audios` | `audio_urls` (miundo: 7), `reference_audio_urls` (miundo: 1) |
| `end_image` | `end_image_url` (miundo: 76), `last_frame_url` (miundo: 12), `tail_image_url` (miundo: 1) |
| `generate_audio` | `generate_audio_switch` (miundo: 16), `audio` (miundo: 3) |
| `image` | `image_url` (miundo: 529), `start_image_url` (miundo: 20), `first_frame_url` (miundo: 12), `first_image_url` (miundo: 7), `source_image_url` (miundo: 2) |
| `images` | `image_urls` (miundo: 148), `reference_image_urls` (miundo: 31) |
| `mask` | `mask_url` (miundo: 46) |
| `num_outputs` | `num_images` (miundo: 337) |
| `video` | `video_url` (miundo: 197) |
| `videos` | `video_urls` (miundo: 13), `reference_video_urls` (miundo: 1) |

Sheria:

- Tuma jina sanifu au jina asilia. Ukituma yote mawili yenye thamani tofauti, simu itashindikana kwa
  `422 invalid_input` kwenye jina sanifu.
- Kigezo ambacho si jina asilia wala jina sanifu la modeli hukataliwa kwa `422 invalid_input`
  ("Kigezo kisichojulikana"), pamoja na jina halali lililo karibu zaidi kama pendekezo. Makosa ya kuandika hayapitishwi kimya kimya.
- Kila ukurasa wa modeli huonyesha majina yote mawili kando kwa kando.

## Ubadilishaji wa aina

Thamani hubadilishwa kuwa aina ambayo modeli inatarajia, kwa hivyo yote haya hufanya kazi:

| Unachotuma | Modeli inatarajia | Hubadilika kuwa |
|---|---|---|
| `5`, `"5"`, `"5s"` | `duration` kama mfuatano wa maandishi kama `"5"` | `"5"` |
| `"8"` | nambari kamili | `8` |
| `"1080P"`, `"4K"` | `resolution` kama `"1080p"`, `"4k"` | tahajia kamili inayoruhusiwa |
| `"true"`, `"false"`, `1`, `0` | thamani ya boolean | `true`, `false` |
| `"https://…/a.jpg"` | orodha ya URL | `["https://…/a.jpg"]` |
| `42` | mfuatano wa maandishi | `"42"` |

Thamani zinazoruhusiwa hulinganishwa kwanza kwa usahihi, kisha bila kuzingatia herufi kubwa au ndogo, na hatimaye kama nambari (`5` hulingana na thamani za mtindo wa `"5"`, `"5s"` na
`"5 s"`).

## Chaguo-msingi

Vigezo unavyoacha havijatumwa hutumia chaguo-msingi la modeli, ambalo limeorodheshwa kwenye jedwali la vigezo la modeli. Bei huhesabiwa
kwa kutumia chaguo-msingi hizo hizo (kwa mfano, modeli ya video ambayo `generate_audio` yake ya chaguo-msingi ni `true` huwekewa bei yenye
sauti isipokuwa utume `"generate_audio": false`).

## Vigezo vya faili

Vigezo vya picha, video na sauti hukubali URL ya umma, URI ya `data:` yenye hadi MB 10, au `file_url` ya faili iliyopakiwa.
Tazama [Files](https://doitong.com/developers/docs/files).