Skip to main content
POST
संगीत बनाएँ
एक प्रदाता-स्वतंत्र API के ज़रिए संगीत बनाएँ। Phaseo सिंक्रोनस प्रतिक्रियाओं और प्रदाता कतार की जाँच को पर्दे के पीछे संभालता है। जनरेशन पूरा होने पर प्रतिक्रिया में audio_url या audio_base64 शामिल होता है। यदि प्रदाता ऐसा जॉब लौटाता है जो अभी पूरा नहीं हुआ है, तो उसी प्रतिक्रिया के id के साथ GET /music/generate/{music_id} उपयोग करें।

अनुरोध का स्वरूप

Suno विकल्प

  • suno.customMode (बूलियन, डिफ़ॉल्ट false)
  • suno.instrumental (बूलियन, डिफ़ॉल्ट false)
  • suno.prompt (शीर्ष-स्तरीय prompt का वैकल्पिक ओवरराइड)
  • suno.style, suno.title (customMode = true होने पर आवश्यक)
  • suno.personaId, suno.personaModel
  • suno.negativeTags, suno.vocalGender
  • suno.styleWeight, suno.weirdnessConstraint, suno.audioWeight

मान्यकरण नियम

  • customMode = false होने पर prompt आवश्यक है।
  • customMode = true होने पर style और title दोनों आवश्यक हैं।
  • customMode = true और instrumental = false होने पर prompt आवश्यक है।
मान्यकरण त्रुटियाँ 400 के साथ यह लौटाती हैं:

जवाब

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

प्राधिकरण

Authorization
string
header
आवश्यक

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

बॉडी

application/json
model
string
आवश्यक
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
अंतिम संशोधन 2 अक्टूबर 2026