Generates music from text prompts, logs request, calculates cost, streams audio, and provides metadata.
POST/studio/music
Workflow:
-
Validates that
PromptandProviderare supplied. -
Resolves the selected provider group for music and rejects if not found.
-
Creates and persists an
OrcaRequestinInProgressstate. -
Estimates prompt/completion tokens and cost using provider-specific estimators and saves them.
-
Invokes the provider to generate music (stream), then saves the stream as an
OrcaAssetType.Music. -
Returns a
GeneratedResponsereferencing the saved media.This endpoint returns HTTP 200 in both success and handled-error cases; callers should inspect the
Errorfield to detect validation/provider errors.
Request
Responses
- 200
Always 200; payload indicates success or error.