सामग्री पर जाएँ
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 देखें।