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
    }
  }
}