media_generate
orchestration
beta
auth: media:write
approval: suggest
status: v1
Generate music, speech, dialogue, sound effects, or shot-scoped scene audio.
When to use
Use for non-visual media generation workflows.
Use `workflow=scene_audio` for Seed Audio shot/scene mixes that may include dialogue, ambience, Foley, and selected voice references.
When not to use
Do not use for still images or videos.
Do not use to upload or attach reusable voice samples; use `asset_upload(target_type=reference_audio_asset)` and `voice_profile`.
Examples
“Generate suspense music for this scene.”
“Generate 30 seconds of shot audio for shot 101 with Mira's selected voice reference.”
Anti-examples
- Generate a storyboard image.
- Attach an existing voice sample to a character profile.
Workflows
Switch behavior by setting the workflow input field.
music
readiness
start
finalize
speech
readiness
start
finalize
dialogue
readiness
start
finalize
sound_effect
readiness
start
finalize
scene_audio
readiness
start
finalize
Input schema
media_generate input
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"if_match_updated_at": {
"type": "string",
"description": "Optional optimistic-concurrency precondition. When provided, the mutation should fail if the backing object's updated_at has changed since the caller read it."
}
},
"additionalProperties": true
}Output schema
media_generate output
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"resource_updated_at": {
"type": "string",
"format": "date-time",
"description": "Generic updated_at value for read/propose outputs that need a round-trippable optimistic-concurrency timestamp."
},
"credits_charged": {
"type": "integer",
"minimum": 0,
"description": "Credits charged for this capability call when credit_metered=true."
},
"credits_skipped_reason": {
"type": "string",
"description": "Present instead of credits_charged when the capability intentionally skipped billing (e.g. cache hit, no-op, failed_before_llm)."
},
"pipeline_state": {
"$ref": "./_common/pipeline_state.schema.json"
},
"next_actions": {
"type": "array",
"items": {
"$ref": "./_common/next_action.schema.json"
}
}
},
"additionalProperties": true
}← All toolsv1 · workflow_runner