Gateway

Generate music (alias)

Alias of /music/generate.

post/music/generations

Request

  • Base URL: https://api.phaseo.app/v1
  • URL: https://api.phaseo.app/v1/music/generations
  • Auth: HTTP bearer

Request body

modelstring required
modelsstring[]

Optional ordered fallback models tried after model. model is required and is always the primary model. When an attempt fails with 429, 500, 502, 503, or 504, the next entry is tried; other errors are returned unchanged. Accepts up to 25 model IDs or presets; duplicates and entries equal to model are ignored. Each attempt is validated, logged, and billed as its own request, and the response model field and routing trace show the model that served the request. Streaming requests fall back only before the first byte, and video and music jobs fall back only at submission. Batch, realtime, and council requests reject models. Fallbacks set on a dynamic route take precedence, and phaseo/auto cannot be combined with models.

promptstring
durationinteger
format'mp3' | 'wav' | 'ogg' | 'aac'
echo_upstream_requestboolean

Example request

{
  "models": [
    "anthropic/claude-sonnet-5-5",
    "google/gemini-2.5-flash"
  ]
}

Response

Music generation response

idstring required

Stable Phaseo request ID used with GET /music/generate/{music_id}.

object'music' required
status'queued' | 'in_progress' | 'completed' | 'failed' required
modelstring required
providerstring required
nativeResponseIdstring nullable

Upstream provider identifier for correlation and support.

audio_urlstring uri
audio_base64string
resultunknown
outputobject[]
usageobject

Changes

No recorded changes to this operation across all 1 revision of this API.