FLUX 3 Video：透過模型頁面與 API 生成帶原生音訊的多模態影片 | RunComfy

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-3/video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A powerful dappled-grey stallion gallops across a windswept green moor under a brooding storm sky, mane and tail streaming, clumps of turf kicking up in slow motion, distant thunder rumbling and hooves pounding the earth, cinematic low-angle tracking shot, moody desaturated color, anamorphic look."
  }'

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"
  ],
  "properties": {
    "prompt": {
      "title": "提示詞",
      "description": "描述影片內容的文字提示詞（中文建議不超過約 500 個字元，英文建議不超過約 1000 個單字）。",
      "type": "string",
      "default": "A powerful dappled-grey stallion gallops across a windswept green moor under a brooding storm sky, mane and tail streaming, clumps of turf kicking up in slow motion, distant thunder rumbling and hooves pounding the earth, cinematic low-angle tracking shot, moody desaturated color, anamorphic look."
    },
    "images": {
      "title": "參考圖像",
      "description": "多模態參考模式使用的圖像（0～9 張）。支援 jpeg、png、webp、bmp、tiff、gif。",
      "type": "array",
      "items": {
        "type": "string",
        "format": "image_uri"
      },
      "maxItems": 9
    },
    "videos": {
      "title": "參考影片",
      "description": "多模態參考模式使用的影片（0～3 個）。支援 mp4、mov，影片時長必須為 2～15 秒。",
      "type": "array",
      "items": {
        "type": "string",
        "format": "video_uri"
      },
      "maxItems": 3
    },
    "audios": {
      "title": "參考音訊 URL",
      "description": "多模態參考模式使用的音訊（0～3 個）。支援 wav、mp3，音訊時長必須為 2～15 秒，檔案大小應小於 15 MB。",
      "type": "array",
      "items": {
        "type": "string",
        "format": "audio_uri"
      },
      "maxItems": 3
    },
    "aspect_ratio": {
      "title": "長寬比（寬：高）",
      "description": "預設為 `adaptive`。模型會選擇最接近的比例，實際比例會在任務查詢結果中回傳。",
      "type": "string",
      "enum": [
        "adaptive",
        "16:9",
        "9:16",
        "4:3",
        "3:4",
        "1:1",
        "21:9"
      ],
      "default": "adaptive"
    },
    "duration": {
      "title": "時長（秒）",
      "description": "填寫 4～15 之間的整數。",
      "type": "integer",
      "minimum": 4,
      "maximum": 15,
      "default": 5
    },
    "resolution": {
      "title": "解析度",
      "description": "",
      "type": "string",
      "enum": [
        "480p",
        "720p",
        "1080p",
        "4k"
      ],
      "default": "720p"
    },
    "generate_audio": {
      "title": "生成音訊",
      "description": "設為 `true` 時，模型會輸出帶同步音訊（對白、音效、音樂）的影片。",
      "type": "boolean",
      "default": true
    },
    "seed": {
      "title": "隨機種子",
      "description": "影片生成使用的隨機種子。",
      "type": "integer"
    },
    "tools": {
      "title": "網頁搜尋",
      "description": "加入 `web_search` 後，模型可能根據提示詞內容（例如特定產品、目前天氣）進行線上搜尋。這樣有助於提高事實時效性，但也會增加處理時間。",
      "type": "boolean",
      "default": false
    }
  }
}