FLUX 3 Keyframes to Video：模型和 API 上的多關鍵影格影像到影片 | RunComfy

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-3/keyframes-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "One continuous tracking shot: she starts on the wet coastal road facing the distant lighthouse, walks through the wooden gate as the mist thins, and arrives at the lighthouse base just as sunlight breaks through. Soft ocean spray, distant gulls, natural footsteps on wet asphalt.",
    "keyframes": [
      {
        "image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7399/media-files/ref-promo-1.webp",
        "frame_index": 0
      },
      {
        "image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7399/media-files/ref-promo-2.webp",
        "frame_index": 60
      },
      {
        "image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7399/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": "modelApiDoc_navInputSchema",
  "required": [
    "prompt",
    "keyframes"
  ],
  "properties": {
    "prompt": {
      "title": "提示詞",
      "description": "描述你想生成的影片內容的文字提示詞。",
      "type": "string",
      "default": "One continuous tracking shot: she starts on the wet coastal road facing the distant lighthouse, walks through the wooden gate as the mist thins, and arrives at the lighthouse base just as sunlight breaks through. Soft ocean spray, distant gulls, natural footsteps on wet asphalt."
    },
    "keyframes": {
      "title": "關鍵幀",
      "description": "固定在生成影片幀位置上的關鍵幀圖片。最多 10 個關鍵幀，每個需有唯一的 frame_index（從 0 起，不超過時長 × 24，24 fps）。",
      "type": "array",
      "default": [
        {
          "image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7399/media-files/ref-promo-1.webp",
          "frame_index": 0
        },
        {
          "image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7399/media-files/ref-promo-2.webp",
          "frame_index": 60
        },
        {
          "image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7399/media-files/ref-promo-3.webp",
          "frame_index": 120
        }
      ],
      "items": {
        "image_url": {
          "title": "圖片 URL",
          "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": "16:9"
    },
    "resolution": {
      "title": "解析度",
      "description": "生成影片的解析度。",
      "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
    },
    "safety_tolerance": {
      "title": "安全容忍度",
      "description": "生成影片的安全容忍級別。0 最嚴格，4 最寬鬆。",
      "type": "integer",
      "minimum": 0,
      "maximum": 4,
      "default": 2
    }
  }
}