FLUX 3 Max Keyframes To Video：在 Models and API 上的多帧 720p 和 1080p 剪辑 | RunComfy

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-3-max/keyframes-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "He sets the robe on the rock, lowers himself into the steaming pool, then turns toward the woman beside him and smiles. Snow keeps falling. Water, soft wind, and a quiet laugh. No text.",
    "keyframes": [
      {
        "image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7471/media-files/ref-promo-1.webp",
        "frame_index": 0
      },
      {
        "image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7471/media-files/ref-promo-2.webp",
        "frame_index": 60
      },
      {
        "image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7471/media-files/ref-promo-3.webp",
        "frame_index": 120
      }
    ]
  }'

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",
    "keyframes"
  ],
  "properties": {
    "prompt": {
      "title": "提示词",
      "description": "描述剪辑应如何在关键帧静止画面之间移动。",
      "type": "string",
      "default": "He sets the robe on the rock, lowers himself into the steaming pool, then turns toward the woman beside him and smiles. Snow keeps falling. Water, soft wind, and a quiet laugh. No text."
    },
    "keyframes": {
      "title": "关键帧",
      "description": "最多 10 张图片。每张图片都需要在 24 fps 时间线上设置唯一的 frame_index，且不得超过视频时长（秒）× 24。",
      "type": "array",
      "default": [
        {
          "image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7471/media-files/ref-promo-1.webp",
          "frame_index": 0
        },
        {
          "image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7471/media-files/ref-promo-2.webp",
          "frame_index": 60
        },
        {
          "image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7471/media-files/ref-promo-3.webp",
          "frame_index": 120
        }
      ],
      "items": {
        "image_url": {
          "title": "图片网址",
          "description": "关键帧图像 URL。PNG、JPEG 或 WebP。",
          "type": "string",
          "format": "image_uri",
          "default": ""
        },
        "frame_index": {
          "title": "帧索引",
          "description": "在 24 fps 时间线上的位置。索引必须唯一，且不得超过视频时长（秒）× 24。",
          "type": "integer",
          "format": "int_slider_with_range",
          "minimum": 0,
          "maximum": 480,
          "default": 0
        }
      },
      "maxItems": 10,
      "minItems": 1
    },
    "aspect_ratio": {
      "title": "宽高比",
      "description": "输出帧形状。auto 跟随第一张图像。",
      "type": "string",
      "enum": [
        "auto",
        "21:9",
        "2:1",
        "16:9",
        "4:3",
        "1:1",
        "3:4",
        "9:16"
      ],
      "default": "auto"
    },
    "resolution": {
      "title": "分辨率",
      "description": "输出分辨率。720p 是默认值。1080p 是更清晰的选项。",
      "type": "string",
      "enum": [
        "720p",
        "1080p"
      ],
      "default": "720p"
    },
    "duration": {
      "title": "时长",
      "description": "剪辑长度（以整秒为单位）。",
      "type": "integer",
      "enum": [
        5,
        6,
        7,
        8,
        9,
        10,
        11,
        12,
        13,
        14,
        15,
        16,
        17,
        18,
        19,
        20
      ],
      "default": 5
    },
    "generate_audio": {
      "title": "生成音频",
      "description": "为视频创建音频轨道。关闭此选项以制作无声剪辑。",
      "type": "boolean",
      "default": true
    },
    "reasoning_level": {
      "title": "推理级别",
      "description": "low 返回更快；high 会花更多时间理解提示词，因此生成速度较慢。",
      "type": "string",
      "enum": [
        "low",
        "high"
      ],
      "default": "high"
    },
    "seed": {
      "title": "种子",
      "description": "可选。留空，模型将选择一个随机种子。",
      "type": "integer"
    }
  }
}