Extract frames from a Playground clip
playground_video_extract_framesTake the first and/or last frame of a finished clip and place each on the canvas as a Frame Grab node wired from the clip, holding a real stored image. A frame node can then feed an image → video node as first_frame or last_frame (playground_canvas_apply_operations connect with role). Only "first" and "last" are supported; a timestamp in seconds is refused. Free: no credits are spent. Revision checked and idempotent; it can take up to two minutes. Returns created frame node IDs, image URLs, revision and Playground URL.
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": {
"projectId": "<projectId>",
"videoNodeId": "<videoNodeId>",
"expectedRevision": "<expectedRevision>",
"idempotencyKey": "<idempotencyKey>",
"positions": "<positions>"
},
"name": "playground_video_extract_frames"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| positions | Yes | Frame positions to extract: first, last, or timestamps in seconds from the video start. | |
| projectId | Yes | ID of the Playground project chosen for this task; obtain it from project creation, an explicit project link or current context. | |
| videoNodeId | Yes | Existing canvas video node ID containing the source video. | |
| idempotencyKey | Yes | Unique key for this request; reuse only when retrying the identical request after a lost response. Use a new key after quoting or changing inputs. | |
| expectedRevision | Yes | Current canvas revision from canvas_read; on revision_conflict, read again and rebuild the change. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| next | Yes | Suggested next action; it does not authorize spending. | |
| frames | Yes | ||
| nodeIds | Yes | ||
| replayed | Yes | ||
| revision | Yes | ||
| canvasUrl | Yes | ||
| videoNodeId | Yes |