create_edit
Create a new edit (project) in a workspace. Before planning a new multi-step project, discover and load a matching workflow with list_sequencer_skills and get_sequencer_skill, and consult get_model_catalog modelSelectionGuidance. Aspect ratio is required because it controls every generated shot; use 9:16 for vertical/social films unless the user asks for another format. Defaults are Nano Banana 2.1 (google-nano-banana-2-1) for still images, Gemini Omni 1.2 Flash (google-gemini-omni-1-2) for videos, and Cartesia Sonic 3.6 (cartesia-sonic-3-6) for speech. Returns the new edit ID.
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>",
"title": "<title>",
"aspectRatio": "<aspectRatio>"
},
"name": "create_edit"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | Title for the new edit | |
| aspectRatio | Yes | Required project aspect ratio. Use 9:16 for vertical/social films unless the user explicitly asks otherwise. | |
| workspaceId | Yes | The workspace ID | |
| defaultImageModel | No | Default still-image model ID. Defaults to Nano Banana 2.1 (google-nano-banana-2-1). | |
| defaultVideoModel | No | Default video model ID. Defaults to Gemini Omni 1.2 Flash (google-gemini-omni-1-2). |