FLUX 3 Image to Video：透過模型頁面與 API 實現圖生影片（可選原生音訊）| RunComfy

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-3/image-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7397/media-files/ref-promo.webp",
    "prompt": "Slow cinematic push-in as wind lifts her hair and linen shirt on a coastal cliff at golden hour; she turns toward the ocean light in one continuous unbroken shot. Soft waves and distant seabirds."
  }'

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": [
    "image_url",
    "prompt"
  ],
  "properties": {
    "image_url": {
      "title": "圖片 URL",
      "description": "影片起始畫面的圖片 URL（PNG、JPEG 或 WebP）。",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7397/media-files/ref-promo.webp"
    },
    "prompt": {
      "title": "提示詞",
      "description": "描述你想生成的影片內容的文字提示詞。",
      "type": "string",
      "default": "Slow cinematic push-in as wind lifts her hair and linen shirt on a coastal cliff at golden hour; she turns toward the ocean light in one continuous unbroken shot. Soft waves and distant seabirds."
    },
    "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": "生成影片的解析度。",
      "type": "string",
      "enum": [
        "720p",
        "1080p"
      ],
      "default": "720p"
    },
    "duration": {
      "title": "時長",
      "description": "生成影片的時長（秒）。auto 表示由模型自動選擇。",
      "type": "string",
      "enum": [
        "auto",
        "5",
        "6",
        "7",
        "8",
        "9",
        "10",
        "11",
        "12",
        "13",
        "14",
        "15",
        "16",
        "17",
        "18",
        "19",
        "20"
      ],
      "default": "auto"
    },
    "generate_audio": {
      "title": "生成音訊",
      "description": "是否為影片生成同步音訊。",
      "type": "boolean",
      "default": true
    },
    "safety_tolerance": {
      "title": "安全容忍度",
      "description": "生成影片的安全容忍等級。0 最嚴格，4 最寬鬆。",
      "type": "integer",
      "minimum": 0,
      "maximum": 4,
      "default": 2
    }
  }
}