curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "elevenlabs/music",
"input": {
"composition_plan": {
"positive_global_styles": [
"indie folk with subtle organic electronica",
"96 BPM, 4/4",
"warm clear female lead vocal",
"acoustic guitar, rounded bass, delicate electronic percussion",
"hopeful intimate song about planting a rooftop garden",
"clean spacious studio mix, clear Mandarin and English diction"
],
"negative_global_styles": [
"harsh distortion",
"crowded arrangement",
"spoken narration",
"abrupt cut off"
],
"sections": [
{
"section_name": "Acoustic introduction",
"duration": 8,
"positive_local_styles": [
"instrumental only",
"fingerpicked acoustic guitar introduces a memorable gentle motif",
"soft airy pad, no drums"
],
"negative_local_styles": [],
"lines": []
},
{
"section_name": "Mandarin verse",
"duration": 16,
"positive_local_styles": [
"sing the supplied Mandarin lyrics clearly",
"intimate gentle lead vocal",
"fingerpicked guitar and soft bass, restrained percussion"
],
"negative_local_styles": [],
"lines": [
"把春天种在屋顶上",
"等风翻过旧砖墙"
]
},
{
"section_name": "English chorus",
"duration": 16,
"positive_local_styles": [
"sing the supplied English lyrics clearly",
"open uplifting melody",
"full warm drums and bass enter",
"layered backing vocal harmonies, retain the acoustic motif"
],
"negative_local_styles": [],
"lines": [
"Little seeds above the street",
"Find the sunlight, find the beat"
]
},
{
"section_name": "Instrumental resolution",
"duration": 8,
"positive_local_styles": [
"instrumental only, no vocals",
"return to fingerpicked guitar motif",
"drums fall away, warm sustained final chord with natural decay"
],
"negative_local_styles": [],
"lines": []
}
]
},
"respect_sections_durations": true,
"output_format": "mp3_44100_128"
}
}
'
{
"code": 200,
"data": {
"task_id": "W6KDNIQQOUAE1K8V",
"status": "running",
"created_time": "2026-09-27T10:48:12"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}"Request timeout"{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}ElevenLabs
ElevenLabs Music
Compose songs or instrumentals from a text brief or a section-by-section plan, with control over musical style, lyrics, and arrangement.
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "elevenlabs/music",
"input": {
"composition_plan": {
"positive_global_styles": [
"indie folk with subtle organic electronica",
"96 BPM, 4/4",
"warm clear female lead vocal",
"acoustic guitar, rounded bass, delicate electronic percussion",
"hopeful intimate song about planting a rooftop garden",
"clean spacious studio mix, clear Mandarin and English diction"
],
"negative_global_styles": [
"harsh distortion",
"crowded arrangement",
"spoken narration",
"abrupt cut off"
],
"sections": [
{
"section_name": "Acoustic introduction",
"duration": 8,
"positive_local_styles": [
"instrumental only",
"fingerpicked acoustic guitar introduces a memorable gentle motif",
"soft airy pad, no drums"
],
"negative_local_styles": [],
"lines": []
},
{
"section_name": "Mandarin verse",
"duration": 16,
"positive_local_styles": [
"sing the supplied Mandarin lyrics clearly",
"intimate gentle lead vocal",
"fingerpicked guitar and soft bass, restrained percussion"
],
"negative_local_styles": [],
"lines": [
"把春天种在屋顶上",
"等风翻过旧砖墙"
]
},
{
"section_name": "English chorus",
"duration": 16,
"positive_local_styles": [
"sing the supplied English lyrics clearly",
"open uplifting melody",
"full warm drums and bass enter",
"layered backing vocal harmonies, retain the acoustic motif"
],
"negative_local_styles": [],
"lines": [
"Little seeds above the street",
"Find the sunlight, find the beat"
]
},
{
"section_name": "Instrumental resolution",
"duration": 8,
"positive_local_styles": [
"instrumental only, no vocals",
"return to fingerpicked guitar motif",
"drums fall away, warm sustained final chord with natural decay"
],
"negative_local_styles": [],
"lines": []
}
]
},
"respect_sections_durations": true,
"output_format": "mp3_44100_128"
}
}
'
{
"code": 200,
"data": {
"task_id": "W6KDNIQQOUAE1K8V",
"status": "running",
"created_time": "2026-09-27T10:48:12"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}"Request timeout"{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}- Submit the request with
VIDGO_API_KEY. Atask_idis returned immediately. Keep it until the task reachesfinishedorfailed. - Use Query Task Status to retrieve the result. If you provide a
callback_url, Vidgo sends the result to your webhook when the task finishes or fails.
ElevenLabs Music
Compose songs or instrumentals from a text brief or a section-by-section plan, with control over musical style, lyrics, and arrangement.Available Models
- elevenlabs/music - Generate music from text or a structured composition plan.
Duration Options
- Text input - Optional
durationis a number from 3 to 600 seconds. Use it only withtext. - Composition plan - Each section accepts 3-120 seconds.
Output Options
Output Format
output_format: Optional. String. Default:mp3_44100_128.
Supported output format values
Supported output format values
mp3_22050_32mp3_44100_32mp3_44100_64mp3_44100_96mp3_44100_128mp3_44100_192pcm_8000pcm_16000pcm_22050pcm_24000pcm_44100pcm_48000ulaw_8000alaw_8000opus_48000_32opus_48000_64opus_48000_96opus_48000_128opus_48000_192
Key Features
- Generate music from text or a structured composition plan.
- Plan musical sections with their own styles, lyrics, and durations.
- Choose an output encoding with
output_format.
Advanced Parameters
Setmodel and optional callback_url at the request root. Place all workflow parameters, including output options, inside input.
Choose one creative path: a text brief or a structured composition plan.
- Provide exactly one of
textorcomposition_plan. durationandis_instrumentalapply only totext. Userespect_sections_durationsonly withcomposition_plan.
Text
text: Required for the text path. Describe the music to generate. Length: 1-4,100 characters.- Include a music description with the desired genre, mood, and instruments.
Composition Plan
-
composition_plan: Required for the composition-plan path. Describe global styles and an ordered list of musical sections. Supply an object with the fields below. -
composition_plan.positive_global_styles: Required. Supply an array. Each item must be a string. -
composition_plan.negative_global_styles: Required. Supply an array. Each item must be a string. -
composition_plan.sections: Required. Supply at least 1 item. Each item is an object. -
composition_plan.sections[].section_name: Required. Length: 1-100 characters. -
composition_plan.sections[].positive_local_styles: Required. Supply an array. Each item must be a string. -
composition_plan.sections[].negative_local_styles: Required. Supply an array. Each item must be a string. -
composition_plan.sections[].duration: Required. Duration in seconds. Number from3to120. -
composition_plan.sections[].lines: Required. Supply an array. Each item must be a string. Each string is limited to 200 characters. - Section durations are measured in seconds.
Instrumental Mode
is_instrumental: Optional. Request instrumental music withtrue. Default:falsefor the text path.- Use only with
text.
Section Timing
respect_sections_durations: Optional. Use only with a composition plan to control adherence to section durations. Usetrueorfalse. Default:truefor the composition-plan path.
Output Files
- Read every item in the returned
filesarray. - Generated audio uses
file_type: "audio". - Timestamp and alignment files may use
file_type: "other". Preserve optional file metadata when present.
Examples
Each example pairs a request with its completed task response and generated audio. Submit the request toPOST https://api.vidgo.ai/api/generate/submit, then query GET https://api.vidgo.ai/api/generate/status/{task_id} with the task ID returned by your submission.
Spring on the Rooftop
Spring on the Rooftop
{
"model": "elevenlabs/music",
"input": {
"composition_plan": {
"positive_global_styles": [
"indie folk with subtle organic electronica",
"96 BPM, 4/4",
"warm clear female lead vocal",
"acoustic guitar, rounded bass, delicate electronic percussion",
"hopeful intimate song about planting a rooftop garden",
"clean spacious studio mix, clear Mandarin and English diction"
],
"negative_global_styles": [
"harsh distortion",
"crowded arrangement",
"spoken narration",
"abrupt cut off"
],
"sections": [
{
"section_name": "Acoustic introduction",
"duration": 8,
"positive_local_styles": [
"instrumental only",
"fingerpicked acoustic guitar introduces a memorable gentle motif",
"soft airy pad, no drums"
],
"negative_local_styles": [],
"lines": []
},
{
"section_name": "Mandarin verse",
"duration": 16,
"positive_local_styles": [
"sing the supplied Mandarin lyrics clearly",
"intimate gentle lead vocal",
"fingerpicked guitar and soft bass, restrained percussion"
],
"negative_local_styles": [],
"lines": [
"把春天种在屋顶上",
"等风翻过旧砖墙"
]
},
{
"section_name": "English chorus",
"duration": 16,
"positive_local_styles": [
"sing the supplied English lyrics clearly",
"open uplifting melody",
"full warm drums and bass enter",
"layered backing vocal harmonies, retain the acoustic motif"
],
"negative_local_styles": [],
"lines": [
"Little seeds above the street",
"Find the sunlight, find the beat"
]
},
{
"section_name": "Instrumental resolution",
"duration": 8,
"positive_local_styles": [
"instrumental only, no vocals",
"return to fingerpicked guitar motif",
"drums fall away, warm sustained final chord with natural decay"
],
"negative_local_styles": [],
"lines": []
}
]
},
"respect_sections_durations": true,
"output_format": "mp3_44100_128"
}
}
{
"code": 200,
"data": {
"task_id": "W6KDNIQQOUAE1K8V",
"status": "finished",
"created_time": "2026-09-27T10:48:12",
"progress": 100,
"error_message": null,
"files": [
{
"file_type": "audio",
"file_url": "https://cdn.vidgo.ai/apis/models/elevenlabs/music/text-to-audio/v1/01/output.mp3"
}
]
}
}
The Clockmaker's Clues
The Clockmaker's Clues
{
"model": "elevenlabs/music",
"input": {
"text": "Create a 30-second instrumental jazz cue for a puzzle scene in a clockmaker's workshop. 104 BPM, lightly swinging 4/4, playful curiosity with a hint of mystery. Use plucked upright bass, brushed drums, muted trumpet and vibraphone, each clearly separated in a warm intimate acoustic mix. Begin with a distinctive four-note vibraphone motif over bass; let muted trumpet answer and develop that motif in the middle, while brush accents subtly increase the momentum. Resolve with a short, clean ensemble cadence and allow the last note to decay naturally. No vocals, choir, spoken words, ticking sound effects or abrupt cutoff.",
"duration": 30,
"is_instrumental": true,
"output_format": "mp3_44100_128"
}
}
{
"code": 200,
"data": {
"task_id": "EBXJLNFGE8WD7114",
"status": "finished",
"created_time": "2026-09-27T10:48:48",
"progress": 100,
"error_message": null,
"files": [
{
"file_type": "audio",
"file_url": "https://cdn.vidgo.ai/apis/models/elevenlabs/music/text-to-audio/v1/02/output.mp3"
}
]
}
}
Light Through the Kelp Forest
Light Through the Kelp Forest
{
"model": "elevenlabs/music",
"input": {
"text": "Compose a 40-second instrumental score for a nature documentary gliding through a sunlit underwater kelp forest. 72 BPM, gently flowing 4/4. Felt piano, delicate harp harmonics, soft sustained strings and a subtle low ambient texture; luminous, patient, full of quiet wonder. Start sparsely with isolated felt-piano notes and wide space. Gradually introduce harp and strings into an expansive rising harmony through the middle third, suggesting shafts of light moving through long fronds. Gently thin the arrangement and finish on a peaceful resolved chord with natural reverb decay. Detailed soft dynamics, wide stereo depth, no heavy percussion, no vocals or choir, no narration, no water sound effects, no abrupt cutoff.",
"duration": 40,
"is_instrumental": true,
"output_format": "mp3_44100_128"
}
}
{
"code": 200,
"data": {
"task_id": "VAK9IGFH57XPEUGP",
"status": "finished",
"created_time": "2026-09-27T10:49:30",
"progress": 100,
"error_message": null,
"files": [
{
"file_type": "audio",
"file_url": "https://cdn.vidgo.ai/apis/models/elevenlabs/music/text-to-audio/v1/03/output.mp3"
}
]
}
}
Authorizations
Use VIDGO_API_KEY.
Body
application/json
Set model and optional callback_url at the root. Place the creative path and its controls inside input.
Available options:
elevenlabs/music Example:
"elevenlabs/music"
Provide exactly one of text or composition_plan. With text, omit respect_sections_durations. With composition_plan, omit duration and is_instrumental.
Show child attributes
Show child attributes
Optional public HTTP(S) endpoint for task completion notifications. HTTPS is recommended. Omit, use null, or use an empty string to disable callbacks.