Creative
Betacreative_music_generate_default
Start a music generation job with the default model in the connected workspace.
Operation
Write. Requires read-and-write OAuth consent.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
body.prompt | string | Yes | Describe the music in up to 5,000 characters. |
body.image_url | string or null | No | Public HTTPS reference image. |
body.mode | string | No | Use async to receive a job immediately. |
idempotency_key | string | Yes | Reuse the key to retry the same input. |
approval_receipt | string | No | Plan receipt to submit after confirmation. |
Music 1.0 uses the same generator as lyria-3-pro. Describe the desired length in the prompt. The result contains an MP3 URL.
After confirming the plan, resubmit with its approval_receipt. Pass data.job.id to creative_jobs_wait, then retrieve the output with creative_jobs_result.
Sample prompt
Create an instrumental piano track for a sunrise video and return the MP3.