FLUX 3 Video
FLUX 3 비디오 생성
- 비동기 처리 모드, 후속 조회를 위한 작업 ID 반환
- 통합 진입점: 텍스트-비디오 / 이미지-비디오 / 비디오 이어쓰기 / 드래프트 2단계
- 출력 H.264 + AAC, 동기 오디오 포함, 길이 5~20초
- 해상도 hd / fhd, 7가지 종횡비
POST
인증
string
필수
생성 모드
flux-3-video는 통합 진입점입니다. 필드로 모드를 추론하거나 mode로 명시할 수 있습니다.
mode 값: t2v / i2v / v2v / draft_enhance, 또는 공식 표기 text-to-video / image-continuation / video-continuation. 명시 mode가 최우선입니다.
이미지-비디오 키프레임 의미
image_urls의 순서가 의미입니다 — 정렬하거나 중복 제거하지 마세요:
요청 매개변수
string
필수
고정 값:
flux-3-videostring
필수
프롬프트.
draft_from_task_id 사용 시 전송 금지 (전송 시 거부됨).integer
기본값:"5"
길이(초), 정수 5~20, 기본값
5비디오 이어쓰기 시 실제 출력이 요청 초보다 짧을 수 있습니다(예: 5초 요청 → 4초). 요청 초로 선차감 후 완료 시 차액을 환불합니다. 최종 금액은 조회의
cost 기준입니다. 텍스트/이미지-비디오에서는 이 차이가 없습니다.string
기본값:"hd"
해상도
hd(기본값,720p도 허용)fhd(1080p도 허용)
hd는 16:9에서 약 1280×704, fhd는 약 1920×1088.string
기본값:"auto"
종횡비옵션:
21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16, 또는 auto (기본값, 프롬프트와 소재로 자동 선택)string[]
이미지-비디오 키프레임, 1~10, 공개 http(s) URL 또는 base64
string
이어쓰기용 입력 비디오 (mp4, 공개 URL 또는 base64)
string[]
video_url과 동일, 첫 번째 항목 사용 (호환)boolean
기본값:"true"
동기 오디오 생성, 기본값
true. false는 무음 비디오 (할인 없음)boolean
기본값:"false"
드래프트 모드: 약 1/3 가격 저품질 미리보기,
resolution: hd만string
드래프트 → 최종: 본인의 성공한 드래프트 작업 ID
resolution만 변경 가능, 프롬프트·길이·이미지·비디오는 변경 불가- 최종본 정가 과금, 드래프트 비용은 상쇄되지 않음
draft:true와 상호 배타
integer
기본값:"2"
모더레이션 허용도 0~4, 기본값
2 (클수록 관대)FLUX.2 이미지(05) 또는 Kontext(06)와 혼동하지 마세요.
string
명시 모드(선택), 생성 모드 참조
드래프트 모드
반복 비용이 클 때의 2단계 워크플로:드래프트 생성
드래프트에서 최종본
요청 예시
텍스트-비디오 (세로)
이미지-비디오 (시작 + 끝 프레임)
비디오 이어쓰기
무음 비디오
제약
흔한 제출 오류 (보통 미과금)
모더레이션 실패는
failed로 종료되며 전액 환불됩니다.
기능 커버리지
Response
integer
상태 코드, 성공 시 200
array
응답 데이터 배열
결과 조회비디오 생성은 비동기입니다. 작업 상태 조회로 폴링하세요.권장 간격 5~10초, 클라이언트 타임아웃 15분 (20초 fhd는 더 느림). 실측
t2v + hd + 5초 약 60초.성공 시 result.videos[0].url 사용. 결과물은 플랫폼 CDN에 미러됩니다. cost가 최종 청구액입니다. 실패 시 전액 환불.