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": "生成動画内のフレーム位置にピン留めするキーフレーム画像。固有の frame_index を持つキーフレームを最大 10 枚（0 始まり、最大は duration × 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 動画におけるこのキーフレームの位置。一意で、最大は duration × 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
    }
  }
}