FLUX 3 草稿關鍵幀到影片：模型和 API 上的快速多關鍵幀草稿 |運行舒適 | Models and API | RunComfy

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-3/keyframes-to-video/draft \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "One continuous tracking shot of a mountain steam train: it pulls away from a timber station, curves through a pine forest bend, and arrives at a stone tunnel mouth. Soft steam hiss, wheel clatter, distant forest birds.",
    "keyframes": [
      {
        "image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7408/media-files/ref-promo-1.webp",
        "frame_index": 0
      },
      {
        "image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7408/media-files/ref-promo-2.webp",
        "frame_index": 60
      },
      {
        "image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7408/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": "One continuous tracking shot of a mountain steam train: it pulls away from a timber station, curves through a pine forest bend, and arrives at a stone tunnel mouth. Soft steam hiss, wheel clatter, distant forest birds."
    },
    "keyframes": {
      "title": "關鍵影格",
      "description": "關鍵影格影像固定到產生的草稿中的畫面位置。最多 10 個具有唯一幀索引值的關鍵影格（從 0 開始，在 24 fps 時最多持續時間 × 24）。",
      "type": "array",
      "default": [
        {
          "image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7408/media-files/ref-promo-1.webp",
          "frame_index": 0
        },
        {
          "image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7408/media-files/ref-promo-2.webp",
          "frame_index": 60
        },
        {
          "image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7408/media-files/ref-promo-3.webp",
          "frame_index": 120
        }
      ],
      "items": {
        "image_url": {
          "title": "圖片網址",
          "description": "關鍵影格圖片（PNG、JPEG 或 WebP）的 URL。",
          "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"
    },
    "duration": {
      "title": "期間",
      "description": "草稿持續時間以整秒為單位，從 5 到 20。",
      "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
    }
  }
}