Black Forest Labs

FLUX 3 Video

flux-3-video

Black Forest Labs의 첫 번째 비디오 모델로, 통합 멀티모달 아키텍처를 갖추고 있어 텍스트-투-비디오, 이미지-투-비디오 및 키프레임 이어쓰기를 지원하며, 영상과 네이티브 오디오가 동기화되어 생성되고 1회 최대 약 20초 HD를 지원합니다

flux-3-video

flux-3-video 사용해 보기

입력

Draft

작품 갤러리

모든 작품 보기

출력

video

파라미터를 입력하고 생성하면 결과가 여기에 표시됩니다.

가격

flux-3-video per second

사양	720P	1080P
With Reference Videos	—	$0.760
Without Reference Videos	—	$0.420
Draft Off · Without Reference Videos	$0.250	—
Draft Off · With Reference Videos	$0.590	—
Draft On · Without Reference Videos	$0.090	—
Draft On · With Reference Videos	$0.180	—

모델 소개

FLUX 3 Video는 Black Forest Labs가 선보인 비디오 생성 모델로, 이미지·비디오·오디오·모션을 통합 학습한 통합 멀티모달 아키텍처를 채택하여 텍스트-투-비디오, 이미지-투-비디오, 비디오 연장의 세 가지 작업을 지원하며 화면과 일치하는 네이티브 오디오를 함께 생성합니다. 개발자는 HiAPI.ai 통합 인터페이스를 통해 호출하여 5–20초, 720p 또는 1080p 클립을 출력할 수 있습니다. 사운드가 포함된 상업용 소재를 빠르게 제작해야 하는 광고 및 숏폼 팀, 그리고 샷 연장과 키프레임 제어 프리비주얼이 필요한 영상 사전 제작 크리에이터에게 적합합니다.

핵심 하이라이트

세 가지 비디오 작업이 하나의 파라미터 세트 공유——동일한 모델이 텍스트-투-비디오, 이미지-투-비디오, 비디오 연장을 동시에 지원하여 작업을 전환할 때 연동 방식을 바꾸거나 워크플로를 다시 구축할 필요가 없습니다.
화면과 네이티브 오디오 동시 생성——기본적으로 화면과 함께 환경음, 대사, 효과음을 생성하여 별도의 더빙 및 동기화 작업을 생략할 수 있으며, 비활성화하면 무음 클립을 얻을 수 있습니다.
여러 이미지로 스토리보드 또는 키프레임 구성——이미지 1장으로 첫 프레임, 2장으로 첫·마지막 프레임, 3–10장으로 균등한 타임라인에 스토리보드를 구성하여 샷 리듬을 제어하기 쉽습니다.
드래프트 모드로 저비용 시험 제작——드래프트를 활성화하면 더 빠른 속도와 낮은 비용으로 720p 프리뷰를 출력하여 최종 확정 전에 프롬프트와 구도를 검증할 수 있습니다.

기능 설명

텍스트-투-비디오: 텍스트 프롬프트만으로 완전한 클립을 생성하며, 프롬프트는 분석 및 확장된 후 생성에 사용됩니다. 참조 소재 없이 처음부터 샷을 구성하는 데 적합합니다.

이미지-투-비디오 및 키프레임 제어: 1–10장의 이미지를 업로드하여 모션을 구동합니다. 단일 이미지는 첫 프레임, 두 이미지는 첫·마지막 프레임, 여러 이미지는 균등한 타임라인에 스토리보드를 구성하여 샷의 시작과 끝, 리듬을 정밀하게 제어합니다.

비디오 연장: 최대 15초, 50 MB 이내의 MP4를 전달하여 마지막 프레임부터 이어서 생성할 수 있으며, 기존 클립을 연장하거나 샷을 이어 붙이는 데 사용됩니다. 이 파라미터는 이미지 입력과 상호 배타적입니다.

길이 및 해상도 제어: 클립 길이는 5–20초, 해상도는 720p 또는 1080p를 선택할 수 있으며, 화면 비율은 21:9부터 9:16까지 총 8가지 프리셋과 auto 자동 선택을 지원합니다.

네이티브 오디오 생성: 기본적으로 화면과 동기화된 환경음, 대사, 효과음을 생성하며, 비활성화하면 무음 클립을 출력하여 후반에 별도로 음악이나 더빙을 입힐 수 있습니다.

활용 사례

광고 및 브랜드 팀: 단일 제품 이미지로 홍보 클립 생성——제품 이미지를 업로드하고 샷 움직임을 설명하여 환경음이 포함된 5–20초 소재를 제작하고, 소셜 미디어 광고나 웹사이트 첫 화면에 바로 사용합니다.
영상 사전 제작 크리에이터: 키프레임 프리비주얼 샷——2–10장의 스토리보드 이미지로 리듬을 고정하여 동적 프리비주얼 클립을 제작하고, 감독과 촬영 감독이 카메라 워킹과 편집점을 확인하도록 합니다.
숏폼 운영: 기존 소재를 이어서 확장——15초 이내의 MP4를 전달하여 마지막 부분부터 이어서 생성해 더 긴 완성 클립을 제작하여 재촬영과 추가 촬영을 줄입니다.
다국어 마케팅: 립싱크 동기화 로컬라이제이션 소재——프롬프트로 언어와 대사를 지정하여 음화면이 동기화된 로컬라이제이션 단편을 제작하고, 지역별 버전 광고에 사용합니다.

제한 사항 및 선택 가이드

단일 생성 길이 상한은 20초이며, 더 긴 콘텐츠는 분할 생성 후 비디오 연장으로 이어 붙여야 합니다. 출력 초 단위로 과금되므로 긴 클립이나 반복 재생성은 비용을 높입니다. 네이티브 오디오는 화면과 동시에 생성되므로 오디오 트랙을 후반에 독립적으로 조정할 여지가 제한적이며, 정교한 믹싱이 필요하면 오디오를 비활성화하고 별도로 제작하는 것이 좋습니다. 이미지 입력과 비디오 연장 파라미터는 상호 배타적이어서 동일한 요청에서 함께 사용할 수 없으며, 드래프트 모드는 720p로 제한됩니다. 20초를 초과하는 연속 샷이나 프레임 단위의 정밀한 오디오 제어가 필요한 작업이라면 분할·이어 붙이기 방안이나 다른 전용 도구를 검토해야 합니다.

새소식

변경 이력 보기 →

새 모델 flux-3-video 동영상 생성 모델 출시 Oct 31, 2026

생성 작업 제출

POST https://api.hiapi.ai/v1/tasks

헤더

Authorizationstring필수

계정 API 키. 모든 요청에 필수입니다. 예: Bearer YOUR_HIAPI_API_KEY. API 키 받기

Content-Typestring선택

요청 본문은 항상 JSON으로 파싱됩니다. 전송 시 application/json(charset 포함 가능)만 허용되며, 다른 값은 415를 반환합니다. 예: application/json.

Idempotency-Keystring선택

멱등 키. 최대 255바이트. 같은 계정에서 같은 키의 재시도는 태스크를 한 번만 생성하며, 재전송 시 최초의 taskId를 반환합니다.

멱등 키

네트워크 타임아웃이나 클라이언트 자동 재시도 시 같은 키로는 태스크를 한 번만 생성하고 이중 과금되지 않습니다(범위 = API 키의 계정). 업무 고유 식별자(예: "order-42")를 키로 사용할 것을 권장합니다. 같은 키 재전송 시 최초 taskId를 반환하며, 키는 첫 제출 후 24시간 뒤 만료됩니다. 자세한 시나리오 표는 통합 비동기 API 소개 페이지를 참고하세요.

본문

modelstring필수

현재 고정 값: flux-3-video

routestring선택

현재 고정 값: default

inputobject필수

flux-3-video 및 루트 default의 비즈니스 파라미터 객체. 아래 파라미터 표를 참조하세요.

draftboolean선택기본값: false

Generate a faster, lower-cost 720p preview instead of a full-quality clip.

imagesarray선택minItems 1maxItems 10

Optional PNG, JPEG, or WebP images. One image sets the opening frame, two set opening and closing frames, and 3-10 images form an evenly timed storyboard. Cannot be combined with start_video.

Array [ string ]

promptstring필수minLength 1maxLength 4700

Describe the scene, action, camera movement, dialogue, and sound. The prompt is interpreted and expanded before generation.

durationinteger선택기본값: 5min 5max 20

Generated clip duration in seconds. HiAPI uses an explicit 5-20 second duration for deterministic billing.

resolutionstring선택기본값: "720p"

Output resolution. Draft generation is available at 720p only.

옵션:720p1080p

start_videostring선택

Optional MP4 to continue from its final frames. Maximum 50 MB and 15 seconds. Cannot be combined with images.

aspect_ratiostring선택기본값: "auto"

Output aspect ratio. Auto selects a ratio from the prompt and media inputs.

옵션:auto21:92:116:94:31:13:49:16

generate_audioboolean선택기본값: true

Generate synchronized ambient sound, dialogue, and effects. Disable for a silent clip.

callbackobject선택

종료 상태 알림 설정. 생략하면 콜백이 전송되지 않으며 호출 측에서 폴링합니다.

콜백(Webhook)

생성 시 callback.url을 지정하면 태스크 종료 시 HiAPI가 서비스로 POST하여 폴링이 필요 없습니다. 콜백 본문은 태스크 상세와 동일한 구조입니다. 서명 검증·재시도·멱등에 대한 자세한 내용은 통합 비동기 API 소개 페이지의 콜백 설명을 참고하세요.

urlstring필수

callback 사용 시 필수. 태스크 종료 후 이 URL로 POST됩니다. 유효한 http(s) URL이어야 합니다.

whenstring선택기본값: "final"

현재는 final만 지원(success / fail 모두 알림).

옵션:final

storagestring선택기본값: "temp"

산출물 저장 등급: temp(기본·약 7일) 또는 persistent(장기 보관·용량 과금). 잔액 부족이나 저장 한도 초과 시 자동으로 temp로 강등됩니다. 실제 적용된 등급은 태스크 상세 응답에서 확인할 수 있습니다.

옵션:temppersistent

요청 예시

# 비동기 태스크 제출. 성공 시 즉시 taskId 반환(생성 완료 대기 없음)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "flux-3-video",
  "input": {
    "draft": false,
    "prompt": "…",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "auto",
    "generate_audio": true
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "flux-3-video",
    input: {
      "draft": false,
      "prompt": "…",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "auto",
      "generate_audio": true
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "flux-3-video",
        "input": {
          "draft": False,
          "prompt": "…",
          "duration": 5,
          "resolution": "720p",
          "aspect_ratio": "auto",
          "generate_audio": True
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

작업 상세 조회

GET https://api.hiapi.ai/v1/tasks/:id

응답 필드

taskIdstring필수

태스크 ID. 접두사는 항상 tk-hiapi-.

modelstring필수

확인된 전체 모델명. route 파라미터로 제출한 태스크는 base@route(예: gpt-image-2/text-to-image@ext)를 반환하며, 그 외에는 제출 시의 모델명과 동일합니다.

routestring선택

route 파라미터를 명시해 제출한 태스크에만 나타나며, 제출한 값을 그대로 반환합니다.

statusstring필수

태스크 상태.

상태 값

queued 대기 중, 아직 시작되지 않음. handling 처리 중. archiving 처리 완료, 산출물 준비 중. success 종료: 완료. 산출물 사용 가능(output 반환). fail 종료: 실패(error 반환). 제출 후 status로 판단합니다: success와 fail이 종료 상태이며 나머지는 비종료입니다. 1~3초 간격으로 종료까지 폴링하세요. 성공 시 output[].url에서 산출물을 다운로드하고 expireAt 전에 옮기세요. 장기 보관이 필요하면 생성 시 storage: "persistent"를 사용하세요.

creatednumber필수

태스크 생성 시각(Unix 초).

completednumber필수

종료 상태가 된 Unix 초. 비종료 상태에서는 0.

outputarray선택

status == success일 때만 나타납니다. 산출물 목록 — 항상 배열이며, 하나의 태스크에서 여러 type을 동시에 반환할 수 있습니다(예: video + first_frame).

Array [ object ]

배열 항목

urlstring필수

산출물 URL. 바로 다운로드할 수 있습니다.

typestring필수

현재 가능한 값: video, image, audio, first_frame, last_frame, thumbnail. 이후 확장될 수 있습니다.

expireAtnumber필수

산출물 접근 가능 기한(Unix 초). 만료 전에 다운로드하거나 이전하세요.

errorobject선택

status == fail일 때만 나타납니다.

codestring필수

비즈니스 오류 코드.

messagestring필수

오류 설명.

응답 예시

성공

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

처리 중(비종료)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

실패

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}