Skip to main content
POST
  1. Submit the request with VIDGO_API_KEY. A task_id is returned immediately. Keep it until the task reaches finished or failed.
  2. 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 duration is a number from 3 to 600 seconds. Use it only with text.
  • Composition plan - Each section accepts 3-120 seconds.

Output Options

Output Format

  • output_format: Optional. String. Default: mp3_44100_128.
  • mp3_22050_32
  • mp3_44100_32
  • mp3_44100_64
  • mp3_44100_96
  • mp3_44100_128
  • mp3_44100_192
  • pcm_8000
  • pcm_16000
  • pcm_22050
  • pcm_24000
  • pcm_44100
  • pcm_48000
  • ulaw_8000
  • alaw_8000
  • opus_48000_32
  • opus_48000_64
  • opus_48000_96
  • opus_48000_128
  • opus_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

Set model 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 text or composition_plan.
  • duration and is_instrumental apply only to text. Use respect_sections_durations only with composition_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 from 3 to 120.
  • 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 with true. Default: false for 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. Use true or false. Default: true for the composition-plan path.

Output Files

  • Read every item in the returned files array.
  • 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 to POST 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.
Download audio
Download audio
Download audio

Authorizations

Authorization
string
header
required

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.

model
enum<string>
required
Available options:
elevenlabs/music
Example:

"elevenlabs/music"

input
object
required

Provide exactly one of text or composition_plan. With text, omit respect_sections_durations. With composition_plan, omit duration and is_instrumental.

callback_url
string | null

Optional public HTTP(S) endpoint for task completion notifications. HTTPS is recommended. Omit, use null, or use an empty string to disable callbacks.

Response

Task submitted

code
enum<integer>
required
Available options:
200
data
object
required