Music 1.0

Use Music 1.0 for prompt-driven music generation. The request is text-first; optional image conditioning is supported. Provider model ids stay internal.

Primary invoke URL:

Model-run alias (same body):

Public model id: sume/music-1.0.

When to use

Goal	Approach
Text → music	prompt only
Visual conditioning	prompt + optional image_url
Steer away from styles	put exclusions in the positive prompt (e.g. “no vocals, no spoken word”)

Hard constraints

• Do not send duration or duration_seconds. They are unrecognized and rejected on Music 1.0.
• Do not send a non-empty negative_prompt. Music 1.0 / Lyria 3 does not support negative prompting; non-empty values return HTTP 400 with public_reason=negative_prompt_unsupported. Omit the field or send "".
• Prompt max length is 5000 characters.
• Image URLs must be public HTTPS. Send null for image_url only when you intentionally clear an image input on a client that reuses request objects.

Request fields

Field	Required	Notes
prompt	Yes	1–5000 characters. Include exclusions in the positive prompt.
negative_prompt	No	Unsupported when non-empty. Omit or send "".
image_url	No	Optional public HTTPS image URL, or null to clear.
metadata	No	Caller metadata stored on the job; not sent to the provider.
mode	No	async, sync, subscribe, webhook.
webhook_url	No	Public HTTPS callback for webhook mode.
wait_timeout_seconds	No	0–30 for sync / subscribe.

Create a music job

Image-conditioned example:

Poll and fetch the result

On success, read the audio artifact from result.artifacts[] where type is audio (typically audio/mpeg on media.sume.com).

Artifacts

Completed Music 1.0 jobs return Sume-hosted audio artifacts:

Use Sume media URLs from the result. Raw provider URLs are not public outputs.

Pricing

Fixed $0.10 USD per accepted Music 1.0 generation. Price does not vary by prompt length or optional image conditioning.

Next

• Jobs and results for polling and webhooks
• Recipes for short copy-paste flows