beatra

Music API

Preview music generation endpoints.

Status: Preview — callable through async tasks.

Operations

EndpointDescription
POST /v1/music/text-to-musicGenerate music from prompt, optional lyrics, and model options.
POST /v1/music/reference-audio-to-musicGenerate music from reference audio and prompt guidance.

Both endpoints return 202 Accepted with a task envelope. Poll GET /v1/tasks/{task_id} for completion.

Models

Use model: "auto" while prototyping, or choose suno-5.5 / minimax-music-2.6 when your account exposes that model.

Shared request fields are top-level. Model-specific options live under model_options.suno or model_options.minimax.

On this page