{"x-fal-openapi":{"url":"./openapi.json","operationId":"start_session_start_session_post"},"channels":{"control":{"address":"fal","messages":{"server.configured":{"$ref":"#/components/messages/server.configured"},"server.session_info":{"$ref":"#/components/messages/server.session_info"},"client.ping":{"$ref":"#/components/messages/client.ping"},"server.stream_exhausted":{"$ref":"#/components/messages/server.stream_exhausted"},"server.prompt_rejected":{"$ref":"#/components/messages/server.prompt_rejected"},"server.pong":{"$ref":"#/components/messages/server.pong"},"client.stop":{"$ref":"#/components/messages/client.stop"},"server.chunk_metrics":{"$ref":"#/components/messages/server.chunk_metrics"},"server.prompt_pending":{"$ref":"#/components/messages/server.prompt_pending"},"server.error":{"$ref":"#/components/messages/server.error"},"server.deadline_missed":{"$ref":"#/components/messages/server.deadline_missed"},"server.chunk":{"$ref":"#/components/messages/server.chunk"},"server.session_metrics":{"$ref":"#/components/messages/server.session_metrics"},"server.prompt_applied":{"$ref":"#/components/messages/server.prompt_applied"},"client.configure":{"$ref":"#/components/messages/client.configure"},"client.prompt":{"$ref":"#/components/messages/client.prompt"}},"servers":[{"$ref":"#/servers/session"}]}},"defaultContentType":"application/json","info":{"title":"MiniMaxH3MaxDirector realtime client API","description":"Client contract for the WebRTC session created by the linked OpenAPI operation.","version":"1.0.0"},"components":{"schemas":{"MiniMaxH3MaxDirectorServerDispatchAccounting":{"properties":{"phases_ms":{"additionalProperties":{"type":"number"},"title":"Phases Ms","type":"object"},"overhead_ms":{"minimum":0,"title":"Overhead Ms","type":"number"},"wall_ms":{"minimum":0,"title":"Wall Ms","type":"number"},"classified_ms":{"minimum":0,"title":"Classified Ms","type":"number"}},"title":"DispatchAccounting","required":["wall_ms","classified_ms","overhead_ms","phases_ms"],"type":"object"},"MiniMaxH3MaxDirectorServerPongMessage":{"properties":{"client_ts":{"title":"Client Ts","type":"number"},"type":{"title":"Type","const":"pong","type":"string","default":"pong"}},"title":"PongMessage","required":["type","client_ts"],"type":"object"},"MiniMaxH3MaxDirectorServerSessionMetricSummary":{"properties":{"p50_ms":{"minimum":0,"title":"P50 Ms","type":"number"},"total_ms":{"minimum":0,"title":"Total Ms","type":"number"},"max_ms":{"minimum":0,"title":"Max Ms","type":"number"},"p95_ms":{"minimum":0,"title":"P95 Ms","type":"number"},"count":{"minimum":0,"title":"Count","type":"integer"}},"title":"SessionMetricSummary","required":["count","total_ms","p50_ms","p95_ms","max_ms"],"type":"object"},"MiniMaxH3MaxDirectorServerStreamExhaustedMessage":{"properties":{"reason":{"enum":["stopped","session_limit"],"title":"Reason","type":"string"},"chunks":{"minimum":0,"title":"Chunks","type":"integer"},"type":{"title":"Type","const":"stream_exhausted","type":"string","default":"stream_exhausted"}},"title":"StreamExhaustedMessage","required":["type","chunks","reason"],"type":"object"},"MiniMaxH3MaxDirectorServerPromptPendingMessage":{"properties":{"prompt_version":{"minimum":1,"title":"Prompt Version","type":"integer"},"type":{"title":"Type","const":"prompt_pending","type":"string","default":"prompt_pending"}},"title":"PromptPendingMessage","required":["type","prompt_version"],"type":"object"},"MiniMaxH3MaxDirectorServerChunkMessage":{"properties":{"buffer_depth_seconds":{"minimum":0,"title":"Buffer Depth Seconds","type":"number"},"scheduling_lead_ms":{"title":"Scheduling Lead Ms","type":"number"},"playback_seconds":{"title":"Playback Seconds","exclusiveMinimum":0,"type":"number"},"route":{"enum":["gorgonea","betelgeuse","regulus","unknown"],"title":"Route","type":"string"},"type":{"title":"Type","const":"chunk","type":"string","default":"chunk"},"prompt_version":{"minimum":1,"title":"Prompt Version","type":"integer"},"dispatch":{"$ref":"#/components/schemas/MiniMaxH3MaxDirectorServerDispatchAccounting"},"chunk_index":{"minimum":0,"title":"Chunk Index","type":"integer"},"next_generation_estimate_seconds":{"minimum":0,"title":"Next Generation Estimate Seconds","type":"number"},"generation_seconds":{"minimum":0,"title":"Generation Seconds","type":"number"},"requested_duration_seconds":{"minimum":5,"title":"Requested Duration Seconds","maximum":15,"type":"integer"},"scheduling_slack_ms":{"title":"Scheduling Slack Ms","type":"number"},"trimmed_context_frames":{"minimum":0,"title":"Trimmed Context Frames","type":"integer"},"buffer_depth_chunks":{"minimum":0,"title":"Buffer Depth Chunks","type":"integer"},"generated_frame_count":{"title":"Generated Frame Count","exclusiveMinimum":0,"type":"integer"}},"title":"ChunkMessage","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"},"MiniMaxH3MaxDirectorServerChunkMetricsMessage":{"properties":{"chunk_index":{"minimum":0,"title":"Chunk Index","type":"integer"},"phases_ms":{"additionalProperties":{"type":"number"},"title":"Phases Ms","type":"object"},"gauges":{"additionalProperties":{"type":"number"},"title":"Gauges","type":"object"},"units":{"title":"Units","const":"ms","type":"string"},"route":{"enum":["gorgonea","betelgeuse","regulus","unknown"],"title":"Route","type":"string"},"type":{"title":"Type","const":"chunk_metrics","type":"string","default":"chunk_metrics"},"chunk_consumable_ready_ms":{"title":"Chunk Consumable Ready Ms","anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null},"chunk_consumable_interval_ms":{"title":"Chunk Consumable Interval Ms","anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null}},"title":"ChunkMetricsMessage","required":["type","chunk_index","units","route","phases_ms","gauges"],"type":"object"},"MiniMaxH3MaxDirectorServerDeadlineMissedMessage":{"properties":{"behavior":{"title":"Behavior","const":"freeze_video_and_silence_audio_until_ready","type":"string"},"chunk_index":{"minimum":0,"title":"Chunk Index","type":"integer"},"type":{"title":"Type","const":"deadline_missed","type":"string","default":"deadline_missed"},"late_by_seconds":{"minimum":0,"title":"Late By Seconds","type":"number"}},"title":"DeadlineMissedMessage","required":["type","chunk_index","late_by_seconds","behavior"],"type":"object"},"MiniMaxH3MaxDirectorServerPromptAppliedMessage":{"properties":{"prompt_version":{"minimum":1,"title":"Prompt Version","type":"integer"},"type":{"title":"Type","const":"prompt_applied","type":"string","default":"prompt_applied"}},"title":"PromptAppliedMessage","required":["type","prompt_version"],"type":"object"},"MiniMaxH3MaxDirectorClientConfigureMessage":{"additionalProperties":false,"properties":{"memory":{"minimum":1,"type":"integer","title":"Memory","description":"Number of prior segment prompts retained as context for future prompt expansion.","maximum":50,"default":12},"protocol_version":{"title":"Protocol Version","const":1,"type":"integer","default":1},"prompt":{"title":"Prompt","maxLength":50000,"examples":["A continuous original live-action stream following a group of friends as they explore a new city."],"type":"string","minLength":1},"seed":{"title":"Seed","anyOf":[{"type":"integer"},{"type":"null"}],"default":null},"type":{"title":"Type","const":"configure","type":"string"},"resolution":{"enum":["480p","768p"],"title":"Resolution","type":"string","default":"768p"},"aspect_ratio":{"enum":["16:9","9:16","1:1"],"title":"Aspect Ratio","type":"string","default":"16:9"},"prompt_version":{"minimum":1,"title":"Prompt Version","type":"integer"}},"title":"ConfigureMessage","required":["type","prompt_version","prompt"],"type":"object"},"MiniMaxH3MaxDirectorServerSessionInfoMessage":{"title":"SessionInfoMessage","properties":{"protocol_version":{"title":"Protocol Version","const":1,"type":"integer","default":1},"prompt_deck_size":{"title":"Prompt Deck Size","const":3,"type":"integer","default":3},"chunk_seconds":{"title":"Chunk Seconds","const":10,"type":"integer","default":10},"min_chunk_duration":{"title":"Min Chunk Duration","const":5,"type":"integer","default":5},"resolutions":{"type":"array","title":"Resolutions","items":{"enum":["480p","768p"],"type":"string"},"default":["480p","768p"]},"server_message_types":{"type":"array","title":"Server Message Types","items":{"enum":["chunk","chunk_metrics","configured","deadline_missed","error","pong","prompt_applied","prompt_pending","prompt_rejected","session_info","session_metrics","stream_exhausted"],"type":"string"},"default":["chunk","chunk_metrics","configured","deadline_missed","error","pong","prompt_applied","prompt_pending","prompt_rejected","session_info","session_metrics","stream_exhausted"]},"app":{"title":"App","const":"minimax-h3-max-director","type":"string","default":"minimax-h3-max-director"},"accelerations":{"type":"array","title":"Accelerations","items":{"enum":["none","regular"],"type":"string"},"default":["none","regular"]},"type":{"title":"Type","const":"session_info","type":"string","default":"session_info"},"continuation_playback_seconds":{"title":"Continuation Playback Seconds","type":"number","default":8.5},"client_message_types":{"type":"array","title":"Client Message Types","items":{"enum":["configure","ping","prompt","stop"],"type":"string"},"default":["configure","ping","prompt","stop"]},"default_memory":{"title":"Default Memory","const":12,"type":"integer","default":12},"max_chunk_duration":{"title":"Max Chunk Duration","const":15,"type":"integer","default":15},"continuation_context_frames":{"title":"Continuation Context Frames","const":39,"type":"integer","default":39},"prompt_expander":{"title":"Prompt Expander","const":"fast","type":"string","default":"fast"},"default_chunk_duration":{"title":"Default Chunk Duration","const":10,"type":"integer","default":10},"controller_machine_type":{"title":"Controller Machine Type","const":"XL","type":"string","default":"XL"},"backend_selection":{"title":"Backend Selection","const":"minimax-h3-turbo-balancer","type":"string","default":"minimax-h3-turbo-balancer"},"default_acceleration":{"title":"Default Acceleration","const":"regular","type":"string","default":"regular"},"max_memory":{"title":"Max Memory","const":50,"type":"integer","default":50},"min_memory":{"title":"Min Memory","const":1,"type":"integer","default":1},"audio_sample_rate":{"title":"Audio Sample Rate","const":32000,"type":"integer","default":32000},"prompt_context_segments":{"title":"Prompt Context Segments","const":12,"type":"integer","default":12},"one_session_per_machine":{"title":"One Session Per Machine","const":true,"type":"boolean","default":true},"aspect_ratios":{"type":"array","title":"Aspect Ratios","items":{"enum":["16:9","9:16","1:1"],"type":"string"},"default":["16:9","9:16","1:1"]},"fps":{"title":"Fps","const":24,"type":"integer","default":24},"max_session_seconds":{"title":"Max Session Seconds","anyOf":[{"type":"number"},{"type":"null"}],"default":null}},"type":"object","required":["type"]},"MiniMaxH3MaxDirectorServerSessionMetricsMessage":{"properties":{"final":{"title":"Final","type":"boolean","default":false},"gauges":{"additionalProperties":{"type":"number"},"title":"Gauges","type":"object"},"units":{"title":"Units","const":"ms","type":"string"},"history_size":{"minimum":0,"title":"History Size","type":"integer"},"type":{"title":"Type","const":"session_metrics","type":"string","default":"session_metrics"},"history_limit":{"minimum":1,"title":"History Limit","type":"integer"},"session_wall_ms":{"minimum":0,"title":"Session Wall Ms","type":"number"},"phases":{"additionalProperties":{"$ref":"#/components/schemas/MiniMaxH3MaxDirectorServerSessionMetricSummary"},"title":"Phases","type":"object"}},"title":"SessionMetricsMessage","required":["type","units","session_wall_ms","history_size","history_limit","phases","gauges"],"type":"object"},"MiniMaxH3MaxDirectorClientStopMessage":{"additionalProperties":false,"properties":{"type":{"title":"Type","const":"stop","type":"string"}},"title":"StopMessage","required":["type"],"type":"object"},"MiniMaxH3MaxDirectorServerErrorMessage":{"properties":{"detail":{"title":"Detail","anyOf":[{"items":{"type":"object"},"type":"array"},{"type":"null"}],"default":null},"code":{"enum":["content_policy","configuration_timeout","generation_failed","generation_timeout","immutable_settings","initialization_timeout","invalid_initial_image","invalid_message","not_configured","stale_prompt_version"],"title":"Code","type":"string"},"prompt_version":{"title":"Prompt Version","anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null},"type":{"title":"Type","const":"error","type":"string","default":"error"},"error":{"title":"Error","type":"string"}},"title":"ErrorMessage","required":["type","code","error"],"type":"object"},"MiniMaxH3MaxDirectorServerPromptRejectedMessage":{"properties":{"reason":{"title":"Reason","const":"content_policy","type":"string"},"prompt_version":{"minimum":1,"title":"Prompt Version","type":"integer"},"type":{"title":"Type","const":"prompt_rejected","type":"string","default":"prompt_rejected"}},"title":"PromptRejectedMessage","required":["type","prompt_version","reason"],"type":"object"},"MiniMaxH3MaxDirectorClientPromptMessage":{"additionalProperties":false,"properties":{"prompt":{"title":"Prompt","maxLength":50000,"type":"string","minLength":1},"prompt_version":{"minimum":1,"title":"Prompt Version","type":"integer"},"type":{"title":"Type","const":"prompt","type":"string"}},"title":"PromptMessage","required":["type","prompt_version","prompt"],"type":"object"},"MiniMaxH3MaxDirectorClientPingMessage":{"additionalProperties":false,"properties":{"type":{"title":"Type","const":"ping","type":"string"},"ts":{"title":"Ts","type":"number"}},"title":"PingMessage","required":["type","ts"],"type":"object"},"MiniMaxH3MaxDirectorServerConfiguredMessage":{"properties":{"memory":{"title":"Memory","anyOf":[{"minimum":1,"maximum":50,"type":"integer"},{"type":"null"}],"default":null},"chunk_duration":{"title":"Chunk Duration","anyOf":[{"minimum":5,"maximum":15,"type":"integer"},{"type":"null"}],"default":null},"acceleration":{"title":"Acceleration","anyOf":[{"enum":["none","regular"],"type":"string"},{"type":"null"}],"default":null},"type":{"title":"Type","const":"configured","type":"string","default":"configured"},"has_initial_image":{"title":"Has Initial Image","anyOf":[{"type":"boolean"},{"type":"null"}],"default":null},"enable_safety_checker":{"title":"Enable Safety Checker","type":"boolean"},"resolution":{"title":"Resolution","anyOf":[{"enum":["480p","544p","640p","704p","768p"],"type":"string"},{"enum":["480p","768p"],"type":"string"},{"type":"null"}],"default":null},"prompt_version":{"minimum":1,"title":"Prompt Version","type":"integer"},"aspect_ratio":{"title":"Aspect Ratio","anyOf":[{"enum":["16:9","9:16","1:1"],"type":"string"},{"type":"null"}],"default":null}},"title":"ConfiguredMessage","required":["type","prompt_version","enable_safety_checker"],"type":"object"}},"messages":{"server.configured":{"title":"Server configured message","payload":{"$ref":"#/components/schemas/MiniMaxH3MaxDirectorServerConfiguredMessage"},"name":"configured"},"server.session_info":{"title":"Server session_info message","payload":{"$ref":"#/components/schemas/MiniMaxH3MaxDirectorServerSessionInfoMessage"},"name":"session_info"},"client.ping":{"title":"Client ping message","payload":{"$ref":"#/components/schemas/MiniMaxH3MaxDirectorClientPingMessage"},"name":"ping"},"server.stream_exhausted":{"title":"Server stream_exhausted message","payload":{"$ref":"#/components/schemas/MiniMaxH3MaxDirectorServerStreamExhaustedMessage"},"name":"stream_exhausted"},"server.prompt_rejected":{"title":"Server prompt_rejected message","payload":{"$ref":"#/components/schemas/MiniMaxH3MaxDirectorServerPromptRejectedMessage"},"name":"prompt_rejected"},"server.pong":{"title":"Server pong message","payload":{"$ref":"#/components/schemas/MiniMaxH3MaxDirectorServerPongMessage"},"name":"pong"},"client.stop":{"title":"Client stop message","payload":{"$ref":"#/components/schemas/MiniMaxH3MaxDirectorClientStopMessage"},"name":"stop"},"server.chunk_metrics":{"title":"Server chunk_metrics message","payload":{"$ref":"#/components/schemas/MiniMaxH3MaxDirectorServerChunkMetricsMessage"},"name":"chunk_metrics"},"server.prompt_pending":{"title":"Server prompt_pending message","payload":{"$ref":"#/components/schemas/MiniMaxH3MaxDirectorServerPromptPendingMessage"},"name":"prompt_pending"},"server.error":{"title":"Server error message","payload":{"$ref":"#/components/schemas/MiniMaxH3MaxDirectorServerErrorMessage"},"name":"error"},"server.deadline_missed":{"title":"Server deadline_missed message","payload":{"$ref":"#/components/schemas/MiniMaxH3MaxDirectorServerDeadlineMissedMessage"},"name":"deadline_missed"},"server.chunk":{"title":"Server chunk message","payload":{"$ref":"#/components/schemas/MiniMaxH3MaxDirectorServerChunkMessage"},"name":"chunk"},"server.session_metrics":{"title":"Server session_metrics message","payload":{"$ref":"#/components/schemas/MiniMaxH3MaxDirectorServerSessionMetricsMessage"},"name":"session_metrics"},"server.prompt_applied":{"title":"Server prompt_applied message","payload":{"$ref":"#/components/schemas/MiniMaxH3MaxDirectorServerPromptAppliedMessage"},"name":"prompt_applied"},"client.configure":{"title":"Client configure message","examples":[{"payload":{"memory":12,"protocol_version":1,"chunk_duration":10,"prompt":"An original continuous 2D anime adventure following the same three travelers aboard a luminous train crossing impossible worlds. Preserve the crew, train, relationships, and visual continuity while each station introduces a new mystery, creature, or crisis.","acceleration":"regular","type":"configure","enable_safety_checker":true,"resolution":"768p","prompt_version":1,"aspect_ratio":"16:9"},"name":"Anime / Moonrail"},{"payload":{"memory":12,"protocol_version":1,"chunk_duration":10,"prompt":"An endless first-person hand-painted storybook adventure following a small brass knight through magical worlds connected by glowing doors. Preserve the current quest, creatures, collected objects, and warm painterly style.","acceleration":"regular","type":"configure","enable_safety_checker":true,"resolution":"768p","prompt_version":1,"aspect_ratio":"16:9"},"name":"Storybook"},{"payload":{"memory":12,"protocol_version":1,"chunk_duration":10,"prompt":"An unpredictable continuous cinematic multiverse where the action, setting, genre, characters, and visual medium can change radically. Preserve at least one visible subject, object, action, or camera movement through every transition.","acceleration":"regular","type":"configure","enable_safety_checker":true,"resolution":"768p","prompt_version":1,"aspect_ratio":"16:9"},"name":"Chaos"},{"payload":{"memory":12,"protocol_version":1,"chunk_duration":10,"prompt":"A continuous original live-action American sitcom produced in 1994. Preserve established characters and storylines while advancing them through dialogue, misunderstandings, entrances, reactions, and recurring jokes.","acceleration":"regular","type":"configure","enable_safety_checker":true,"resolution":"768p","prompt_version":1,"aspect_ratio":"16:9"},"name":"Sitcom"},{"payload":{"memory":12,"protocol_version":1,"chunk_duration":10,"prompt":"An endless top-down isometric claymation game following one persistent, industrious critter through an expanding underground world. Focus on discovery, crafting, building, playful creatures, and harmless environmental challenges.","acceleration":"regular","type":"configure","enable_safety_checker":true,"resolution":"768p","prompt_version":1,"aspect_ratio":"16:9"},"name":"Crafty Critters"},{"payload":{"memory":12,"protocol_version":1,"chunk_duration":10,"prompt":"An endless original 2D animated comedy starring the same three abstract friends in their neighborhood workshop. Preserve their designs and personalities while introducing harmless inventions, visual jokes, and comedic complications.","acceleration":"regular","type":"configure","enable_safety_checker":true,"resolution":"480p","prompt_version":1,"aspect_ratio":"16:9"},"name":"Cartoon"},{"payload":{"memory":12,"protocol_version":1,"chunk_duration":10,"prompt":"A continuous black-and-white 1950s-style melodrama filled with secrets, betrayals, forbidden romances, and dramatic revelations. Preserve established relationships and emotional conflicts in a cinematic fictional world.","acceleration":"regular","type":"configure","enable_safety_checker":true,"resolution":"480p","prompt_version":1,"aspect_ratio":"16:9"},"name":"Soap Opera"}],"payload":{"$ref":"#/components/schemas/MiniMaxH3MaxDirectorClientConfigureMessage"},"name":"configure"},"client.prompt":{"title":"Client prompt message","payload":{"$ref":"#/components/schemas/MiniMaxH3MaxDirectorClientPromptMessage"},"name":"prompt"}}},"operations":{"receiveEvents":{"messages":[{"$ref":"#/channels/control/messages/server.chunk"},{"$ref":"#/channels/control/messages/server.chunk_metrics"},{"$ref":"#/channels/control/messages/server.configured"},{"$ref":"#/channels/control/messages/server.deadline_missed"},{"$ref":"#/channels/control/messages/server.error"},{"$ref":"#/channels/control/messages/server.pong"},{"$ref":"#/channels/control/messages/server.prompt_applied"},{"$ref":"#/channels/control/messages/server.prompt_pending"},{"$ref":"#/channels/control/messages/server.prompt_rejected"},{"$ref":"#/channels/control/messages/server.session_info"},{"$ref":"#/channels/control/messages/server.session_metrics"},{"$ref":"#/channels/control/messages/server.stream_exhausted"}],"action":"receive","channel":{"$ref":"#/channels/control"}},"sendControl":{"messages":[{"$ref":"#/channels/control/messages/client.configure"},{"$ref":"#/channels/control/messages/client.ping"},{"$ref":"#/channels/control/messages/client.prompt"},{"$ref":"#/channels/control/messages/client.stop"}],"action":"send","channel":{"$ref":"#/channels/control"}}},"x-fal-media":{"receive":[{"kind":"video","settings":{"frameRate":24}},{"kind":"audio"}],"send":[],"perspective":"client"},"servers":{"session":{"protocol":"webrtc","x-fal-negotiated-by":"start_session_start_session_post","description":"Runtime-assigned WebRTC peer negotiated over HTTP.","host":"{sessionHost}","variables":{"sessionHost":{"description":"Logical peer supplied by the OpenAPI session negotiation.","default":"runtime-assigned.invalid"}}}},"asyncapi":"3.1.0"}