Skip to main content

Generates music from text prompts, logs request, calculates cost, streams audio, and provides metadata.

POST 

/studio/music

Workflow:

  1. Validates that Prompt and Provider are supplied.

  2. Resolves the selected provider group for music and rejects if not found.

  3. Creates and persists an OrcaRequest in InProgress state.

  4. Estimates prompt/completion tokens and cost using provider-specific estimators and saves them.

  5. Invokes the provider to generate music (stream), then saves the stream as an OrcaAssetType.Music.

  6. Returns a GeneratedResponse referencing the saved media.

    This endpoint returns HTTP 200 in both success and handled-error cases; callers should inspect the Error field to detect validation/provider errors.

Request

Responses

Always 200; payload indicates success or error.