GET

/v1/schemas/reactor/video/reactor%2Fhelios

kind inputactivity videohash 3c3d8415…extracted Sep 5, 2026version currentsource upstream spec ↗

Request body

0 properties · 0 required · 0 $defs

This schema isn’t a plain object with properties — showing the raw JSON instead.

application/json
{
  "provider": "reactor",
  "activity": "video",
  "endpointId": "reactor/helios",
  "kind": "input",
  "contentHash": "3c3d84156e25f357d67adb315ab75c555ab7c1adfc57c035bf9508bfc6bb866a",
  "specRevision": null,
  "provenance": {
    "sourceUrl": "https://reactor.inc/models/helios/api#reactor/helios",
    "sourceHash": "0ebfe4ae1fd68029167d1d131cc898c0e58cd403aed890ad189fc00d186c5cf0",
    "fetchedAt": 1788585060,
    "extractorVersion": "1",
    "derivation": "upstream-spec",
    "verifiedAt": null
  },
  "createdAt": 1788585060,
  "supersededAt": null,
  "schema": {
    "oneOf": [
      {
        "type": "object",
        "required": [
          "command",
          "data"
        ],
        "additionalProperties": false,
        "properties": {
          "command": {
            "type": "string",
            "const": "pause"
          },
          "data": {
            "type": "object",
            "properties": {}
          }
        }
      },
      {
        "type": "object",
        "required": [
          "command",
          "data"
        ],
        "additionalProperties": false,
        "properties": {
          "command": {
            "type": "string",
            "const": "reset"
          },
          "data": {
            "type": "object",
            "properties": {}
          }
        }
      },
      {
        "type": "object",
        "required": [
          "command",
          "data"
        ],
        "additionalProperties": false,
        "properties": {
          "command": {
            "type": "string",
            "const": "start"
          },
          "data": {
            "type": "object",
            "properties": {}
          }
        }
      },
      {
        "type": "object",
        "required": [
          "command",
          "data"
        ],
        "additionalProperties": false,
        "properties": {
          "command": {
            "type": "string",
            "const": "resume"
          },
          "data": {
            "type": "object",
            "properties": {}
          }
        }
      },
      {
        "type": "object",
        "required": [
          "command",
          "data"
        ],
        "additionalProperties": false,
        "properties": {
          "command": {
            "type": "string",
            "const": "rewind"
          },
          "data": {
            "type": "object",
            "properties": {
              "snapshot_index": {
                "type": "integer",
                "default": -1,
                "description": "Which snapshot to restore.  Positive values are snapshot IDs (numbered from 1): pass the ``snapshot_index`` from a previous ``snapshot_saved`` message to target that checkpoint.  Negative values count back from the newest snapshot held: ``-1`` (default) is the most recent, ``-2`` the one before it, and so on.  Either form emits ``rewind_failed`` if the target is not in the buffer.",
                "x-reactor-moderate": false
              }
            }
          }
        }
      },
      {
        "type": "object",
        "required": [
          "command",
          "data"
        ],
        "additionalProperties": false,
        "properties": {
          "command": {
            "type": "string",
            "const": "set_seed"
          },
          "data": {
            "type": "object",
            "properties": {
              "seed": {
                "type": "integer",
                "default": 0,
                "description": "Seed for the random generator used to sample the initial noise. Use `-1` to draw a fresh random seed. Read once when generation begins; later changes take effect only after `reset` followed by a new `start`.",
                "x-reactor-moderate": false
              }
            }
          }
        }
      },
      {
        "type": "object",
        "required": [
          "command",
          "data"
        ],
        "additionalProperties": false,
        "properties": {
          "command": {
            "type": "string",
            "const": "set_image"
          },
          "data": {
            "type": "object",
            "properties": {
              "image": {
                "$ref": "#/$defs/ReactorUploadReference",
                "default": null,
                "description": "Reference image uploaded via the Reactor presigned-URL protocol. PNG or JPEG; the image is center-cropped and resized to the model's output resolution. Preferred over `image_b64`.",
                "x-reactor-moderate": false
              },
              "image_b64": {
                "type": "string",
                "default": "",
                "description": "Deprecated. Base64-encoded reference image (PNG or JPEG), optionally prefixed with a `data:` URI. Provided for backward compatibility; use `image` instead. Ignored when `image` is also present.",
                "x-reactor-moderate": false
              }
            }
          }
        }
      },
      {
        "type": "object",
        "required": [
          "command",
          "data"
        ],
        "additionalProperties": false,
        "properties": {
          "command": {
            "type": "string",
            "const": "set_prompt"
          },
          "data": {
            "type": "object",
            "properties": {
              "prompt": {
                "type": "string",
                "default": "",
                "description": "Natural-language description of the scene to generate. Replaces any previously active prompt and takes effect on the next chunk.",
                "x-reactor-moderate": true
              }
            }
          }
        }
      },
      {
        "type": "object",
        "required": [
          "command",
          "data"
        ],
        "additionalProperties": false,
        "properties": {
          "command": {
            "type": "string",
            "const": "set_sr_scale"
          },
          "data": {
            "type": "object",
            "properties": {
              "sr_scale": {
                "enum": [
                  "off",
                  "2x",
                  "4x"
                ],
                "type": "string",
                "default": "2x",
                "description": "Super-resolution factor applied to each emitted frame. `off` disables upscaling, `2x` and `4x` upscale the output. May be changed at any time; the new scale applies to the next emitted chunk.",
                "x-reactor-moderate": false
              }
            }
          }
        }
      },
      {
        "type": "object",
        "required": [
          "command",
          "data"
        ],
        "additionalProperties": false,
        "properties": {
          "command": {
            "type": "string",
            "const": "save_snapshot"
          },
          "data": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "default": "",
                "description": "Optional human-readable label stored with the snapshot and returned by ``list_snapshots`` (e.g. ``'before-cat-scene'``). Purely decorative.",
                "x-reactor-moderate": false
              }
            }
          }
        }
      },
      {
        "type": "object",
        "required": [
          "command",
          "data"
        ],
        "additionalProperties": false,
        "properties": {
          "command": {
            "type": "string",
            "const": "list_snapshots"
          },
          "data": {
            "type": "object",
            "properties": {}
          }
        }
      },
      {
        "type": "object",
        "required": [
          "command",
          "data"
        ],
        "additionalProperties": false,
        "properties": {
          "command": {
            "type": "string",
            "const": "schedule_prompt"
          },
          "data": {
            "type": "object",
            "properties": {
              "chunk": {
                "type": "integer",
                "default": 0,
                "minimum": 0,
                "description": "Zero-based chunk index at which the prompt takes effect. Chunk indices match those reported by `chunk_complete`.",
                "x-reactor-moderate": false
              },
              "prompt": {
                "type": "string",
                "default": "",
                "description": "Natural-language description of the scene that should become active starting at the given chunk.",
                "x-reactor-moderate": true
              }
            }
          }
        }
      },
      {
        "type": "object",
        "required": [
          "command",
          "data"
        ],
        "additionalProperties": false,
        "properties": {
          "command": {
            "type": "string",
            "const": "set_conditioning"
          },
          "data": {
            "type": "object",
            "properties": {
              "image": {
                "$ref": "#/$defs/ReactorUploadReference",
                "default": null,
                "description": "Reference image uploaded via the Reactor presigned-URL protocol. PNG or JPEG; center-cropped and resized to the model's output resolution.",
                "x-reactor-moderate": false
              },
              "prompt": {
                "type": "string",
                "default": "",
                "description": "Natural-language description of the scene to generate. Replaces any previously active prompt and takes effect on the next chunk.",
                "x-reactor-moderate": true
              }
            }
          }
        }
      },
      {
        "type": "object",
        "required": [
          "command",
          "data"
        ],
        "additionalProperties": false,
        "properties": {
          "command": {
            "type": "string",
            "const": "set_image_strength"
          },
          "data": {
            "type": "object",
            "properties": {
              "image_strength": {
                "type": "number",
                "default": 1,
                "maximum": 1,
                "minimum": 0,
                "description": "How strongly the reference image anchors the generated video. `1.0` locks the first frame to the reference; lower values let the scene drift further from it. Ignored when no reference image has been set. May be changed at any time; the new value is read at the start of the next chunk.",
                "x-reactor-moderate": false
              }
            }
          }
        }
      }
    ],
    "$defs": {
      "ReactorUploadReference": {
        "type": "object",
        "format": "reactor-upload-reference",
        "required": [
          "upload_id",
          "name",
          "mime_type",
          "size"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "size": {
            "type": "integer"
          },
          "mime_type": {
            "type": "string"
          },
          "upload_id": {
            "type": "string",
            "format": "uuid"
          }
        },
        "description": "Reference to a file uploaded via the Reactor upload protocol."
      }
    }
  }
}

Validate a payload

before you spend tokens
shell
$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"reactor","endpointId":"reactor/helios","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}