Skip to navigation
REST API ReferenceEndpointsTools

Generate music

Generate an instrumental music track from a text description. Set durationSeconds to choose the track length, or omit it for a three-minute track. VideoGen automatically routes each request to the most effective state-of-the-art music model for your prompt, so you don’t pick a model.

Authentication

AuthorizationBearer

API key from app.videogen.io/api. The full key is only shown once when you create it.

Request

This endpoint expects an object.
promptstringRequired
A text description of the music to generate. Include genre, mood, instrumentation, and tempo for best results.
durationSecondsdouble or nullOptional3-600
Desired track length in seconds, between 3 and 600. Defaults to 180 seconds when omitted or null.
numResultsintegerOptional1-100Defaults to 1
Number of output results to generate. Defaults to 1.
isOutputTemporarybooleanOptionalDefaults to false

When true, generated files are temporary. Temporary files are guaranteed to be available for 24 hours, after which they may be archived at any time. Temporary files are not analyzed (no description, transcript, or embedding will be generated), so they will not appear in search results. Defaults to false.

Response

Execution accepted; poll until complete.

toolExecutionIdstring

Execution id (e.g. vg_tool_...).