वीडियो टू म्यूज़िक

एक या अधिक वीडियो फ़ाइलों से बैकग्राउंड म्यूज़िक जनरेट करें। वीडियो क्रम में जोड़े जाते हैं। वैकल्पिक विवरण और स्टाइल टैग जनरेट हुए संगीत को प्रभावित करते हैं।

क्वेरी पैरामीटर

output_formatenumवैकल्पिक

जनरेट किए गए ऑडियो का output format। codec_sample_rate_bitrate के रूप में फ़ॉर्मैट किया जाता है। इसलिए, 32kbs पर 22.05kHz sample rate वाले mp3 को mp3_22050_32 के रूप में दर्शाया जाता है। 192kbps bitrate वाले MP3 के लिए Creator tier या उससे ऊपर का subscription चाहिए। 44.1kHz sample rate वाले PCM के लिए Pro tier या उससे ऊपर का subscription चाहिए। ध्यान दें कि μ-law format (कभी-कभी mu-law लिखा जाता है, और अक्सर u-law के रूप में अनुमानित) का उपयोग आमतौर पर Twilio audio inputs के लिए होता है।

enable_loggingbooleanवैकल्पिकडिफ़ॉल्ट: true

जब enable_logging को false पर सेट किया जाता है, तो अनुरोध के लिए ज़ीरो रिटेंशन मोड इस्तेमाल होगा। ज़ीरो रिटेंशन मोड का इस्तेमाल सिर्फ़ एंटरप्राइज़ ग्राहक कर सकते हैं।

अनुरोध

This endpoint expects a multipart form with multiple files.

videosfilesआवश्यक

FormData array (multipart/form-data) के ज़रिए भेजी गई एक या अधिक वीडियो फ़ाइलें। इन्हें क्रम से एक codec में जोड़ा जाएगा। अधिकतम 10 वीडियो की अनुमति है और संयुक्त वीडियो का कुल आकार 200MB तक सीमित है। कुल मिलाकर, वीडियो की अवधि 600 सेकंड तक हो सकती है। ध्यान दें कि कई वीडियो जोड़ने से अनुरोध की अवधि काफ़ी बढ़ सकती है। हो सके तो वीडियो को पहले ही जोड़ लें।

descriptionstring or nullवैकल्पिक1-4100 characters

आपके इच्छित संगीत का वैकल्पिक टेक्स्ट विवरण। अधिकतम 4100 वर्णों की अनुमति है।

tagslist of stringsवैकल्पिकडिफ़ॉल्ट: []

style tags की वैकल्पिक सूची (जैसे, [‘upbeat’, ‘cinematic’])। अधिकतम 10 tags की अनुमति है।

model_idenumवैकल्पिकडिफ़ॉल्ट: music_v1

जनरेशन के लिए इस्तेमाल किया जाने वाला मॉडल।

अनुमत मान:

add_sfxbooleanवैकल्पिकडिफ़ॉल्ट: false

true होने पर, वीडियो के SFX संकेत शामिल करें।

separate_tracksbooleanवैकल्पिकडिफ़ॉल्ट: false

true होने पर, एक ही मिक्स्ड फ़ाइल के बजाय अलग-अलग संगीत और SFX ऑडियो ट्रैक वाली ZIP लौटाएं। ट्रैक को लेयर करने में ज़्यादा लचीलापन पाने के लिए इसका इस्तेमाल करें।

use_audio_as_referencebooleanवैकल्पिकडिफ़ॉल्ट: false

true होने पर, वीडियो के ऑडियो ट्रैक का विश्लेषण करें और उसके जॉनर, BPM, वाद्य-विन्यास, मूड और आर्क को संगीत जनरेशन के लिए संदर्भ विशेषताओं के रूप में इस्तेमाल करें।

sign_with_c2pabooleanवैकल्पिकडिफ़ॉल्ट: false

जनरेट किए गए गाने पर C2PA साइन करना है या नहीं। केवल mp3 फ़ाइलों पर लागू।

रिस्पॉन्स हेडर

song-idstringवैकल्पिक

जनरेट किए गए गाने का विशिष्ट पहचानकर्ता

रिस्पॉन्स

वीडियो से मेल खाती जनरेट की गई ऑडियो फ़ाइल। Content-Type और फ़ाइल एक्सटेंशन output_format पैरामीटर पर निर्भर करते हैं (डिफ़ॉल्ट mp3)।

त्रुटियाँ

403

Forbidden Error

422

Unprocessable Entity Error