GET

/v1/schemas/fal/video/minimax/h3-max/director?kind=output

kind outputactivity videohash bb068ce9…extracted Sep 19, 2026version currentsource upstream spec ↗
fieldrecorded source
schemaSource linked above.

upstream-spec

Source trace
dc5a7898a2d7839826a6e193f04930402a4cf2801d688b4fa7ab7f9d10436103
{
  "fetchedAt": 1789794055,
  "extractorVersion": "1",
  "verifiedAt": null
}

Response body

0 properties · 0 required · 0 $defs

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

application/json
{
  "provider": "fal",
  "activity": "video",
  "endpointId": "minimax/h3-max/director",
  "kind": "output",
  "contentHash": "bb068ce938def6986495bebe52e5eadb6ddb39abf03d77ee8cb2d6f0faaab042",
  "specRevision": null,
  "provenance": {
    "sourceUrl": "https://fal.ai/api/apps/fal-ai/minimax-h3-max-director/asyncapi.json",
    "sourceHash": "dc5a7898a2d7839826a6e193f04930402a4cf2801d688b4fa7ab7f9d10436103",
    "fetchedAt": 1789794055,
    "extractorVersion": "1",
    "derivation": "upstream-spec",
    "verifiedAt": null
  },
  "createdAt": 1789794055,
  "supersededAt": null,
  "schema": {
    "title": "Server messages",
    "oneOf": [
      {
        "$ref": "#/$defs/MiniMaxH3MaxDirectorServerAudioAppliedMessage"
      },
      {
        "$ref": "#/$defs/MiniMaxH3MaxDirectorServerAudioExhaustedMessage"
      },
      {
        "$ref": "#/$defs/MiniMaxH3MaxDirectorServerAudioPendingMessage"
      },
      {
        "$ref": "#/$defs/MiniMaxH3MaxDirectorServerAudioRejectedMessage"
      },
      {
        "$ref": "#/$defs/MiniMaxH3MaxDirectorServerChunkMessage"
      },
      {
        "$ref": "#/$defs/MiniMaxH3MaxDirectorServerChunkMetricsMessage"
      },
      {
        "$ref": "#/$defs/MiniMaxH3MaxDirectorServerConfiguredMessage"
      },
      {
        "$ref": "#/$defs/MiniMaxH3MaxDirectorServerDeadlineMissedMessage"
      },
      {
        "$ref": "#/$defs/MiniMaxH3MaxDirectorServerErrorMessage"
      },
      {
        "$ref": "#/$defs/MiniMaxH3MaxDirectorServerPongMessage"
      },
      {
        "$ref": "#/$defs/MiniMaxH3MaxDirectorServerPromptAppliedMessage"
      },
      {
        "$ref": "#/$defs/MiniMaxH3MaxDirectorServerPromptPendingMessage"
      },
      {
        "$ref": "#/$defs/MiniMaxH3MaxDirectorServerPromptRejectedMessage"
      },
      {
        "$ref": "#/$defs/MiniMaxH3MaxDirectorServerSessionInfoMessage"
      },
      {
        "$ref": "#/$defs/MiniMaxH3MaxDirectorServerSessionMetricsMessage"
      },
      {
        "$ref": "#/$defs/MiniMaxH3MaxDirectorServerStreamExhaustedMessage"
      }
    ],
    "$defs": {
      "MiniMaxH3MaxDirectorServerAudioAppliedMessage": {
        "required": [
          "type",
          "prompt_version",
          "behavior",
          "source",
          "duration_seconds",
          "transcribed",
          "queued_sources",
          "remaining_seconds"
        ],
        "type": "object",
        "title": "AudioAppliedMessage",
        "properties": {
          "behavior": {
            "enum": [
              "replace",
              "queue"
            ],
            "type": "string",
            "title": "Behavior"
          },
          "type": {
            "const": "audio_applied",
            "type": "string",
            "title": "Type",
            "default": "audio_applied"
          },
          "prompt_version": {
            "type": "integer",
            "title": "Prompt Version",
            "minimum": 1
          },
          "remaining_seconds": {
            "type": "number",
            "title": "Remaining Seconds",
            "minimum": 0
          },
          "queued_sources": {
            "type": "integer",
            "title": "Queued Sources",
            "minimum": 0
          },
          "duration_seconds": {
            "type": "number",
            "title": "Duration Seconds",
            "exclusiveMinimum": 0
          },
          "transcribed": {
            "type": "boolean",
            "title": "Transcribed"
          },
          "source": {
            "type": "string",
            "title": "Source"
          }
        },
        "description": "An audio update was accepted; it conditions the next eligible chunk.\n\n``starts_at_chunk_index`` is the first chunk that can carry it (the next\nundispatched chunk for ``replace``; for ``queue`` the chunk where the\npreceding sources end, if already known)."
      },
      "MiniMaxH3MaxDirectorServerAudioExhaustedMessage": {
        "required": [
          "type",
          "chunk_index",
          "silent_seconds"
        ],
        "type": "object",
        "title": "AudioExhaustedMessage",
        "properties": {
          "silent_seconds": {
            "type": "number",
            "title": "Silent Seconds",
            "minimum": 0
          },
          "chunk_index": {
            "type": "integer",
            "title": "Chunk Index",
            "minimum": 0
          },
          "type": {
            "const": "audio_exhausted",
            "type": "string",
            "title": "Type",
            "default": "audio_exhausted"
          },
          "source_version": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Source Version",
            "default": null
          }
        },
        "description": "Accepted audio ran out inside this chunk; the rest is silence.\n\nLater chunks continue without audio conditioning (checkpoint continuation\non the same family) until new audio is accepted."
      },
      "MiniMaxH3MaxDirectorServerAudioPendingMessage": {
        "required": [
          "type",
          "prompt_version",
          "behavior"
        ],
        "type": "object",
        "title": "AudioPendingMessage",
        "properties": {
          "behavior": {
            "enum": [
              "replace",
              "queue"
            ],
            "type": "string",
            "title": "Behavior"
          },
          "type": {
            "const": "audio_pending",
            "type": "string",
            "title": "Type",
            "default": "audio_pending"
          },
          "prompt_version": {
            "type": "integer",
            "title": "Prompt Version",
            "minimum": 1
          }
        }
      },
      "MiniMaxH3MaxDirectorServerAudioRejectedMessage": {
        "required": [
          "type",
          "prompt_version",
          "reason",
          "error"
        ],
        "type": "object",
        "title": "AudioRejectedMessage",
        "properties": {
          "error": {
            "type": "string",
            "title": "Error"
          },
          "type": {
            "const": "audio_rejected",
            "type": "string",
            "title": "Type",
            "default": "audio_rejected"
          },
          "prompt_version": {
            "type": "integer",
            "title": "Prompt Version",
            "minimum": 1
          },
          "reason": {
            "enum": [
              "invalid_audio",
              "content_policy",
              "preparation_failed",
              "queue_full",
              "stale_prompt_version"
            ],
            "type": "string",
            "title": "Reason"
          }
        }
      },
      "MiniMaxH3MaxDirectorServerChunkMessage": {
        "required": [
          "type",
          "chunk_index",
          "prompt_version",
          "generation_seconds",
          "playback_seconds",
          "requested_duration_seconds",
          "generated_frame_count",
          "trimmed_context_frames",
          "next_generation_estimate_seconds",
          "route",
          "buffer_depth_seconds",
          "buffer_depth_chunks",
          "scheduling_lead_ms",
          "scheduling_slack_ms",
          "dispatch"
        ],
        "type": "object",
        "title": "ChunkMessage",
        "properties": {
          "playback_seconds": {
            "type": "number",
            "title": "Playback Seconds",
            "exclusiveMinimum": 0
          },
          "scheduling_lead_ms": {
            "type": "number",
            "title": "Scheduling Lead Ms"
          },
          "script_end_keyframe": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Script End Keyframe",
            "default": null
          },
          "generated_frame_count": {
            "type": "integer",
            "title": "Generated Frame Count",
            "exclusiveMinimum": 0
          },
          "presented_frame_count": {
            "anyOf": [
              {
                "type": "integer",
                "exclusiveMinimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Presented Frame Count",
            "default": null
          },
          "dispatch": {
            "$ref": "#/$defs/MiniMaxH3MaxDirectorServerDispatchAccounting"
          },
          "hard_cut": {
            "type": "boolean",
            "title": "Hard Cut",
            "default": false
          },
          "route": {
            "enum": [
              "gorgonea",
              "betelgeuse",
              "regulus",
              "unknown"
            ],
            "type": "string",
            "title": "Route"
          },
          "generation_seconds": {
            "type": "number",
            "title": "Generation Seconds",
            "minimum": 0
          },
          "requested_duration_seconds": {
            "maximum": 15,
            "title": "Requested Duration Seconds",
            "type": "integer",
            "minimum": 5
          },
          "type": {
            "const": "chunk",
            "type": "string",
            "title": "Type",
            "default": "chunk"
          },
          "trimmed_context_frames": {
            "type": "integer",
            "title": "Trimmed Context Frames",
            "minimum": 0
          },
          "script_offset_seconds": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Script Offset Seconds",
            "default": null
          },
          "buffer_depth_seconds": {
            "type": "number",
            "title": "Buffer Depth Seconds",
            "minimum": 0
          },
          "chunk_index": {
            "type": "integer",
            "title": "Chunk Index",
            "minimum": 0
          },
          "native_playable_frame_count": {
            "anyOf": [
              {
                "type": "integer",
                "exclusiveMinimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Native Playable Frame Count",
            "default": null
          },
          "next_generation_estimate_seconds": {
            "type": "number",
            "title": "Next Generation Estimate Seconds",
            "minimum": 0
          },
          "scheduling_slack_ms": {
            "type": "number",
            "title": "Scheduling Slack Ms"
          },
          "script_version": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 1
              },
              {
                "type": "null"
              }
            ],
            "title": "Script Version",
            "default": null
          },
          "buffer_depth_chunks": {
            "type": "integer",
            "title": "Buffer Depth Chunks",
            "minimum": 0
          },
          "prompt_version": {
            "type": "integer",
            "title": "Prompt Version",
            "minimum": 1
          }
        }
      },
      "MiniMaxH3MaxDirectorServerChunkMetricsMessage": {
        "required": [
          "type",
          "chunk_index",
          "units",
          "route",
          "phases_ms",
          "gauges"
        ],
        "type": "object",
        "title": "ChunkMetricsMessage",
        "properties": {
          "route": {
            "enum": [
              "gorgonea",
              "betelgeuse",
              "regulus",
              "unknown"
            ],
            "type": "string",
            "title": "Route"
          },
          "chunk_consumable_ready_ms": {
            "anyOf": [
              {
                "type": "number",
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Chunk Consumable Ready Ms",
            "default": null
          },
          "type": {
            "const": "chunk_metrics",
            "type": "string",
            "title": "Type",
            "default": "chunk_metrics"
          },
          "chunk_index": {
            "type": "integer",
            "title": "Chunk Index",
            "minimum": 0
          },
          "chunk_consumable_interval_ms": {
            "anyOf": [
              {
                "type": "number",
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Chunk Consumable Interval Ms",
            "default": null
          },
          "gauges": {
            "additionalProperties": {
              "type": "number"
            },
            "type": "object",
            "title": "Gauges"
          },
          "units": {
            "const": "ms",
            "type": "string",
            "title": "Units"
          },
          "phases_ms": {
            "additionalProperties": {
              "type": "number"
            },
            "type": "object",
            "title": "Phases Ms"
          }
        }
      },
      "MiniMaxH3MaxDirectorServerConfiguredMessage": {
        "required": [
          "type",
          "prompt_version",
          "enable_safety_checker"
        ],
        "type": "object",
        "title": "ConfiguredMessage",
        "properties": {
          "resolution": {
            "anyOf": [
              {
                "enum": [
                  "480p",
                  "544p",
                  "640p",
                  "704p",
                  "768p"
                ],
                "type": "string"
              },
              {
                "enum": [
                  "480p",
                  "768p",
                  "1080p"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Resolution",
            "default": null
          },
          "has_initial_image": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Has Initial Image",
            "default": null
          },
          "has_initial_audio": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Has Initial Audio",
            "default": null
          },
          "enable_safety_checker": {
            "type": "boolean",
            "title": "Enable Safety Checker"
          },
          "type": {
            "const": "configured",
            "type": "string",
            "title": "Type",
            "default": "configured"
          },
          "prompt_version": {
            "type": "integer",
            "title": "Prompt Version",
            "minimum": 1
          },
          "chunk_duration": {
            "anyOf": [
              {
                "maximum": 15,
                "type": "integer",
                "minimum": 5
              },
              {
                "type": "null"
              }
            ],
            "title": "Chunk Duration",
            "default": null
          },
          "audio_bitrate": {
            "anyOf": [
              {
                "enum": [
                  96000,
                  128000,
                  192000
                ],
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Audio Bitrate",
            "default": null
          },
          "memory": {
            "anyOf": [
              {
                "maximum": 50,
                "type": "integer",
                "minimum": 1
              },
              {
                "type": "null"
              }
            ],
            "title": "Memory",
            "default": null
          },
          "acceleration": {
            "anyOf": [
              {
                "enum": [
                  "none",
                  "regular"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Acceleration",
            "default": null
          },
          "aspect_ratio": {
            "anyOf": [
              {
                "enum": [
                  "16:9",
                  "9:16",
                  "1:1"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Aspect Ratio",
            "default": null
          }
        }
      },
      "MiniMaxH3MaxDirectorServerDeadlineMissedMessage": {
        "required": [
          "type",
          "chunk_index",
          "late_by_seconds",
          "behavior"
        ],
        "type": "object",
        "title": "DeadlineMissedMessage",
        "properties": {
          "behavior": {
            "const": "freeze_video_and_silence_audio_until_ready",
            "type": "string",
            "title": "Behavior"
          },
          "late_by_seconds": {
            "type": "number",
            "title": "Late By Seconds",
            "minimum": 0
          },
          "type": {
            "const": "deadline_missed",
            "type": "string",
            "title": "Type",
            "default": "deadline_missed"
          },
          "chunk_index": {
            "type": "integer",
            "title": "Chunk Index",
            "minimum": 0
          }
        }
      },
      "MiniMaxH3MaxDirectorServerDispatchAccounting": {
        "required": [
          "wall_ms",
          "classified_ms",
          "overhead_ms",
          "phases_ms"
        ],
        "type": "object",
        "title": "DispatchAccounting",
        "properties": {
          "overhead_ms": {
            "type": "number",
            "title": "Overhead Ms",
            "minimum": 0
          },
          "classified_ms": {
            "type": "number",
            "title": "Classified Ms",
            "minimum": 0
          },
          "phases_ms": {
            "additionalProperties": {
              "type": "number"
            },
            "type": "object",
            "title": "Phases Ms"
          },
          "wall_ms": {
            "type": "number",
            "title": "Wall Ms",
            "minimum": 0
          }
        }
      },
      "MiniMaxH3MaxDirectorServerErrorMessage": {
        "required": [
          "type",
          "code",
          "error"
        ],
        "type": "object",
        "title": "ErrorMessage",
        "properties": {
          "detail": {
            "anyOf": [
              {
                "items": {
                  "type": "object"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Detail",
            "default": null
          },
          "error": {
            "type": "string",
            "title": "Error"
          },
          "code": {
            "enum": [
              "balance_unavailable",
              "content_policy",
              "configuration_timeout",
              "generation_failed",
              "generation_timeout",
              "immutable_settings",
              "initialization_timeout",
              "invalid_initial_image",
              "invalid_initial_audio",
              "invalid_initial_script",
              "invalid_input",
              "invalid_message",
              "not_configured",
              "stale_prompt_version"
            ],
            "type": "string",
            "title": "Code"
          },
          "type": {
            "const": "error",
            "type": "string",
            "title": "Type",
            "default": "error"
          },
          "prompt_version": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 1
              },
              {
                "type": "null"
              }
            ],
            "title": "Prompt Version",
            "default": null
          }
        }
      },
      "MiniMaxH3MaxDirectorServerPongMessage": {
        "required": [
          "type",
          "client_ts"
        ],
        "type": "object",
        "title": "PongMessage",
        "properties": {
          "type": {
            "const": "pong",
            "type": "string",
            "title": "Type",
            "default": "pong"
          },
          "client_ts": {
            "type": "number",
            "title": "Client Ts"
          }
        }
      },
      "MiniMaxH3MaxDirectorServerPromptAppliedMessage": {
        "required": [
          "type",
          "prompt_version"
        ],
        "type": "object",
        "title": "PromptAppliedMessage",
        "properties": {
          "script_mode": {
            "anyOf": [
              {
                "enum": [
                  "replace",
                  "append"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Script Mode",
            "default": null
          },
          "script_origin_chunk_index": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Script Origin Chunk Index",
            "default": null
          },
          "script_beats": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 1
              },
              {
                "type": "null"
              }
            ],
            "title": "Script Beats",
            "default": null
          },
          "type": {
            "const": "prompt_applied",
            "type": "string",
            "title": "Type",
            "default": "prompt_applied"
          },
          "prompt_version": {
            "type": "integer",
            "title": "Prompt Version",
            "minimum": 1
          },
          "script_queued": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Script Queued",
            "default": null
          }
        },
        "description": "A direction (or script) is admitted; the script fields report scripts.\n\n``script_origin_chunk_index`` is the first chunk generated under the\nscript when that is already fixed (a replacement binds to the next\nundispatched chunk); an appended script reports ``None`` until it starts."
      },
      "MiniMaxH3MaxDirectorServerPromptPendingMessage": {
        "required": [
          "type",
          "prompt_version"
        ],
        "type": "object",
        "title": "PromptPendingMessage",
        "properties": {
          "type": {
            "const": "prompt_pending",
            "type": "string",
            "title": "Type",
            "default": "prompt_pending"
          },
          "prompt_version": {
            "type": "integer",
            "title": "Prompt Version",
            "minimum": 1
          }
        }
      },
      "MiniMaxH3MaxDirectorServerPromptRejectedMessage": {
        "required": [
          "type",
          "prompt_version",
          "reason"
        ],
        "type": "object",
        "title": "PromptRejectedMessage",
        "properties": {
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error",
            "default": null
          },
          "type": {
            "const": "prompt_rejected",
            "type": "string",
            "title": "Type",
            "default": "prompt_rejected"
          },
          "prompt_version": {
            "type": "integer",
            "title": "Prompt Version",
            "minimum": 1
          },
          "reason": {
            "enum": [
              "content_policy",
              "preparation_failed",
              "stale_prompt_version",
              "invalid_script",
              "infeasible_timing",
              "invalid_audio",
              "invalid_image",
              "queue_full"
            ],
            "type": "string",
            "title": "Reason"
          }
        }
      },
      "MiniMaxH3MaxDirectorServerSessionInfoMessage": {
        "required": [
          "type"
        ],
        "type": "object",
        "title": "SessionInfoMessage",
        "properties": {
          "default_audio_bitrate": {
            "anyOf": [
              {
                "enum": [
                  96000,
                  128000,
                  192000
                ],
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Default Audio Bitrate",
            "default": null
          },
          "script_min_end_image_spacing_seconds": {
            "const": 3,
            "type": "integer",
            "title": "Script Min End Image Spacing Seconds",
            "default": 3
          },
          "audio_bitrates": {
            "items": {
              "enum": [
                96000,
                128000,
                192000
              ],
              "type": "integer"
            },
            "type": "array",
            "title": "Audio Bitrates",
            "default": [
              96000,
              128000,
              192000
            ]
          },
          "script_session_max_decoded_audio_bytes": {
            "type": "integer",
            "title": "Script Session Max Decoded Audio Bytes",
            "default": 335544320
          },
          "protocol_version": {
            "const": 1,
            "type": "integer",
            "title": "Protocol Version",
            "default": 1
          },
          "accelerations": {
            "items": {
              "enum": [
                "none",
                "regular"
              ],
              "type": "string"
            },
            "type": "array",
            "title": "Accelerations",
            "default": [
              "none",
              "regular"
            ]
          },
          "script_max_audio_beats": {
            "const": 8,
            "type": "integer",
            "title": "Script Max Audio Beats",
            "default": 8
          },
          "max_session_seconds": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Max Session Seconds",
            "default": null
          },
          "fps": {
            "const": 24,
            "type": "integer",
            "title": "Fps",
            "default": 24
          },
          "min_memory": {
            "const": 1,
            "type": "integer",
            "title": "Min Memory",
            "default": 1
          },
          "continuation_context_frames": {
            "const": 39,
            "type": "integer",
            "title": "Continuation Context Frames",
            "default": 39
          },
          "app": {
            "const": "minimax-h3-max-director",
            "type": "string",
            "title": "App",
            "default": "minimax-h3-max-director"
          },
          "min_chunk_duration": {
            "const": 5,
            "type": "integer",
            "title": "Min Chunk Duration",
            "default": 5
          },
          "script_max_decoded_audio_bytes": {
            "type": "integer",
            "title": "Script Max Decoded Audio Bytes",
            "default": 67108864
          },
          "controller_machine_type": {
            "const": "XL",
            "type": "string",
            "title": "Controller Machine Type",
            "default": "XL"
          },
          "audio_conditioning": {
            "const": true,
            "type": "boolean",
            "title": "Audio Conditioning",
            "default": true
          },
          "resolutions": {
            "items": {
              "enum": [
                "480p",
                "768p",
                "1080p"
              ],
              "type": "string"
            },
            "type": "array",
            "title": "Resolutions",
            "default": [
              "480p",
              "768p",
              "1080p"
            ]
          },
          "chunk_seconds": {
            "const": 10,
            "type": "integer",
            "title": "Chunk Seconds",
            "default": 10
          },
          "script_min_opening_chunk_seconds": {
            "const": 5,
            "type": "integer",
            "title": "Script Min Opening Chunk Seconds",
            "default": 5
          },
          "scripts": {
            "const": true,
            "type": "boolean",
            "title": "Scripts",
            "default": true
          },
          "audio_sample_rate": {
            "const": 48000,
            "type": "integer",
            "title": "Audio Sample Rate",
            "default": 48000
          },
          "script_modes": {
            "items": {
              "enum": [
                "replace",
                "append"
              ],
              "type": "string"
            },
            "type": "array",
            "title": "Script Modes",
            "default": [
              "replace",
              "append"
            ]
          },
          "default_chunk_duration": {
            "const": 10,
            "type": "integer",
            "title": "Default Chunk Duration",
            "default": 10
          },
          "script_min_chunk_seconds": {
            "const": 3,
            "type": "integer",
            "title": "Script Min Chunk Seconds",
            "default": 3
          },
          "default_acceleration": {
            "const": "regular",
            "type": "string",
            "title": "Default Acceleration",
            "default": "regular"
          },
          "one_session_per_machine": {
            "const": true,
            "type": "boolean",
            "title": "One Session Per Machine",
            "default": true
          },
          "backend_selection": {
            "const": "minimax-h3-turbo-balancer",
            "type": "string",
            "title": "Backend Selection",
            "default": "minimax-h3-turbo-balancer"
          },
          "session_limit_scope": {
            "enum": [
              "configured",
              "effective"
            ],
            "type": "string",
            "title": "Session Limit Scope",
            "default": "configured"
          },
          "prompt_deck_size": {
            "const": 6,
            "type": "integer",
            "title": "Prompt Deck Size",
            "default": 6
          },
          "script_max_end_images": {
            "const": 16,
            "type": "integer",
            "title": "Script Max End Images",
            "default": 16
          },
          "audio_behaviors": {
            "items": {
              "enum": [
                "replace",
                "queue"
              ],
              "type": "string"
            },
            "type": "array",
            "title": "Audio Behaviors",
            "default": [
              "replace",
              "queue"
            ]
          },
          "max_memory": {
            "const": 50,
            "type": "integer",
            "title": "Max Memory",
            "default": 50
          },
          "max_audio_source_seconds": {
            "type": "number",
            "title": "Max Audio Source Seconds",
            "default": 600
          },
          "prompt_context_segments": {
            "const": 12,
            "type": "integer",
            "title": "Prompt Context Segments",
            "default": 12
          },
          "server_message_types": {
            "items": {
              "enum": [
                "audio_applied",
                "audio_exhausted",
                "audio_pending",
                "audio_rejected",
                "chunk",
                "chunk_metrics",
                "configured",
                "deadline_missed",
                "error",
                "pong",
                "prompt_applied",
                "prompt_pending",
                "prompt_rejected",
                "session_info",
                "session_metrics",
                "stream_exhausted"
              ],
              "type": "string"
            },
            "type": "array",
            "title": "Server Message Types",
            "default": [
              "audio_applied",
              "audio_exhausted",
              "audio_pending",
              "audio_rejected",
              "chunk",
              "chunk_metrics",
              "configured",
              "deadline_missed",
              "error",
              "pong",
              "prompt_applied",
              "prompt_pending",
              "prompt_rejected",
              "session_info",
              "session_metrics",
              "stream_exhausted"
            ]
          },
          "prompt_expander": {
            "const": "fast",
            "type": "string",
            "title": "Prompt Expander",
            "default": "fast"
          },
          "script_max_pending": {
            "const": 4,
            "type": "integer",
            "title": "Script Max Pending",
            "default": 4
          },
          "client_message_types": {
            "items": {
              "enum": [
                "configure",
                "ping",
                "prompt",
                "stop"
              ],
              "type": "string"
            },
            "type": "array",
            "title": "Client Message Types",
            "default": [
              "configure",
              "ping",
              "prompt",
              "stop"
            ]
          },
          "conditioning_audio_sample_rate": {
            "const": 32000,
            "type": "integer",
            "title": "Conditioning Audio Sample Rate",
            "default": 32000
          },
          "type": {
            "const": "session_info",
            "type": "string",
            "title": "Type",
            "default": "session_info"
          },
          "default_memory": {
            "const": 12,
            "type": "integer",
            "title": "Default Memory",
            "default": 12
          },
          "script_max_queued": {
            "const": 4,
            "type": "integer",
            "title": "Script Max Queued",
            "default": 4
          },
          "aspect_ratios": {
            "items": {
              "enum": [
                "16:9",
                "9:16",
                "1:1"
              ],
              "type": "string"
            },
            "type": "array",
            "title": "Aspect Ratios",
            "default": [
              "16:9",
              "9:16",
              "1:1"
            ]
          },
          "continuation_playback_seconds": {
            "type": "number",
            "title": "Continuation Playback Seconds",
            "default": 8.5
          },
          "opening_reserved": {
            "type": "boolean",
            "title": "Opening Reserved",
            "default": false
          },
          "max_chunk_duration": {
            "const": 15,
            "type": "integer",
            "title": "Max Chunk Duration",
            "default": 15
          },
          "script_max_beats": {
            "const": 64,
            "type": "integer",
            "title": "Script Max Beats",
            "default": 64
          }
        }
      },
      "MiniMaxH3MaxDirectorServerSessionMetricSummary": {
        "required": [
          "count",
          "total_ms",
          "p50_ms",
          "p95_ms",
          "max_ms"
        ],
        "type": "object",
        "title": "SessionMetricSummary",
        "properties": {
          "max_ms": {
            "type": "number",
            "title": "Max Ms",
            "minimum": 0
          },
          "total_ms": {
            "type": "number",
            "title": "Total Ms",
            "minimum": 0
          },
          "count": {
            "type": "integer",
            "title": "Count",
            "minimum": 0
          },
          "p95_ms": {
            "type": "number",
            "title": "P95 Ms",
            "minimum": 0
          },
          "p50_ms": {
            "type": "number",
            "title": "P50 Ms",
            "minimum": 0
          }
        }
      },
      "MiniMaxH3MaxDirectorServerSessionMetricsMessage": {
        "required": [
          "type",
          "units",
          "session_wall_ms",
          "history_size",
          "history_limit",
          "phases",
          "gauges"
        ],
        "type": "object",
        "title": "SessionMetricsMessage",
        "properties": {
          "phases": {
            "additionalProperties": {
              "$ref": "#/$defs/MiniMaxH3MaxDirectorServerSessionMetricSummary"
            },
            "type": "object",
            "title": "Phases"
          },
          "session_wall_ms": {
            "type": "number",
            "title": "Session Wall Ms",
            "minimum": 0
          },
          "type": {
            "const": "session_metrics",
            "type": "string",
            "title": "Type",
            "default": "session_metrics"
          },
          "history_limit": {
            "type": "integer",
            "title": "History Limit",
            "minimum": 1
          },
          "final": {
            "type": "boolean",
            "title": "Final",
            "default": false
          },
          "gauges": {
            "additionalProperties": {
              "type": "number"
            },
            "type": "object",
            "title": "Gauges"
          },
          "units": {
            "const": "ms",
            "type": "string",
            "title": "Units"
          },
          "history_size": {
            "type": "integer",
            "title": "History Size",
            "minimum": 0
          }
        }
      },
      "MiniMaxH3MaxDirectorServerStreamExhaustedMessage": {
        "required": [
          "type",
          "chunks",
          "reason"
        ],
        "type": "object",
        "title": "StreamExhaustedMessage",
        "properties": {
          "chunks": {
            "type": "integer",
            "title": "Chunks",
            "minimum": 0
          },
          "type": {
            "const": "stream_exhausted",
            "type": "string",
            "title": "Type",
            "default": "stream_exhausted"
          },
          "reason": {
            "enum": [
              "stopped",
              "session_limit"
            ],
            "type": "string",
            "title": "Reason"
          }
        }
      }
    }
  }
}

Validate a payload

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