Generate images, videos and audio as new nodes
playground_media_generateBatch-generate 1–20 images, videos or audio tracks in one request. Each image/video item becomes a new node, with its prompt Text node and wired referenceNodeIds; each audio item becomes an audio node holding its words (prompt), modelId (default minimax:speech-2.8-hd), voice or style. Write each image/video prompt yourself from the references, following the model's prompt guide (quotes return promptGuides); never paste the user's request into it. Nodes are placed in free space in one revision-checked canvas edit, then run like playground_node_run. quote: true validates references, saves a ten-minute quoteId, prices every item and changes no canvas nodes; execution requires that quoteId (canvas:read). Otherwise it needs media:spend; every paid request returns approval_required for the user to confirm in their agent chat. A retried idempotencyKey never creates or charges twice.
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>",
"items": "<items>",
"expectedRevision": "<expectedRevision>",
"idempotencyKey": "<idempotencyKey>"
},
"name": "playground_media_generate"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | ||
| quote | No | When true, return pricing without executing paid generation; show the quote and obtain user approval before spending. | |
| quoteId | No | Exact quote ID returned by preparation or quoting; submit it with the unchanged quoted request. Required for execution: the unexpired quoteId returned by quote: true. | |
| 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 |
|---|---|---|---|
| next | No | Suggested next action; it does not authorize spending. | |
| error | No | ||
| items | No | ||
| nodes | No | ||
| runId | No | ||
| reason | No | ||
| review | No | ||
| status | Yes | ||
| balance | No | ||
| credits | No | ||
| nodeIds | No | ||
| quoteId | No | ||
| replayed | No | ||
| revision | No | ||
| canvasUrl | No | ||
| expiresAt | No | Serialized ISO timestamp. | |
| projectId | No | ||
| dispatchIds | No | ||
| confirmation | No | ||
| totalCredits | No | ||
| failedNodeIds | No | ||
| validitySeconds | No | ||
| approvalLocation | No | ||
| completedNodeIds | No | ||
| inputFingerprint | No | ||
| uncertainNodeIds | No | ||
| sufficientCredits | No | ||
| estimatedBalanceAfter | No |