Skip to main content
POST

인증

string
필수
모든 엔드포인트는 Bearer Token 인증이 필요합니다API Key 관리 페이지에서 API Key를 받으세요:

생성 모드

flux-3-video통합 진입점입니다. 필드로 모드를 추론하거나 mode로 명시할 수 있습니다. mode 값: t2v / i2v / v2v / draft_enhance, 또는 공식 표기 text-to-video / image-continuation / video-continuation. 명시 mode가 최우선입니다.

이미지-비디오 키프레임 의미

image_urls의 순서가 의미입니다 — 정렬하거나 중복 제거하지 마세요:

요청 매개변수

string
필수
고정 값: flux-3-video
string
필수
프롬프트. draft_from_task_id 사용 시 전송 금지 (전송 시 거부됨).
integer
기본값:"5"
길이(초), 정수 5~20, 기본값 5
duration: "auto"는 미지원입니다(과금에 고정 초 필요). 생략, "auto", 비정수 → 오류 없이 5초로 처리하며 자동 적응하지 않습니다.
비디오 이어쓰기 시 실제 출력이 요청 초보다 짧을 수 있습니다(예: 5초 요청 → 4초). 요청 초로 선차감 후 완료 시 차액을 환불합니다. 최종 금액은 조회의 cost 기준입니다. 텍스트/이미지-비디오에서는 이 차이가 없습니다.
string
기본값:"hd"
해상도
  • hd (기본값, 720p도 허용)
  • fhd (1080p도 허용)
실측: hd는 16:9에서 약 1280×704, fhd는 약 1920×1088.
드래프트 모드(draft:true)는 hd 허용.
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가 최종 청구액입니다. 실패 시 전액 환불.