MiniMax H3 Max Reference to video：Models and API 上的多模式影片 | RunComfy

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/minimax/minimax-h3-max/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Image 1 is the near man; Image 2 is the far man. Keep both faces, hair, and jackets identical to their reference images. Dusk in an empty asphalt parking lot under soft sodium lights. They stand a few meters apart. The near man says flatly: \"So… you actually tried it?\" A beat of wind. The far man answers with a slow half-smile, warm and certain: \"Yeah. I love it.\" The near man exhales and shakes his head once, almost smiling. Static camera, medium wide. Native audio, lip-synced English dialogue, distant traffic hum, wind. No music, no subtitles, no camera movement, no text, no watermark.",
    "prompt_expansion_mode": "balanced",
    "reference_images": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7453/media-files/ref-1.webp",
      "https://playgrounds-storage-public.runcomfy.net/tools/7453/media-files/ref-2.webp"
    ]
  }'

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

{
  "type": "object",
  "title": "輸入結構",
  "required": [
    "prompt",
    "prompt_expansion_mode",
    "reference_images"
  ],
  "properties": {
    "prompt": {
      "title": "提示詞",
      "description": "描述場景、動作、攝影機和音訊。將資源稱為圖像 1、圖像 2、視訊 1、音訊 1，並說明每個參考提供的內容。",
      "type": "string",
      "default": "Image 1 is the near man; Image 2 is the far man. Keep both faces, hair, and jackets identical to their reference images. Dusk in an empty asphalt parking lot under soft sodium lights. They stand a few meters apart. The near man says flatly: \"So… you actually tried it?\" A beat of wind. The far man answers with a slow half-smile, warm and certain: \"Yeah. I love it.\" The near man exhales and shakes his head once, almost smiling. Static camera, medium wide. Native audio, lip-synced English dialogue, distant traffic hum, wind. No music, no subtitles, no camera movement, no text, no watermark."
    },
    "reference_images": {
      "title": "參考圖片",
      "description": "主題或樣式參考圖像 URL，在提示中引用為圖像 1、圖像 2 等。結合視頻和音頻，最多 12 個參考文件。",
      "type": "array",
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7453/media-files/ref-1.webp",
        "https://playgrounds-storage-public.runcomfy.net/tools/7453/media-files/ref-2.webp"
      ],
      "items": {
        "type": "string",
        "format": "image_uri"
      },
      "maxItems": 12
    },
    "reference_videos": {
      "title": "參考影片",
      "description": "運動參考片段（每個約2-15秒，組合長度最多15秒），引用為影片1、影片2。結合影像和音頻，最多12個參考文件。",
      "type": "array",
      "items": {
        "type": "string",
        "format": "video_uri"
      },
      "maxItems": 12
    },
    "reference_audios": {
      "title": "參考音訊",
      "description": "可選的語音或氛圍片段（每個約 2-15 秒；組合持續時間最多 15 秒）。不能作為唯一參考；至少提供一張圖片或影片。",
      "type": "array",
      "items": {
        "type": "string",
        "format": "audio_uri"
      },
      "maxItems": 12
    },
    "aspect_ratio": {
      "title": "寬高比",
      "description": "輸出縱橫比。 adaptive 盡可能遵循參考框架。",
      "type": "string",
      "enum": [
        "adaptive",
        "21:9",
        "16:9",
        "4:3",
        "1:1",
        "3:4",
        "9:16"
      ],
      "default": "adaptive"
    },
    "resolution": {
      "title": "解析度",
      "description": "本機生成解析度。 480p 更快/更便宜； 768p 是更清晰的預設值。",
      "type": "string",
      "enum": [
        "480p",
        "768p"
      ],
      "default": "768p"
    },
    "duration": {
      "title": "時長",
      "description": "產生的影片的長度（以秒為單位）(5-15)。",
      "type": "integer",
      "minimum": 5,
      "maximum": 15,
      "default": 5
    },
    "prompt_expansion_mode": {
      "title": "提示詞擴展模式",
      "description": "How much effort to spend rewriting the prompt before generation. balanced returns quickly; quality spends longer on a richer prompt.",
      "type": "string",
      "enum": [
        "balanced",
        "quality"
      ],
      "default": "balanced"
    },
    "seed": {
      "title": "種子",
      "description": "Fixed seed for reproducible results. Use -1 for a random seed.",
      "type": "integer",
      "default": -1
    },
    "enable_safety_checker": {
      "title": "啟用安全檢查",
      "description": "If set to true, the safety checker will be enabled.",
      "type": "boolean",
      "default": true
    }
  }
}