Run image, video and audio nodes
playground_node_runRun the generation already configured on 1–20 existing image, video or audio nodes. Image: prompt (its Text node), modelId, aspectRatio, wired references. Video: instructions, modelId, aspectRatio, duration, wired references and first/last frames. Audio: the node's own instructions (speech: the words; music: the lyrics), modelId (minimax:speech-2.8-hd, minimax:speech-2.8-turbo, minimax:music-2.5, minimax:music-1.5), voice (speech) or style (music) — set them with playground_canvas_apply_operations; wired Text nodes are refused for audio. Prompt Helper and Video Story nodes cannot run here (they run in the browser). quote: true returns a free, ten-minute quoteId and exact credits; execution requires that quoteId. It returns exact credits per node and spends nothing (canvas:read). Otherwise it requires project edit access and returns approval_required with exact scopes, fingerprints and credit ceilings for the user to review and confirm in this chat. After approval, poll playground_media_job_get or read playground_node_get. A retried idempotencyKey never 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>",
"nodeIds": "<nodeIds>",
"expectedRevision": "<expectedRevision>",
"idempotencyKey": "<idempotencyKey>"
},
"name": "playground_node_run"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| quote | No | When true, return pricing without executing paid generation; show the quote and obtain user approval before spending. | |
| nodeIds | Yes | IDs of the existing canvas nodes to use for this action. | |
| quoteId | No | 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 |