# ਪੈਰਾਮੀਟਰ

ਹਰ ਮਾਡਲ ਆਪਣੇ ਮੂਲ ਪੈਰਾਮੀਟਰ ਨਾਮ ਰੱਖਦਾ ਹੈ ਅਤੇ ਹਰ ਮਾਡਲ ਪੰਨਾ ਉਹਨਾਂ ਦੀ ਸੂਚੀ ਦਿੰਦਾ ਹੈ। ਇਸ ਤੋਂ ਇਲਾਵਾ, API ਉਹਨਾਂ ਪੈਰਾਮੀਟਰਾਂ ਲਈ
**ਮਿਆਰੀ ਨਾਮ** ਸਵੀਕਾਰ ਕਰਦੀ ਹੈ ਜਿਨ੍ਹਾਂ ਦਾ ਹਰ ਮਾਡਲ ਵਿੱਚ ਇੱਕੋ ਅਰਥ ਹੁੰਦਾ ਹੈ, ਇਸ ਲਈ ਇੱਕ ਮਾਡਲ ਲਈ ਲਿਖਿਆ ਕੋਡ
ਅਗਲੇ ਮਾਡਲ ਲਈ ਘੱਟ ਤਬਦੀਲੀਆਂ ਨਾਲ ਕੰਮ ਕਰਦਾ ਹੈ।

## ਮਿਆਰੀ ਨਾਮ

| ਮਿਆਰੀ ਨਾਮ | ਅਰਥ | ਆਮ ਮੂਲ ਨਾਮ |
|---|---|---|
| `image` | ਇਨਪੁੱਟ ਜਾਂ ਪਹਿਲੇ ਫ੍ਰੇਮ ਦੀ ਤਸਵੀਰ | `image_url`, `start_image_url`, `first_frame_url`, `first_image_url`, `source_image_url` |
| `end_image` | ਆਖਰੀ ਫ੍ਰੇਮ ਦੀ ਤਸਵੀਰ | `end_image_url`, `last_frame_url`, `tail_image_url` |
| `images` | ਹਵਾਲਾ ਤਸਵੀਰਾਂ ਦੀ ਸੂਚੀ | `image_urls`, `reference_image_urls` |
| `video` | ਇਨਪੁੱਟ ਵੀਡੀਓ | `video_url` |
| `videos` | ਹਵਾਲਾ ਵੀਡੀਓਜ਼ ਦੀ ਸੂਚੀ | `video_urls` |
| `audio` | ਇਨਪੁੱਟ ਆਡੀਓ | `audio_url` |
| `audios` | ਹਵਾਲਾ ਆਡੀਓ ਕਲਿੱਪਾਂ ਦੀ ਸੂਚੀ | `audio_urls` |
| `mask` | ਮਾਸਕ ਤਸਵੀਰ | `mask_url` |
| `num_outputs` | ਬਣਾਏ ਜਾਣ ਵਾਲੇ ਨਤੀਜਿਆਂ ਦੀ ਗਿਣਤੀ | `num_images` |
| `generate_audio` | ਵੀਡੀਓ ਨਾਲ ਆਵਾਜ਼ ਬਣਾਉਣਾ | `generate_audio_switch`, `enable_audio` |

ਹਰ ਮੌਜੂਦਾ ਮਾਡਲ ਵਿੱਚ ਮਿਆਰੀ ਨਾਮ ਕਿਸ ਮੂਲ ਫੀਲਡ ਨਾਲ ਮੈਪ ਹੁੰਦਾ ਹੈ:

| ਕੈਨੋਨੀਕਲ ਨਾਮ | ਮੂਲ ਫੀਲਡ (ਇਸਨੂੰ ਵਰਤਣ ਵਾਲੇ ਮਾਡਲ) |
|---|---|
| `audio` | `audio_url` (ਮਾਡਲ: 126) |
| `audios` | `audio_urls` (ਮਾਡਲ: 7), `reference_audio_urls` (ਮਾਡਲ: 1) |
| `end_image` | `end_image_url` (ਮਾਡਲ: 76), `last_frame_url` (ਮਾਡਲ: 12), `tail_image_url` (ਮਾਡਲ: 1) |
| `generate_audio` | `generate_audio_switch` (ਮਾਡਲ: 16), `audio` (ਮਾਡਲ: 3) |
| `image` | `image_url` (ਮਾਡਲ: 529), `start_image_url` (ਮਾਡਲ: 20), `first_frame_url` (ਮਾਡਲ: 12), `first_image_url` (ਮਾਡਲ: 7), `source_image_url` (ਮਾਡਲ: 2) |
| `images` | `image_urls` (ਮਾਡਲ: 148), `reference_image_urls` (ਮਾਡਲ: 31) |
| `mask` | `mask_url` (ਮਾਡਲ: 46) |
| `num_outputs` | `num_images` (ਮਾਡਲ: 337) |
| `video` | `video_url` (ਮਾਡਲ: 197) |
| `videos` | `video_urls` (ਮਾਡਲ: 13), `reference_video_urls` (ਮਾਡਲ: 1) |

ਨਿਯਮ:

- ਮਿਆਰੀ ਨਾਮ ਜਾਂ ਮੂਲ ਨਾਮ ਵਿੱਚੋਂ ਕੋਈ ਇੱਕ ਭੇਜੋ। ਜੇ ਤੁਸੀਂ ਦੋਵੇਂ ਵੱਖ-ਵੱਖ ਮੁੱਲਾਂ ਨਾਲ ਭੇਜਦੇ ਹੋ, ਤਾਂ ਕਾਲ
  ਮਿਆਰੀ ਨਾਮ ਉੱਤੇ `422 invalid_input` ਨਾਲ ਅਸਫਲ ਹੁੰਦੀ ਹੈ।
- ਜੋ ਪੈਰਾਮੀਟਰ ਮਾਡਲ ਦਾ ਨਾ ਮੂਲ ਨਾਮ ਹੈ ਅਤੇ ਨਾ ਹੀ ਮਿਆਰੀ ਨਾਮ, ਉਸਨੂੰ `422 invalid_input`
  ("ਅਣਜਾਣ ਪੈਰਾਮੀਟਰ") ਨਾਲ ਰੱਦ ਕਰ ਦਿੱਤਾ ਜਾਂਦਾ ਹੈ ਅਤੇ ਸਭ ਤੋਂ ਨੇੜਲੇ ਵੈਧ ਨਾਮ ਦਾ ਸੁਝਾਅ ਦਿੱਤਾ ਜਾਂਦਾ ਹੈ। ਟਾਈਪੋ ਕਦੇ ਵੀ ਚੁੱਪਚਾਪ ਸਵੀਕਾਰ ਨਹੀਂ ਹੁੰਦੇ।
- ਹਰ ਮਾਡਲ ਪੰਨਾ ਦੋਵੇਂ ਨਾਮ ਨਾਲ-ਨਾਲ ਦਿਖਾਉਂਦਾ ਹੈ।

## ਕਿਸਮ ਰੂਪਾਂਤਰਨ

ਮੁੱਲਾਂ ਨੂੰ ਉਸ ਕਿਸਮ ਵਿੱਚ ਬਦਲਿਆ ਜਾਂਦਾ ਹੈ ਜਿਸਦੀ ਮਾਡਲ ਨੂੰ ਉਮੀਦ ਹੁੰਦੀ ਹੈ, ਇਸ ਲਈ ਇਹ ਸਾਰੇ ਕੰਮ ਕਰਦੇ ਹਨ:

| ਤੁਸੀਂ ਭੇਜਦੇ ਹੋ | ਮਾਡਲ ਨੂੰ ਉਮੀਦ ਹੈ | ਬਣ ਜਾਂਦਾ ਹੈ |
|---|---|---|
| `5`, `"5"`, `"5s"` | `duration` ਇੱਕ ਸਟ੍ਰਿੰਗ ਵਜੋਂ, ਜਿਵੇਂ `"5"` | `"5"` |
| `"8"` | ਇੱਕ ਪੂਰਨ ਅੰਕ | `8` |
| `"1080P"`, `"4K"` | `resolution`, ਜਿਵੇਂ `"1080p"`, `"4k"` | ਬਿਲਕੁਲ ਮਨਜ਼ੂਰਸ਼ੁਦਾ ਸਪੈਲਿੰਗ |
| `"true"`, `"false"`, `1`, `0` | ਇੱਕ ਬੂਲੀਅਨ | `true`, `false` |
| `"https://…/a.jpg"` | URL ਦੀ ਸੂਚੀ | `["https://…/a.jpg"]` |
| `42` | ਇੱਕ ਸਟ੍ਰਿੰਗ | `"42"` |

ਮਨਜ਼ੂਰਸ਼ੁਦਾ ਮੁੱਲਾਂ ਦਾ ਪਹਿਲਾਂ ਬਿਲਕੁਲ ਸਹੀ ਮਿਲਾਨ ਕੀਤਾ ਜਾਂਦਾ ਹੈ, ਫਿਰ ਅੱਖਰਾਂ ਦੇ ਵੱਡੇ-ਛੋਟੇ ਰੂਪ ਨੂੰ ਨਜ਼ਰਅੰਦਾਜ਼ ਕਰਕੇ, ਅਤੇ ਫਿਰ ਅੰਕਾਂ ਵਜੋਂ (`5`, `"5"`, `"5s"` ਅਤੇ
`"5 s"` ਕਿਸਮ ਦੇ ਮੁੱਲਾਂ ਨਾਲ ਮਿਲਦਾ ਹੈ)।

## ਡਿਫ਼ਾਲਟ

ਜੋ ਪੈਰਾਮੀਟਰ ਤੁਸੀਂ ਛੱਡ ਦਿੰਦੇ ਹੋ, ਉਹ ਮਾਡਲ ਦਾ ਡਿਫ਼ਾਲਟ ਵਰਤਦੇ ਹਨ, ਜਿਸਦੀ ਸੂਚੀ ਮਾਡਲ ਦੀ ਪੈਰਾਮੀਟਰ ਸਾਰਣੀ ਵਿੱਚ ਹੁੰਦੀ ਹੈ। ਕੀਮਤ
ਉਹੀ ਡਿਫ਼ਾਲਟ ਵਰਤ ਕੇ ਗਿਣੀ ਜਾਂਦੀ ਹੈ (ਉਦਾਹਰਨ ਲਈ, ਜਿਸ ਵੀਡੀਓ ਮਾਡਲ ਵਿੱਚ `generate_audio` ਦਾ ਡਿਫ਼ਾਲਟ `true` ਹੈ, ਉਸਦੀ ਕੀਮਤ
ਆਵਾਜ਼ ਸਮੇਤ ਲੱਗਦੀ ਹੈ, ਜਦੋਂ ਤੱਕ ਤੁਸੀਂ `"generate_audio": false` ਨਾ ਭੇਜੋ)।

## ਫਾਈਲ ਪੈਰਾਮੀਟਰ

ਤਸਵੀਰ, ਵੀਡੀਓ ਅਤੇ ਆਡੀਓ ਪੈਰਾਮੀਟਰ ਇੱਕ ਜਨਤਕ URL, 10 MB ਤੱਕ ਦਾ `data:` URI, ਜਾਂ ਅੱਪਲੋਡ ਦੇ `file_url` ਨੂੰ ਸਵੀਕਾਰ ਕਰਦੇ ਹਨ।
[Files](https://doitong.com/developers/docs/files) ਵੇਖੋ।