GET

/v1/schemas/reactor/video/reactor%2Fhappy-oyster-director

kind inputactivity videohash 45e2c2b9…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/happy-oyster-director",
  "kind": "input",
  "contentHash": "45e2c2b9a88eb525d93b0060ff352fc845fc70c0674247acfe9ab4f696794dee",
  "specRevision": null,
  "provenance": {
    "sourceUrl": "https://reactor.inc/models/happy-oyster/api#reactor/happy-oyster-director",
    "sourceHash": "ca19af795fd68f3d5473f43b71872773311554b57558bb881d67914d771c0bc4",
    "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": "create_world"
          },
          "data": {
            "type": "object",
            "required": [
              "prompt"
            ],
            "properties": {
              "prompt": {
                "type": "string",
                "description": "Natural-language description of the world to create.",
                "maxLength": 2000
              },
              "first_frame_image_url": {
                "type": "string",
                "description": "Publicly reachable image URL to use as the world's opening frame. Must be landscape with a width/height ratio between 1.5 and 2.0.",
                "default": ""
              },
              "perspective": {
                "type": "string",
                "description": "Adventure worlds only. Camera perspective.",
                "enum": [
                  "first_person",
                  "third_person"
                ],
                "default": "third_person"
              },
              "resolution": {
                "type": "string",
                "description": "Directing worlds only. Video resolution.",
                "enum": [
                  "480p",
                  "720p"
                ],
                "default": "720p"
              },
              "layout": {
                "type": "string",
                "description": "Directing worlds only. Camera movement style.",
                "enum": [
                  "Stable",
                  "Fast"
                ],
                "default": "Stable"
              },
              "narrative": {
                "type": "string",
                "description": "Directing worlds only. Narrative style.",
                "enum": [
                  "Calm",
                  "Dramatic",
                  "Normal"
                ],
                "default": "Normal"
              }
            }
          }
        }
      },
      {
        "type": "object",
        "required": [
          "command",
          "data"
        ],
        "additionalProperties": false,
        "properties": {
          "command": {
            "type": "string",
            "const": "attach_world"
          },
          "data": {
            "type": "object",
            "required": [
              "encrypted_world_id"
            ],
            "properties": {
              "encrypted_world_id": {
                "type": "string",
                "description": "The id saved from an earlier `create_world`."
              }
            }
          }
        }
      },
      {
        "type": "object",
        "required": [
          "command",
          "data"
        ],
        "additionalProperties": false,
        "properties": {
          "command": {
            "type": "string",
            "const": "start_travel"
          },
          "data": {
            "type": "object",
            "properties": {}
          }
        }
      },
      {
        "type": "object",
        "required": [
          "command",
          "data"
        ],
        "additionalProperties": false,
        "properties": {
          "command": {
            "type": "string",
            "const": "disconnect"
          },
          "data": {
            "type": "object",
            "properties": {}
          }
        }
      },
      {
        "type": "object",
        "required": [
          "command",
          "data"
        ],
        "additionalProperties": false,
        "properties": {
          "command": {
            "type": "string",
            "const": "move"
          },
          "data": {
            "type": "object",
            "required": [
              "direction"
            ],
            "properties": {
              "direction": {
                "type": "string",
                "description": "The direction to move in.",
                "enum": [
                  "Front",
                  "Back",
                  "Left",
                  "Right",
                  "Front_Left",
                  "Front_Right",
                  "Back_Left",
                  "Back_Right"
                ]
              }
            }
          }
        }
      },
      {
        "type": "object",
        "required": [
          "command",
          "data"
        ],
        "additionalProperties": false,
        "properties": {
          "command": {
            "type": "string",
            "const": "look"
          },
          "data": {
            "type": "object",
            "required": [
              "direction"
            ],
            "properties": {
              "direction": {
                "type": "string",
                "description": "The direction to turn the view.",
                "enum": [
                  "Mouse_Up",
                  "Mouse_Down",
                  "Mouse_Left",
                  "Mouse_Right",
                  "Mouse_Up_Left",
                  "Mouse_Up_Right",
                  "Mouse_Down_Left",
                  "Mouse_Down_Right"
                ]
              }
            }
          }
        }
      },
      {
        "type": "object",
        "required": [
          "command",
          "data"
        ],
        "additionalProperties": false,
        "properties": {
          "command": {
            "type": "string",
            "const": "interact"
          },
          "data": {
            "type": "object",
            "required": [
              "action"
            ],
            "properties": {
              "action": {
                "type": "string",
                "description": "The interaction to perform (e.g. \"Jump\")."
              }
            }
          }
        }
      },
      {
        "type": "object",
        "required": [
          "command",
          "data"
        ],
        "additionalProperties": false,
        "properties": {
          "command": {
            "type": "string",
            "const": "stop"
          },
          "data": {
            "type": "object",
            "properties": {}
          }
        }
      },
      {
        "type": "object",
        "required": [
          "command",
          "data"
        ],
        "additionalProperties": false,
        "properties": {
          "command": {
            "type": "string",
            "const": "instruct"
          },
          "data": {
            "type": "object",
            "required": [
              "content"
            ],
            "properties": {
              "content": {
                "type": "string",
                "description": "The instruction to apply to the story."
              }
            }
          }
        }
      },
      {
        "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": "resume"
          },
          "data": {
            "type": "object",
            "properties": {}
          }
        }
      },
      {
        "type": "object",
        "required": [
          "command",
          "data"
        ],
        "additionalProperties": false,
        "properties": {
          "command": {
            "type": "string",
            "const": "rewind"
          },
          "data": {
            "type": "object",
            "required": [
              "rewind_to_sec"
            ],
            "properties": {
              "rewind_to_sec": {
                "type": "number",
                "description": "The point to rewind to, in seconds.",
                "minimum": 0
              }
            }
          }
        }
      }
    ]
  }
}

Validate a payload

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