GET
/v1/schemas/reactor/video/reactor%2Ffast-h3
Accept:
Request body
0 properties · 0 required · 0 $defsThis schema isn’t a plain object with properties — showing the raw JSON instead.
application/json
{
"provider": "reactor",
"activity": "video",
"endpointId": "reactor/fast-h3",
"kind": "input",
"contentHash": "11227530b606b782361a363aba6a11bb0d08f0d39d67d992b783338b1e6de038",
"specRevision": null,
"provenance": {
"sourceUrl": "https://reactor.inc/models/fast-h3/api#reactor/fast-h3",
"sourceHash": "ac62cd12e7398a2eeef60aa7e361dc6754abf3f441119a83bd87a269b419a70f",
"fetchedAt": 1789621887,
"extractorVersion": "1",
"derivation": "upstream-spec",
"verifiedAt": null
},
"createdAt": 1789621887,
"supersededAt": null,
"schema": {
"oneOf": [
{
"type": "object",
"required": [
"command",
"data"
],
"additionalProperties": false,
"properties": {
"command": {
"type": "string",
"const": "pop"
},
"data": {
"type": "object",
"properties": {
"clip_id": {
"type": "string",
"default": "",
"description": "UUID of the queued clip to remove, from `clip_queued` or `queue_update`.",
"x-reactor-moderate": false
}
}
}
}
},
{
"type": "object",
"required": [
"command",
"data"
],
"additionalProperties": false,
"properties": {
"command": {
"type": "string",
"const": "move"
},
"data": {
"type": "object",
"properties": {
"clip_id": {
"type": "string",
"default": "",
"description": "UUID of the queued clip to move, from any clip-referencing message.",
"x-reactor-moderate": false
},
"position": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Target position in the clip's queue, 0 = front; clamped to the end.",
"x-reactor-moderate": false
}
}
}
}
},
{
"type": "object",
"required": [
"command",
"data"
],
"additionalProperties": false,
"properties": {
"command": {
"type": "string",
"const": "play"
},
"data": {
"type": "object",
"properties": {
"clip_id": {
"type": "string",
"default": "",
"description": "UUID of the clip to play, from `clip_generated` or `queue_update`. Blank plays the playout queue's front clip.",
"x-reactor-moderate": false
}
}
}
}
},
{
"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": "reset"
},
"data": {
"type": "object",
"properties": {}
}
}
},
{
"type": "object",
"required": [
"command",
"data"
],
"additionalProperties": false,
"properties": {
"command": {
"type": "string",
"const": "enqueue"
},
"data": {
"type": "object",
"properties": {
"seed": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"minimum": 0,
"description": "Seed for this clip. Omitted or null, the session's default is used and advances by one; passing a seed leaves the default untouched, so explicit and automatic seeding do not interfere.",
"x-reactor-moderate": false
},
"prompt": {
"type": "string",
"default": "",
"description": "What the clip should show, up to 1024 tokens as the model's own tokenizer counts them. Past that budget the `enqueue` is refused and says how far over it is; nothing is silently trimmed. Fixed once enqueued; a different scene is a new `enqueue`.",
"x-reactor-moderate": true
},
"seconds": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"maximum": 14.375,
"minimum": 5.167,
"description": "Length of this clip in seconds, between 5.167 and 14.375, snapped to the nearest length the model can produce; the clip's structure reports the effective value. Omitted or null, the session default applies. A length the deployment has not built before pays a one-off compile cost on its first build.",
"x-reactor-moderate": false
},
"metadata": {
"type": "string",
"default": "",
"maxLength": 2000,
"description": "Free-form string stored with the clip and echoed back on every message that references it. The model never reads it; use it to correlate clips with your own records — who asked for it, which group it belongs to, display text.",
"x-reactor-moderate": true
},
"position": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"minimum": 0,
"description": "Where the clip enters the generation queue: 0 is the front (the next build), larger values count back from there, and anything past the end — or omitted — appends. The clip already building is unaffected either way. `queue_update` reports the resulting order.",
"x-reactor-moderate": false
},
"ending_frame": {
"anyOf": [
{
"$ref": "#/$defs/ReactorUploadReference"
},
{
"type": "null"
}
],
"default": null,
"description": "A still image the clip animates into and closes on — its last frame. Common formats decode; the frame is fitted to the session canvas. Combine it with a `starting_frame` (or a `continue_from_clip_id` opener) for first-and-last generation, or send it alone to fix only the ending. Omit for a clip with no fixed end or one ending on a retained generated frame. At most one of this and `ending_from_clip_id`; independent of how the clip opens, so it pairs with either opener.",
"x-reactor-moderate": true
},
"starting_frame": {
"anyOf": [
{
"$ref": "#/$defs/ReactorUploadReference"
},
{
"type": "null"
}
],
"default": null,
"description": "A still image the clip opens from and animates forward — image-to-video. Common formats decode; the frame is fitted to the session canvas. To continue from a video, extract the frame you want and send it here. Omit for a clip opening from text or from another clip; at most one of this and `continue_from_clip_id`.",
"x-reactor-moderate": true
},
"ending_from_clip_id": {
"type": "string",
"default": "",
"description": "UUID of the clip whose clean retained last frame this clip animates into and closes on. Any clip in either queue or in `queue_update.history` qualifies, including one that has not built yet: this clip then waits for it. Blank for no generated ending target; at most one of this and `ending_frame`. This is independent of the opener, so it may equal `continue_from_clip_id` to create a hold that starts and ends on the same generated frame.",
"x-reactor-moderate": false
},
"continue_from_clip_id": {
"type": "string",
"default": "",
"description": "UUID of the clip whose last frame this one opens from and animates forward — how clips chain into a continuing scene. Any clip in either queue or in `queue_update.history` qualifies, including one that has not built yet: this clip then waits for it. Blank for a clip opening from text or from an uploaded frame; at most one of this and `starting_frame`.",
"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": 1000,
"minimum": 0,
"description": "Default seed for enqueues that carry none. Reproduction is close rather than exact: the deployment runs fused kernels that can reorder arithmetic.",
"x-reactor-moderate": false
}
}
}
}
},
{
"type": "object",
"required": [
"command",
"data"
],
"additionalProperties": false,
"properties": {
"command": {
"type": "string",
"const": "get_queue"
},
"data": {
"type": "object",
"properties": {}
}
}
},
{
"type": "object",
"required": [
"command",
"data"
],
"additionalProperties": false,
"properties": {
"command": {
"type": "string",
"const": "get_state"
},
"data": {
"type": "object",
"properties": {}
}
}
},
{
"type": "object",
"required": [
"command",
"data"
],
"additionalProperties": false,
"properties": {
"command": {
"type": "string",
"const": "set_canvas"
},
"data": {
"type": "object",
"properties": {
"aspect": {
"enum": [
"16:9",
"1:1",
"9:16",
"4:3"
],
"type": "string",
"default": "16:9",
"description": "Aspect ratio of `main_video`. `canvas_accepted` and `state_update` report the width and height in pixels it resolves to.",
"x-reactor-moderate": false
}
}
}
}
},
{
"type": "object",
"required": [
"command",
"data"
],
"additionalProperties": false,
"properties": {
"command": {
"type": "string",
"const": "set_autoplay"
},
"data": {
"type": "object",
"properties": {
"enabled": {
"type": "boolean",
"default": false,
"description": "True plays the playout queue front-first on its own; false holds the stream after each clip until `play`.",
"x-reactor-moderate": false
}
}
}
}
},
{
"type": "object",
"required": [
"command",
"data"
],
"additionalProperties": false,
"properties": {
"command": {
"type": "string",
"const": "set_clip_seconds"
},
"data": {
"type": "object",
"properties": {
"seconds": {
"type": "number",
"default": 14.375,
"maximum": 14.375,
"minimum": 5.167,
"description": "Clip length in seconds, between 5.167 and 14.375. Snapped to the nearest length the model can produce, so the value that takes effect can differ slightly; `state_update.clip_seconds` always carries the one in force.",
"x-reactor-moderate": false
}
}
}
}
},
{
"type": "object",
"required": [
"command",
"data"
],
"additionalProperties": false,
"properties": {
"command": {
"type": "string",
"const": "set_flush_on_clip_end"
},
"data": {
"type": "object",
"properties": {
"enabled": {
"type": "boolean",
"default": true,
"description": "True cuts to black at every non-continuing clip boundary; false holds the last frame there instead.",
"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 tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"reactor","endpointId":"reactor/fast-h3","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}