मुख्य सामग्री पर जाएं
POST
संगीत बनाएँ
एक ही अनुरोध रूप से किसी भी संगीत प्रदाता से ट्रैक पाने के लिए POST /v1/music/generate पर model और prompt भेजें। सिंक्रोनस प्रदाताओं और प्रदाता की कतार की पोलिंग को Phaseo आपकी ओर से संभालता है।

परिणाम पढ़ें

पूरे हुए जनरेशन में audio_url या audio_base64 होता है। status का मान queued, in_progress, completed या failed होता है। जब यह अभी अंतिम न हो, तो उसी id के साथ GET /v1/music/generate/{music_id} पोल करें। id स्थिर Phaseo अनुरोध ID है। nativeResponseId अपस्ट्रीम प्रदाता का पहचानकर्ता है, जो प्रदाता से मिलान और सपोर्ट के लिए है। जब प्रदाता बनाई गई अवधि बताता है, तो usage में output_audio_seconds शामिल होता है।

Suno विकल्प सेट करें

Suno मॉडल एक वैकल्पिक suno ऑब्जेक्ट लेते हैं: customMode के false होने पर prompt आवश्यक है, और तब भी जब customMode true हो और instrumental false पर सेट हो। प्रदाता का कोई नियम तोड़ने वाला अनुरोध 400 लौटाता है:

प्राधिकरण

Authorization
string
header
आवश्यक

Bearer टोकन से प्रमाणीकरण

बॉडी

application/json
model
string
आवश्यक
models
string[]

model के बाद आज़माए जाने वाले वैकल्पिक, क्रमबद्ध फ़ॉलबैक मॉडल। model आवश्यक है और हमेशा प्राथमिक मॉडल होता है। जब कोई प्रयास 429, 500, 502, 503 या 504 के साथ विफल होता है, तो अगली प्रविष्टि आज़माई जाती है; अन्य त्रुटियाँ बिना बदलाव के लौटाई जाती हैं। अधिकतम 25 मॉडल ID या प्रीसेट स्वीकार करता है; डुप्लिकेट और model के समान प्रविष्टियाँ अनदेखी की जाती हैं। हर प्रयास को अलग अनुरोध के रूप में सत्यापित, लॉग और बिल किया जाता है, और प्रतिक्रिया का model फ़ील्ड तथा रूटिंग ट्रेस उस मॉडल को दिखाते हैं जिसने अनुरोध पूरा किया। स्ट्रीमिंग अनुरोध केवल पहले बाइट से पहले फ़ॉलबैक करते हैं, और वीडियो तथा संगीत जॉब केवल सबमिशन के समय। Batch, realtime और council अनुरोध models को अस्वीकार करते हैं। डायनामिक रूट पर सेट किए गए फ़ॉलबैक को प्राथमिकता मिलती है, और phaseo/auto को models के साथ नहीं जोड़ा जा सकता।

Required array length: 1 - 25 elements
Minimum string length: 1
उदाहरण:
prompt
string
duration
integer
format
enum<string>
उपलब्ध विकल्प:
mp3,
wav,
ogg,
aac
provider
object

गेटवे चयन के लिए प्रदाता रूटिंग प्राथमिकताएँ।

suno
object
elevenlabs
object
echo_upstream_request
boolean
debug
object

गेटवे डिबग नियंत्रण। ये फ़्लैग कभी भी प्रदाता को फ़ॉरवर्ड नहीं किए जाते।

प्रतिक्रिया

200 - application/json

संगीत निर्माण प्रतिक्रिया

id
string
आवश्यक

स्थिर Phaseo अनुरोध ID, जिसका उपयोग GET /music/generate/{music_id} के साथ किया जाता है।

object
enum<string>
आवश्यक
उपलब्ध विकल्प:
music
status
enum<string>
आवश्यक
उपलब्ध विकल्प:
queued,
in_progress,
completed,
failed
model
string
आवश्यक
provider
string
आवश्यक
nativeResponseId
string | null

सहसंबंध और सहायता के लिए upstream प्रदाता पहचानकर्ता।

audio_url
string<uri>
audio_base64
string
result
any

Phaseo द्वारा सामान्यीकृत प्रदाता परिणाम मेटाडेटा।

output
object[]
usage
object
अंतिम संशोधन 16 नवंबर 2026