Gateway

Generate music

Generates music through one provider-independent endpoint. Phaseo waits for synchronous providers and handles provider queue polling internally.

post/music/generate

Request

Base URL: https://api.phaseo.app/v1
URL: https://api.phaseo.app/v1/music/generate
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.