submit_video
Submit a video generation job. The result is a new library asset, not placed on the timeline: when the job completes, track_progress returns its id for edit_item. At most 10 video generations run at once per account across video tools; extra submits are rejected, so wait for a running job to finish instead of retrying. Models (set explicitly; the video-gen skill has selection rules):
seedance-2-5: 4-30s; 480p/720p/1080p; refs up to 30 images, 10 videos, 10 audios (MP3/WAV, audio-only allowed); taskMode edit/extend uses exactly one 4-30s refVideo. 480p clips are drafts: fromDraft -> 1080p final.
seedance2: 4-15s; 480p/720p/1080p/4k; refs up to 9 images, 3 videos, 3 audios (audio needs an image or video). seedance2fast (~20% cheaper) and seedance2mini (~50% cheaper): same inputs, 480p/720p only.
minimax-h3: 4-15s; 768p/2k; prompt up to 7000 chars; frames, or refs up to 9 images, 3 videos, 3 audios (12 files).
minimax-h3-max: faster; 5-15s; 480p/768p; minimax-h3 inputs, but audio needs an image or video.
omni (Gemini Omni 1.1 Flash): 3-10s; 360p/720p, upscaled 1080p/4k; first(+last) frame, up to 3 refImages, or edit/extend a clip up to 10s via continueFrom.
kling (Kling 3.0): 3-15s; 720p/1080p; frames plus refImages, 7 images in all; no refVideos/refAudios. kling-4 (Kling 4.0): same but 3-30s, 10 images, 5 refVideos (3-30s, 30s total). kling-4-flash: kling-4 but 3-20s (refVideos too), 720p only. Reference media (Seedance, MiniMax): clips 2-15s each, 15s total per type (Seedance 2.5: 2-30s, 30s); images/videos 300-5760 px per side, width/height 0.4-2.5, videos 24-60 fps (Seedance: 480p+; per-model bounds in the skill). Frames and references are mutually exclusive. No negative prompt or seed: put exclusions in the prompt.
External MCP spend rule: this tool costs ChatCut credits and starts an async generation job. Only call it when the user's request or confirmation clearly covers this exact generation; do not silently create extra variants, longer durations, higher quality, or additional outputs.
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": {
"model": "<model>"
},
"name": "submit_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| model | Yes | Model alias; limits in the tool description. | |
| ratio | No | 16:9 default; 9:16,1:1,4:3,3:4,21:9. Omni:16:9/9:16; Kling:16:9/9:16/1:1; Kling4:+21:9. Frames set the ratio; explicit ratio center-crops seedance2/seedance2fast/seedance2mini. Seedance2.5, MiniMax and Kling always follow the image; Kling4 follows inputs. Seedance edit/extend follow source. | |
| prompt | No | Video prompt. Required except with fromDraft. | |
| taskMode | No | Seedance 2.5 or Omni only. "edit" and "extend" change or continue the source clip (exactly one refVideos for Seedance 2.5, continueFrom for Omni). "generate" (default) makes a new clip, including from video references. "edit" uses source-based timing instead of durationSeconds. Check the returned frame count, duration, and framing before using it as a synchronized replacement. "extend" adds durationSeconds. Both create a new asset. | |
| fromDraft | No | Seedance 2.5: approved 480p draft assetId, within 7 days, to 1080p final. Omit prompt, references, duration, ratio and audio (reused); changing any needs a new 480p draft. | |
| lastFrame | No | Last-frame image; needs firstFrame except on minimax-h3 and Kling. Only Kling combines frames with references. | |
| projectId | No | Full project UUID. Required for external browser work; internal agents may omit. Execution/explicit-timeline calls never change later calls' target. | |
| refAudios | No | Ordered reference audio: asset ids or public URLs. Seedance 2.0 needs an image or video alongside. | |
| refImages | No | Ordered reference images: asset ids or public HTTPS/s3:// URLs (URLs need no import). | |
| refVideos | No | Ordered reference videos: asset ids or public URLs. Billed by measured duration. | |
| firstFrame | No | Strict first-frame image: asset id, asset://id, or public HTTPS/s3:// URL. Cannot be combined with references or continueFrom. | |
| resolution | No | Per-model options are in the tool description. Default 720p; MiniMax 768p. Seedance 4k is seedance2 only: 10-bit HEVC, noticeably slower. Seedance cost scales with pixels x seconds (1080p ~2.5x 720p, 4k ~2x 1080p). seedance-2-5 480p is a draft: same price, and fromDraft can turn it into the 1080p final. | |
| timelineId | No | Full timeline UUID, not a prefix. Required for browser work, even unplaced assets. Get it from read_project or manage_timelines action="list". Never switches visible timeline. | |
| continueFrom | No | Omni only: the clip to edit or extend (asset id, asset://id, or public HTTPS/s3:// URL), up to 10s. Each result is a new asset; preservation is not pixel-exact. | |
| middleFrames | No | kling-4 only, not Flash; part of the 10-image cap. Prompt: @keyframe_1, @keyframe_2… by time; describe motion between them. | |
| outputFormat | No | Seedance 2.5 only. Omit unless the user asks for a container. | |
| idempotencyKey | No | Stable key for this browser execution. Reuse only with identical scope and parameters after a lost acknowledgement; applies only to this call. | |
| durationSeconds | No | Integer seconds within the model's range; default 5. For Omni extend, the seconds to add. "8s" is accepted. | |
| returnLastFrame | No | Seedance: save the last frame as an unwatermarked, full-resolution Ark JPEG asset. Reuse as the next firstFrame when chaining clips. | |
| browserProfileId | No | Optional browser profile override. Omit to select automatically; do not ask the user to choose. |