नेविगेशन पर जाएँ

स्टूडियो प्रोजेक्ट बनाएं

नया Studio प्रोजेक्ट बनाता है, जिसे खाली, किसी दस्तावेज़ से या URL से इनिशियलाइज़ किया जा सकता है।

हेडर

xi-api-keystringवैकल्पिक

अनुरोध

This endpoint expects a multipart form containing an optional file.
namestringआवश्यक

Studio प्रोजेक्ट का नाम, केवल पहचान के लिए इस्तेमाल किया जाता है।

default_title_voice_idstring or nullवैकल्पिक

वह voice_id जो नए शीर्षकों के लिए इस्तेमाल होने वाली डिफ़ॉल्ट वॉइस से मेल खाती है।

default_paragraph_voice_idstring or nullवैकल्पिक

वह voice_id जो नए पैराग्राफ़ के लिए इस्तेमाल होने वाली डिफ़ॉल्ट वॉइस से मेल खाती है।

default_model_idstring or nullवैकल्पिक

इस स्टूडियो प्रोजेक्ट के लिए उपयोग किए जाने वाले मॉडल की ID। सभी उपलब्ध मॉडल की सूची के लिए आप GET /v1/models क्वेरी कर सकते हैं।

from_urlstring or nullवैकल्पिक

एक वैकल्पिक URL जिससे हम Studio प्रोजेक्ट शुरू करने के लिए कॉन्टेंट निकालेंगे। इसे सेट करने पर ‘from_url’ और ‘from_content’ null होने चाहिए। अगर ‘from_url’, ‘from_document’, ‘from_content’ में से कोई भी नहीं दिया गया, तो हम Studio प्रोजेक्ट को खाली रूप में शुरू करेंगे।

from_documentfileवैकल्पिक

वैकल्पिक .epub, .pdf, .txt या ऐसी ही कोई फ़ाइल दी जा सकती है। देने पर हम उसके कॉन्टेंट से Studio प्रोजेक्ट शुरू करेंगे। इसे सेट करने पर ‘from_url’ और ‘from_content’ null होने चाहिए। अगर ‘from_url’, ‘from_document’, ‘from_content’ में से कोई भी नहीं दिया गया, तो हम Studio प्रोजेक्ट को खाली रूप में शुरू करेंगे।

from_content_jsonstringवैकल्पिक

Studio प्रोजेक्ट को शुरू करने के लिए वैकल्पिक सामग्री। अगर यह सेट है, तो ‘from_url’ और ‘from_document’ null होने चाहिए। अगर ‘from_url’, ‘from_document’, और ‘from_content’ में से कोई भी नहीं दिया गया है, तो हम Studio प्रोजेक्ट को खाली रूप में शुरू करेंगे।

उदाहरण: [{“name”: “Chapter A”, “blocks”: [{“sub_type”: “p”, “nodes”: [{“voice_id”: “6lCwbsX1yVjD49QmpkT0”, “text”: “A”, “type”: “tts_node”}, {“voice_id”: “6lCwbsX1yVjD49QmpkT1”, “text”: “B”, “type”: “tts_node”}]}, {“sub_type”: “h1”, “nodes”: [{“voice_id”: “6lCwbsX1yVjD49QmpkT0”, “text”: “C”, “type”: “tts_node”}, {“voice_id”: “6lCwbsX1yVjD49QmpkT1”, “text”: “D”, “type”: “tts_node”}]}]}, {“name”: “Chapter B”, “blocks”: [{“sub_type”: “p”, “nodes”: [{“voice_id”: “6lCwbsX1yVjD49QmpkT0”, “text”: “E”, “type”: “tts_node”}, {“voice_id”: “6lCwbsX1yVjD49QmpkT1”, “text”: “F”, “type”: “tts_node”}]}, {“sub_type”: “h2”, “nodes”: [{“voice_id”: “6lCwbsX1yVjD49QmpkT0”, “text”: “G”, “type”: “tts_node”}, {“voice_id”: “6lCwbsX1yVjD49QmpkT1”, “text”: “H”, “type”: “tts_node”}]}]}]

quality_presetenum or nullवैकल्पिक

जनरेट किए गए ऑडियो की output quality। इनमें से एक होनी चाहिए: ‘standard’ - मानक output format, 44.1kHz sample rate के साथ 128kbps। ‘high’ - उच्च-गुणवत्ता output format, 44.1kHz sample rate के साथ 192kbps और हमारी ओर से बड़े सुधार। ‘ultra’ - ultra quality output format, 44.1kHz sample rate के साथ 192kbps और हमारी ओर से सबसे बेहतर सुधार। ‘ultra_lossless’ - पूरी तरह lossless format में ultra quality output format, 44.1kHz sample rate के साथ 705.6kbps और हमारी ओर से सबसे बेहतर सुधार। न दिए जाने पर, आपके subscription tier में उपलब्ध सबसे उच्च गुणवत्ता preset डिफ़ॉल्ट होता है।

अनुमत मान:
titlestring or nullवैकल्पिक

Studio प्रोजेक्ट के लेखक का वैकल्पिक नाम। इसे Studio प्रोजेक्ट या चैप्टर डाउनलोड पर mp3 फ़ाइल में मेटाडेटा के रूप में जोड़ा जाएगा।

authorstring or nullवैकल्पिक

Studio प्रोजेक्ट के लेखक का वैकल्पिक नाम। इसे Studio प्रोजेक्ट या चैप्टर डाउनलोड पर mp3 फ़ाइल में मेटाडेटा के रूप में जोड़ा जाएगा।

descriptionstring or nullवैकल्पिक

Studio प्रोजेक्ट का वैकल्पिक विवरण।

genreslist of stringsवैकल्पिक

Studio प्रोजेक्ट से जुड़ी शैलियों की वैकल्पिक सूची।

target_audienceenum or nullवैकल्पिक

Studio प्रोजेक्ट के लिए वैकल्पिक लक्षित ऑडियंस।

अनुमत मान:
languagestring or nullवैकल्पिक=2 characters

Studio प्रोजेक्ट की वैकल्पिक भाषा। दो-अक्षर का भाषा कोड (ISO 639-1)।

content_typestring or nullवैकल्पिक

Studio प्रोजेक्ट का वैकल्पिक कॉन्टेंट टाइप।

original_publication_datestring or nullवैकल्पिकफ़ॉर्मेट: "^\d{4}-\d{2}-\d{2}$|^\d{4}$"

Studio प्रोजेक्ट की वैकल्पिक मूल प्रकाशन तिथि, YYYY-MM-DD या YYYY फ़ॉर्मैट में।

mature_contentboolean or nullवैकल्पिकडिफ़ॉल्ट: false

इस Studio प्रोजेक्ट में परिपक्व कॉन्टेंट है या नहीं, इसका वैकल्पिक निर्धारण।

isbn_numberstring or nullवैकल्पिक

आप जिस Studio प्रोजेक्ट को बनाना चाहते हैं उसका वैकल्पिक ISBN नंबर। इसे Studio प्रोजेक्ट या चैप्टर डाउनलोड पर mp3 फ़ाइल में मेटाडेटा के रूप में जोड़ा जाएगा।

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

[बहिष्कृत] Studio प्रोजेक्ट डाउनलोड होने पर, लौटाए गए ऑडियो को ऑडियोबुक की नॉर्मलाइज़्ड वॉल्यूम आवश्यकताओं के अनुरूप बनाने के लिए postprocessing करनी है या नहीं।

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

स्टूडियो प्रोजेक्ट डाउनलोड होने पर, क्या लौटाए गए ऑडियो पर पोस्ट-प्रोसेसिंग की जानी चाहिए ताकि वह ऑडियोबुक की सामान्यीकृत वॉल्यूम आवश्यकताओं के अनुरूप हो।

pronunciation_dictionary_locatorslist of stringsवैकल्पिक

टेक्स्ट पर लागू किए जाने वाले उच्चारण शब्दकोशों के लिए JSON स्ट्रिंग्स की सूची के रूप में एन्कोड किए गए उच्चारण शब्दकोश लोकेटर्स (pronunciation_dictionary_id, version_id) की सूची। jsonBody के बजाय formData के माध्यम से प्रोजेक्ट्स जोड़े जा सकते हैं, इसलिए JSON-एन्कोडेड स्ट्रिंग्स की सूची ज़रूरी है। कई शब्दकोश बताने के लिए अपने curl में कई —form लाइनें इस्तेमाल करें, जैसे —form ‘pronunciation_dictionary_locators=”{“pronunciation_dictionary_id”:“Vmd4Zor6fplcA7WrINey”,“version_id”:“hRPaxjlTdR7wFMhV4w0b”}”’ —form ‘pronunciation_dictionary_locators=”{“pronunciation_dictionary_id”:“JzWtcGQMJ6bnlWwyMo7e”,“version_id”:“lbmwxiLu4q6txYxgdZqn”}”’.

callback_urlstring or nullवैकल्पिक

Studio प्रोजेक्ट कन्वर्ट होने पर हमारी सेवा इस URL को कॉल करेगी। अनुरोध में कन्वर्ज़न की स्थिति वाला एक JSON blob होगा। संदेश:

  1. प्रोजेक्ट सफलतापूर्वक कन्वर्ट होने पर: { type: “project_conversion_status”, event_timestamp: 1234567890, data: { request_id: “1234567890”, project_id: “21m00Tcm4TlvDq8ikWAM”, conversion_status: “success”, project_snapshot_id: “22m00Tcm4TlvDq8ikMAT”, error_details: None, } }

  2. प्रोजेक्ट कन्वर्ज़न विफल होने पर: { type: “project_conversion_status”, event_timestamp: 1234567890, data: { request_id: “1234567890”, project_id: “21m00Tcm4TlvDq8ikWAM”, conversion_status: “error”, project_snapshot_id: None, error_details: “Error details if conversion failed” } }

  3. अध्याय सफलतापूर्वक कन्वर्ट होने पर: { type: “chapter_conversion_status”, event_timestamp: 1234567890, data: { request_id: “1234567890”, project_id: “21m00Tcm4TlvDq8ikWAM”, chapter_id: “22m00Tcm4TlvDq8ikMAT”, conversion_status: “success”, chapter_snapshot_id: “23m00Tcm4TlvDq8ikMAV”, error_details: None, } }

  4. अध्याय कन्वर्ज़न विफल होने पर: { type: “chapter_conversion_status”, event_timestamp: 1234567890, data: { request_id: “1234567890”, project_id: “21m00Tcm4TlvDq8ikWAM”, chapter_id: “22m00Tcm4TlvDq8ikMAT”, conversion_status: “error”, chapter_snapshot_id: None, error_details: “Error details if conversion failed” } }

fictionenum or nullवैकल्पिक

इस Studio प्रोजेक्ट का कॉन्टेंट फ़िक्शन है या नहीं, इसका वैकल्पिक निर्धारण।

अनुमत मान:
apply_text_normalizationenum or nullवैकल्पिक

यह पैरामीटर चार मोड—‘auto’, ‘on’, ‘apply_english’ और ‘off’—से टेक्स्ट नॉर्मलाइज़ेशन नियंत्रित करता है। ‘auto’ पर सेट करने पर, सिस्टम अपने-आप तय करेगा कि टेक्स्ट नॉर्मलाइज़ेशन लागू करना है या नहीं (जैसे, संख्याओं को शब्दों में लिखना)। ‘on’ के साथ टेक्स्ट नॉर्मलाइज़ेशन हमेशा लागू होगा, जबकि ‘off’ के साथ इसे छोड़ दिया जाएगा। ‘apply_english’, ‘on’ जैसा ही है, लेकिन यह मानेगा कि टेक्स्ट अंग्रेज़ी में है।

अनुमत मान:
auto_convertbooleanवैकल्पिकडिफ़ॉल्ट: false

क्या स्टूडियो प्रोजेक्ट को अपने-आप ऑडियो में कन्वर्ट करना है।

auto_assign_voicesboolean or nullवैकल्पिकडिफ़ॉल्ट: false

[Alpha Feature] प्रोजेक्ट बनाते समय वाक्यांशों को अपने-आप वॉइस असाइन करनी है या नहीं।

source_typeenum or nullवैकल्पिक

बनाए जाने वाले स्टूडियो प्रोजेक्ट का टाइप।

voice_settingslist of stringsवैकल्पिक

प्रोजेक्ट के लिए वैकल्पिक वॉइस सेटिंग ओवरराइड, JSON स्ट्रिंग्स की सूची के रूप में एन्कोड किए गए हैं।

उदाहरण: [”{“voice_id”: “21m00Tcm4TlvDq8ikWAM”, “stability”: 0.7, “similarity_boost”: 0.8, “style”: 0.5, “speed”: 1.0, “use_speaker_boost”: true}”]

create_publishing_readboolean or nullवैकल्पिकडिफ़ॉल्ट: false

अगर true है, तो ड्राफ़्ट स्थिति में सीधे प्रकाशित करने के लिए संबंधित read बनाता है

रिस्पॉन्स

सफल रिस्पॉन्स

projectobject

त्रुटियाँ

422
Unprocessable Entity Error