add_transition
Apply a transition at a clip edge or between two clips to create a two-sided edit point; choose video or audio effects, duration, alignment, and parameters.
Instructions
Apply a transition at a clip's edge (default: Cross Dissolve for video, Constant Power for audio). An edit point between two clips gets a two-sided transition.
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": {
"clip": "<clip>"
},
"name": "add_transition"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| clip | Yes | Timeline clip id (from list_timeline) | |
| edge | No | Which edge; omit for the nearest edit | |
| align | No | ||
| audio | No | Apply an audio transition instead | |
| effect | No | e.g. "Cross Dissolve", "Dip to Black", "Film Dissolve" | |
| frames | No | Duration in frames (default: the app's default, 1 s) | |
| params | No | Transition parameters, e.g. {"color": [1, 0.5, 0.15, 1], "amount": 100} for light_leak | |
| project | No | Path to the .fcproj project file; omit to edit the FilmCraft app connected with connect_app |