# প্যারামিটার

প্রতিটি মডেল তার নিজস্ব প্যারামিটারের নাম ব্যবহার করে এবং প্রতিটি মডেল পেজে সেগুলোর তালিকা থাকে। এর পাশাপাশি, 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`
  ("Unknown parameter") দিয়ে প্রত্যাখ্যাত হবে এবং পরামর্শ হিসেবে সবচেয়ে কাছের বৈধ নাম দেখানো হবে। টাইপো কখনো নীরবে গ্রহণ করা হয় না।
- প্রতিটি মডেল পেজে দুটো নাম পাশাপাশি দেখানো হয়।

## টাইপ কোয়ের্সন

মানগুলো মডেলের প্রত্যাশিত টাইপে রূপান্তরিত হয়, তাই এগুলো সব কাজ করে:

| আপনি পাঠান | মডেল যা প্রত্যাশা করে | রূপান্তরিত হয় |
|---|---|---|
| `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) দেখুন।