पैरामीटर
हर मॉडल अपने मूल पैरामीटर नाम रखता है और हर मॉडल पेज पर उनकी सूची दी जाती है। इसके अलावा, 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 देखें।