Add an attached or linked file to the Playground canvas
playground_asset_importAdd one image (PNG, JPEG, WebP, ≤8 MB), video (MP4, ≤16 MB) or audio file (MP3 or WAV, ≤12 MB) to the canvas as a file node that can feed image and video generation. Pass exactly one source: file for a file the user attached in this chat (Berrys downloads it itself; no upload step), or url for a public HTTPS link. Bytes are checked and copied into project storage. Private, local and internal addresses are refused, and every redirect is rechecked. Free; revision checked and idempotent. Returns imported asset node details, 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>",
"expectedRevision": "<expectedRevision>",
"idempotencyKey": "<idempotencyKey>"
},
"name": "playground_asset_import"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | Public media URL to import as a canvas asset; for chat attachments use file instead. A public HTTPS link to the media. Omit when passing file. | |
| file | No | A file the user attached in chat, as provided by the host. Omit when passing url. | |
| kind | No | Media type to create or import, selected from the supported values. | |
| projectId | Yes | ID of the Playground project chosen for this task; obtain it from project creation, an explicit project link or current context. | |
| 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 |
|---|---|---|---|
| kind | Yes | ||
| nodeId | Yes | ||
| sha256 | No | ||
| mediaUrl | Yes | ||
| mimeType | Yes | ||
| replayed | Yes | ||
| revision | Yes | ||
| canvasUrl | Yes | ||
| sourceUrl | Yes |