Blackforestlabs FLUX 3 Max API | 요금 및 문서

blackforestlabs/flux-3-max/image-to-video

FLUX 3 Max는 텍스트, 시작 이미지 또는 키프레임에서 짧은 클립을 만들어주며, 선택적으로 720p 또는 1080p에서 오디오를 추가할 수 있습니다.

1. 시작하기

RunComfy API로 blackforestlabs/flux-3-max/image-to-video을(를) 실행합니다. 허용되는 입력·출력은 모델 스키마.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-3-max/image-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7473/media-files/ref-promo.webp",
    "prompt": "She lowers her hand, turns toward the sea, and the ivory scarf lifts in the wind. A slow push-in. Dry grass shifts. Wind and one distant gull. No text."
  }'

2. 인증

환경 변수 YOUR_API_TOKEN 에 API 키를 설정하세요( 프로필에서 키 관리). 모든 요청에 Authorization 헤더로 Bearer 토큰을 포함: Authorization: Bearer $YOUR_API_TOKEN.

3. API 참조

요청 제출

비동기 생성 작업을 제출하면 즉시 request_id와 상태 확인·결과 조회·취소용 URL을 받습니다.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-3-max/image-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7473/media-files/ref-promo.webp",
    "prompt": "She lowers her hand, turns toward the sea, and the ivory scarf lifts in the wind. A slow push-in. Dry grass shifts. Wind and one distant gull. No text."
  }'

요청 상태 확인

request_id의 현재 상태를 가져옵니다("in_queue", "in_progress", "completed", "cancelled").

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

결과 가져오기

지정한 request_id의 최종 출력과 메타데이터를 가져옵니다. 작업이 완료되지 않았으면 현재 상태가 반환되어 폴링을 계속할 수 있습니다.

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

요청 취소

request_id로 대기 중인 작업을 취소합니다. 진행 중인 작업은 취소할 수 없습니다.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. 파일 입력

호스트 파일(URL)

공개적으로 접근 가능한 HTTPS URL을 제공하세요. 서버 측 페치가 가능하고(로그인/쿠키 불필요) 속도 제한이나 봇 차단이 없어야 합니다. 권장: 이미지 ≤ 50MB(약 4K), 동영상 ≤ 100MB(720p 기준 약 2–5분). 비공개 자산은 안정적이거나 사전 서명 URL을 권장합니다.

5. 스키마

입력 스키마

{
  "type": "object",
  "title": "입력 스키마",
  "required": [
    "image_url",
    "prompt"
  ],
  "properties": {
    "image_url": {
      "title": "이미지 URL",
      "description": "이미지 시작. PNG, JPEG, 또는 WebP.",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7473/media-files/ref-promo.webp"
    },
    "prompt": {
      "title": "프롬프트",
      "description": "시작 프레임 이후에 무엇이 움직여야 하는지, 카메라와 사운드를 포함하여 설명하세요.",
      "type": "string",
      "default": "She lowers her hand, turns toward the sea, and the ivory scarf lifts in the wind. A slow push-in. Dry grass shifts. Wind and one distant gull. No text."
    },
    "end_image_url": {
      "title": "끝 이미지 URL",
      "description": "선택 사항인 마지막 프레임. PNG, JPEG, 또는 WebP. 클립이 스스로 끝나도록 하려면 비워 두세요.",
      "type": "string"
    },
    "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": "출력 해상도. 720p이 기본값입니다. 1080p이 더 선명한 옵션입니다.",
      "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
    },
    "reasoning_level": {
      "title": "추론 수준",
      "description": "low가 더 빨리 돌아옵니다. high는 프롬프트에 더 많은 시간을 소비하고 더 느립니다.",
      "type": "string",
      "enum": [
        "low",
        "high"
      ],
      "default": "high"
    },
    "seed": {
      "title": "시드",
      "description": "선택 사항입니다. 비워두면 모델이 무작위 시드를 선택합니다.",
      "type": "integer"
    }
  }
}

출력 스키마

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "단일 이미지 URL"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "단일 동영상 URL"
      },
      "images": {
        "type": "array",
        "description": "여러 이미지 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "여러 동영상 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}

RunComfy

RunComfy는 최고의 ComfyUI 플랫폼으로서 ComfyUI 온라인 환경과 서비스를 제공하며 ComfyUI 워크플로우 멋진 비주얼을 제공합니다. RunComfy는 또한 제공합니다 AI Models, 예술가들이 최신 AI 도구를 활용하여 놀라운 예술을 창조할 수 있도록 지원합니다.

1. 시작하기

RunComfy API로 blackforestlabs/flux-3-max/image-to-video을(를) 실행합니다. 허용되는 입력·출력은 모델 스키마.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-3-max/image-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7473/media-files/ref-promo.webp",
    "prompt": "She lowers her hand, turns toward the sea, and the ivory scarf lifts in the wind. A slow push-in. Dry grass shifts. Wind and one distant gull. No text."
  }'

3. API 참조

요청 제출

비동기 생성 작업을 제출하면 즉시 request_id와 상태 확인·결과 조회·취소용 URL을 받습니다.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-3-max/image-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7473/media-files/ref-promo.webp",
    "prompt": "She lowers her hand, turns toward the sea, and the ivory scarf lifts in the wind. A slow push-in. Dry grass shifts. Wind and one distant gull. No text."
  }'

요청 상태 확인

request_id의 현재 상태를 가져옵니다("in_queue", "in_progress", "completed", "cancelled").

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

결과 가져오기

지정한 request_id의 최종 출력과 메타데이터를 가져옵니다. 작업이 완료되지 않았으면 현재 상태가 반환되어 폴링을 계속할 수 있습니다.

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

요청 취소

request_id로 대기 중인 작업을 취소합니다. 진행 중인 작업은 취소할 수 없습니다.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. 파일 입력

호스트 파일(URL)

5. 스키마

입력 스키마

{
  "type": "object",
  "title": "입력 스키마",
  "required": [
    "image_url",
    "prompt"
  ],
  "properties": {
    "image_url": {
      "title": "이미지 URL",
      "description": "이미지 시작. PNG, JPEG, 또는 WebP.",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7473/media-files/ref-promo.webp"
    },
    "prompt": {
      "title": "프롬프트",
      "description": "시작 프레임 이후에 무엇이 움직여야 하는지, 카메라와 사운드를 포함하여 설명하세요.",
      "type": "string",
      "default": "She lowers her hand, turns toward the sea, and the ivory scarf lifts in the wind. A slow push-in. Dry grass shifts. Wind and one distant gull. No text."
    },
    "end_image_url": {
      "title": "끝 이미지 URL",
      "description": "선택 사항인 마지막 프레임. PNG, JPEG, 또는 WebP. 클립이 스스로 끝나도록 하려면 비워 두세요.",
      "type": "string"
    },
    "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": "출력 해상도. 720p이 기본값입니다. 1080p이 더 선명한 옵션입니다.",
      "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
    },
    "reasoning_level": {
      "title": "추론 수준",
      "description": "low가 더 빨리 돌아옵니다. high는 프롬프트에 더 많은 시간을 소비하고 더 느립니다.",
      "type": "string",
      "enum": [
        "low",
        "high"
      ],
      "default": "high"
    },
    "seed": {
      "title": "시드",
      "description": "선택 사항입니다. 비워두면 모델이 무작위 시드를 선택합니다.",
      "type": "integer"
    }
  }
}

출력 스키마

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "단일 이미지 URL"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "단일 동영상 URL"
      },
      "images": {
        "type": "array",
        "description": "여러 이미지 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "여러 동영상 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}

FLUX 3 Max는 텍스트, 시작 이미지 또는 키프레임에서 짧은 클립을 만들어주며, 선택적으로 720p 또는 1080p에서 오디오를 추가할 수 있습니다.

목차

1. 시작하기

2. 인증

3. API 참조

요청 제출

요청 상태 확인

결과 가져오기

요청 취소

4. 파일 입력

호스트 파일(URL)

5. 스키마

입력 스키마

출력 스키마

FLUX 3 Max는 텍스트, 시작 이미지 또는 키프레임에서 짧은 클립을 만들어주며, 선택적으로 720p 또는 1080p에서 오디오를 추가할 수 있습니다.

목차

1. 시작하기

2. 인증

3. API 참조

요청 제출

요청 상태 확인

결과 가져오기

요청 취소

4. 파일 입력

호스트 파일(URL)

5. 스키마

입력 스키마

출력 스키마

FLUX 3 Max: Models and API에서 텍스트-투-비디오, 이미지-투-비디오, 그리고 키프레임-투-비디오 | RunComfy

FLUX 3 Max는 텍스트, 시작 이미지 또는 키프레임에서 짧은 클립을 만들어주며, 선택적으로 720p 또는 1080p에서 오디오를 추가할 수 있습니다.

목차

1. 시작하기

2. 인증

3. API 참조

요청 제출

요청 상태 확인

결과 가져오기

요청 취소

4. 파일 입력

호스트 파일(URL)

5. 스키마

입력 스키마

출력 스키마

FLUX 3 Max: Models and API에서 텍스트-투-비디오, 이미지-투-비디오, 그리고 키프레임-투-비디오 | RunComfy

FLUX 3 Max는 텍스트, 시작 이미지 또는 키프레임에서 짧은 클립을 만들어주며, 선택적으로 720p 또는 1080p에서 오디오를 추가할 수 있습니다.

목차

1. 시작하기

2. 인증

3. API 참조

요청 제출

요청 상태 확인

결과 가져오기

요청 취소

4. 파일 입력

호스트 파일(URL)

5. 스키마

입력 스키마

출력 스키마