generate_audio_track
Generate AI audio and place it on the edit timeline. Match sourceDuration and modelSettings to the approved quote, pass maxCostUsd and a stable idempotencyKey. Retries reuse the media and original attachment, preserving subsequent timeline edits.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"workspaceId": "<workspaceId>",
"editId": "<editId>",
"prompt": "<prompt>"
},
"name": "generate_audio_track"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | Audio model ID | |
| editId | Yes | The edit ID | |
| prompt | Yes | TTS/music/SFX prompt | |
| volume | No | Initial volume | |
| voiceId | No | Voice ID for TTS models | |
| duration | No | Placeholder timeline duration until generation metadata updates | |
| startTime | No | Timeline start time in seconds | |
| approvalId | No | Combined production approval ID returned by set_proposal_status. | |
| fadeInTime | No | Fade-in length in seconds | |
| maxCostUsd | No | Maximum charge for each output. Checked against authoritative pricing before generation. | |
| autoChannel | No | Pick the first non-overlapping channel automatically | |
| fadeOutTime | No | Fade-out length in seconds | |
| stylePrompt | No | Delivery and accent direction for supported speech models | |
| workspaceId | Yes | The workspace ID | |
| approvalJobId | No | Exact production jobId covered by that combined approval. | |
| modelSettings | No | Model-specific controls using keys and options from get_model_catalog inputConstraints.slots or variantSelector. | |
| idempotencyKey | No | Stable request key. Retries with the same key reuse the existing output and do not start another paid generation. | |
| pinnedToShotId | No | Optional shot ID to pin this audio to | |
| sourceDuration | No | Generated audio source duration in seconds, separate from timeline duration. Match the approved quote. | |
| relativeStartTime | No | Offset in seconds from pinned shot start |