For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
नया Studio प्रोजेक्ट बनाता है, जिसे खाली, किसी दस्तावेज़ से या URL से इनिशियलाइज़ किया जा सकता है।
Headers
xi-api-keystringOptional
Request
This endpoint expects a multipart form containing an optional file.
namestringRequired
Studio प्रोजेक्ट का नाम, केवल पहचान के लिए इस्तेमाल किया जाता है।
default_title_voice_idstring or nullOptional
वह voice_id जो नए शीर्षकों के लिए इस्तेमाल होने वाली डिफ़ॉल्ट वॉइस से मेल खाती है।
default_paragraph_voice_idstring or nullOptional
वह voice_id जो नए पैराग्राफ़ के लिए इस्तेमाल होने वाली डिफ़ॉल्ट वॉइस से मेल खाती है।
default_model_idstring or nullOptional
इस स्टूडियो प्रोजेक्ट के लिए उपयोग किए जाने वाले मॉडल की ID। सभी उपलब्ध मॉडल की सूची के लिए आप GET /v1/models क्वेरी कर सकते हैं।
from_urlstring or nullOptional
एक वैकल्पिक URL जिससे हम Studio प्रोजेक्ट शुरू करने के लिए कॉन्टेंट निकालेंगे। इसे सेट करने पर 'from_url' और 'from_content' null होने चाहिए। अगर 'from_url', 'from_document', 'from_content' में से कोई भी नहीं दिया गया, तो हम Studio प्रोजेक्ट को खाली रूप में शुरू करेंगे।
from_documentfileOptional
वैकल्पिक .epub, .pdf, .txt या ऐसी ही कोई फ़ाइल दी जा सकती है। देने पर हम उसके कॉन्टेंट से Studio प्रोजेक्ट शुरू करेंगे। इसे सेट करने पर 'from_url' और 'from_content' null होने चाहिए। अगर 'from_url', 'from_document', 'from_content' में से कोई भी नहीं दिया गया, तो हम Studio प्रोजेक्ट को खाली रूप में शुरू करेंगे।
from_content_jsonstringOptional
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 nullOptional
जनरेट किए गए ऑडियो की 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 डिफ़ॉल्ट होता है।
Allowed values:
titlestring or nullOptional
Studio प्रोजेक्ट के लेखक का वैकल्पिक नाम। इसे Studio प्रोजेक्ट या चैप्टर डाउनलोड पर mp3 फ़ाइल में मेटाडेटा के रूप में जोड़ा जाएगा।
authorstring or nullOptional
Studio प्रोजेक्ट के लेखक का वैकल्पिक नाम। इसे Studio प्रोजेक्ट या चैप्टर डाउनलोड पर mp3 फ़ाइल में मेटाडेटा के रूप में जोड़ा जाएगा।
descriptionstring or nullOptional
Studio प्रोजेक्ट का वैकल्पिक विवरण।
genreslist of stringsOptional
Studio प्रोजेक्ट से जुड़ी शैलियों की वैकल्पिक सूची।
target_audienceenum or nullOptional
Studio प्रोजेक्ट के लिए वैकल्पिक लक्षित ऑडियंस।
Allowed values:
languagestring or nullOptional=2 characters
Studio प्रोजेक्ट की वैकल्पिक भाषा। दो-अक्षर का भाषा कोड (ISO 639-1)।
content_typestring or nullOptional
Studio प्रोजेक्ट का वैकल्पिक कॉन्टेंट टाइप।
original_publication_datestring or nullOptionalformat: "^\d{4}-\d{2}-\d{2}$|^\d{4}$"
Studio प्रोजेक्ट की वैकल्पिक मूल प्रकाशन तिथि, YYYY-MM-DD या YYYY फ़ॉर्मैट में।
mature_contentboolean or nullOptionalDefaults to false
इस Studio प्रोजेक्ट में परिपक्व कॉन्टेंट है या नहीं, इसका वैकल्पिक निर्धारण।
isbn_numberstring or nullOptional
आप जिस Studio प्रोजेक्ट को बनाना चाहते हैं उसका वैकल्पिक ISBN नंबर। इसे Studio प्रोजेक्ट या चैप्टर डाउनलोड पर mp3 फ़ाइल में मेटाडेटा के रूप में जोड़ा जाएगा।
acx_volume_normalizationbooleanOptionalDefaults to false
[बहिष्कृत] Studio प्रोजेक्ट डाउनलोड होने पर, लौटाए गए ऑडियो को ऑडियोबुक की नॉर्मलाइज़्ड वॉल्यूम आवश्यकताओं के अनुरूप बनाने के लिए postprocessing करनी है या नहीं।
volume_normalizationbooleanOptionalDefaults to false
स्टूडियो प्रोजेक्ट डाउनलोड होने पर, क्या लौटाए गए ऑडियो पर पोस्ट-प्रोसेसिंग की जानी चाहिए ताकि वह ऑडियोबुक की सामान्यीकृत वॉल्यूम आवश्यकताओं के अनुरूप हो।
pronunciation_dictionary_locatorslist of stringsOptional
टेक्स्ट पर लागू किए जाने वाले उच्चारण शब्दकोशों के लिए 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 nullOptional
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 nullOptional
इस Studio प्रोजेक्ट का कॉन्टेंट फ़िक्शन है या नहीं, इसका वैकल्पिक निर्धारण।
Allowed values:
apply_text_normalizationenum or nullOptional
यह पैरामीटर चार मोड—'auto', 'on', 'apply_english' और 'off'—से टेक्स्ट नॉर्मलाइज़ेशन नियंत्रित करता है।
'auto' पर सेट करने पर, सिस्टम अपने-आप तय करेगा कि टेक्स्ट नॉर्मलाइज़ेशन लागू करना है या नहीं
(जैसे, संख्याओं को शब्दों में लिखना)। 'on' के साथ टेक्स्ट नॉर्मलाइज़ेशन हमेशा लागू होगा, जबकि
'off' के साथ इसे छोड़ दिया जाएगा। 'apply_english', 'on' जैसा ही है, लेकिन यह मानेगा कि टेक्स्ट अंग्रेज़ी में है।
Allowed values:
auto_convertbooleanOptionalDefaults to false
क्या स्टूडियो प्रोजेक्ट को अपने-आप ऑडियो में कन्वर्ट करना है।
auto_assign_voicesboolean or nullOptionalDefaults to false
[Alpha Feature] प्रोजेक्ट बनाते समय वाक्यांशों को अपने-आप वॉइस असाइन करनी है या नहीं।
source_typeenum or nullOptional
बनाए जाने वाले स्टूडियो प्रोजेक्ट का टाइप।
voice_settingslist of stringsOptional
प्रोजेक्ट के लिए वैकल्पिक वॉइस सेटिंग ओवरराइड, 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 nullOptionalDefaults to false
अगर true है, तो ड्राफ़्ट स्थिति में सीधे प्रकाशित करने के लिए संबंधित read बनाता है
एक वैकल्पिक URL जिससे हम Studio प्रोजेक्ट शुरू करने के लिए कॉन्टेंट निकालेंगे। इसे सेट करने पर ‘from_url’ और ‘from_content’ null होने चाहिए। अगर ‘from_url’, ‘from_document’, ‘from_content’ में से कोई भी नहीं दिया गया, तो हम Studio प्रोजेक्ट को खाली रूप में शुरू करेंगे।
वैकल्पिक .epub, .pdf, .txt या ऐसी ही कोई फ़ाइल दी जा सकती है। देने पर हम उसके कॉन्टेंट से Studio प्रोजेक्ट शुरू करेंगे। इसे सेट करने पर ‘from_url’ और ‘from_content’ null होने चाहिए। अगर ‘from_url’, ‘from_document’, ‘from_content’ में से कोई भी नहीं दिया गया, तो हम Studio प्रोजेक्ट को खाली रूप में शुरू करेंगे।
Studio प्रोजेक्ट को शुरू करने के लिए वैकल्पिक सामग्री। अगर यह सेट है, तो ‘from_url’ और ‘from_document’ null होने चाहिए। अगर ‘from_url’, ‘from_document’, और ‘from_content’ में से कोई भी नहीं दिया गया है, तो हम Studio प्रोजेक्ट को खाली रूप में शुरू करेंगे।
जनरेट किए गए ऑडियो की 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 डिफ़ॉल्ट होता है।
आप जिस Studio प्रोजेक्ट को बनाना चाहते हैं उसका वैकल्पिक ISBN नंबर। इसे Studio प्रोजेक्ट या चैप्टर डाउनलोड पर mp3 फ़ाइल में मेटाडेटा के रूप में जोड़ा जाएगा।
[बहिष्कृत] Studio प्रोजेक्ट डाउनलोड होने पर, लौटाए गए ऑडियो को ऑडियोबुक की नॉर्मलाइज़्ड वॉल्यूम आवश्यकताओं के अनुरूप बनाने के लिए postprocessing करनी है या नहीं।
स्टूडियो प्रोजेक्ट डाउनलोड होने पर, क्या लौटाए गए ऑडियो पर पोस्ट-प्रोसेसिंग की जानी चाहिए ताकि वह ऑडियोबुक की सामान्यीकृत वॉल्यूम आवश्यकताओं के अनुरूप हो।
टेक्स्ट पर लागू किए जाने वाले उच्चारण शब्दकोशों के लिए 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”}”’.
Studio प्रोजेक्ट कन्वर्ट होने पर हमारी सेवा इस URL को कॉल करेगी। अनुरोध में कन्वर्ज़न की स्थिति वाला एक JSON blob होगा।
संदेश:
यह पैरामीटर चार मोड—‘auto’, ‘on’, ‘apply_english’ और ‘off’—से टेक्स्ट नॉर्मलाइज़ेशन नियंत्रित करता है।
‘auto’ पर सेट करने पर, सिस्टम अपने-आप तय करेगा कि टेक्स्ट नॉर्मलाइज़ेशन लागू करना है या नहीं
(जैसे, संख्याओं को शब्दों में लिखना)। ‘on’ के साथ टेक्स्ट नॉर्मलाइज़ेशन हमेशा लागू होगा, जबकि
‘off’ के साथ इसे छोड़ दिया जाएगा। ‘apply_english’, ‘on’ जैसा ही है, लेकिन यह मानेगा कि टेक्स्ट अंग्रेज़ी में है।
प्रोजेक्ट के लिए वैकल्पिक वॉइस सेटिंग ओवरराइड, JSON स्ट्रिंग्स की सूची के रूप में एन्कोड किए गए हैं।