কনটেন্টে যান
বাংলা
API কী পান
API গাইড

প্যারামিটার

Markdown হিসেবে দেখুন আপডেট করা হয়েছে

প্রতিটি মডেল তার নিজস্ব প্যারামিটারের নাম ব্যবহার করে এবং প্রতিটি মডেল পেজে সেগুলোর তালিকা থাকে। এর পাশাপাশি, 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 দেখুন।