JsonCutDocs

Inline image and video rendering

Render a bounded HTML-first source once without creating a durable project.

Inline rendering is for disposable one-shot output. Use a project when a person or Agent will iterate, inspect versions, reuse media, or continue in Studio.

curl -X POST "$JSONCUT_API/api/v2/renders" \
  -H "X-API-Key: $JSONCUT_API_KEY" \
  -H "Idempotency-Key: inline-launch-card-01" \
  -H "Content-Type: application/json" \
  --data @inline-render.json
{
  "source": {
    "format": "jsoncut-html",
    "version": 1,
    "id": "inline-card",
    "name": "Inline card",
    "compositionKind": "image",
    "canvasBackground": "transparent",
    "width": 1200,
    "height": 630,
    "fps": 1,
    "duration": 1,
    "html": "<main id=\"card\"></main>",
    "css": "#card{position:absolute;inset:0;background:linear-gradient(135deg,#17191f,#ff9418)}",
    "variables": [],
    "values": {},
    "customBlocks": []
  },
  "kind": "image",
  "format": "png",
  "transparent": true,
  "retention": "temporary"
}

The same validator used by projects runs before queueing. Large media must be uploaded first; only small bounded data: URLs belong inline.

Poll GET /api/v2/renders/{id} and stream the result from /artifact. Temporary artifacts expire according to the returned retention metadata.