소개
FLUX 3 텍스트→비디오는 2026년 8월 4일에 API가 열린 Black Forest Labs의 비디오 모델입니다. 글로 쓴 프롬프트를 동기화된 사운드가 있는 5~20초 클립으로 바꾸며, 720p 또는 1080p로 일곱 가지 화면 모양을 지원하고, 가장 낮은 가격으로 장면을 확인하는 빠른 드래프트 등급이 있습니다.
가진 자료에 따라 모드를 고르세요
| 가진 것 | 모드 |
|---|---|
| 글로 쓴 기획 | FLUX 3 텍스트→비디오 |
| 움직이게 할 정지 이미지(선택 마지막 프레임) | FLUX 3 이미지→비디오 |
| 이어 갈 클립 | FLUX 3 비디오 확장 |
| 키울 클립 | FLUX 3 비디오 업스케일 |
핵심 기능 및 하이라이트
화면과 사운드를 함께
사운드는 화면과 같은 패스에서 생성됩니다. 따옴표 안의 대사는 저희 프롬프트와 글자 그대로 일치했고, Sound: 줄로 비나 발소리 같은 주변 소리를 조절합니다. 사운드를 꺼도 가격은 같습니다.
드래프트 등급
드래프트는 항상 720p인 빠르고 저렴한 미리보기입니다. 스탠더드보다 디테일은 부드럽지만, 본 렌더 전에 구도, 동작, 분위기를 판단하기에는 충분합니다.
초당 과금
가격은 길이와 등급을 따릅니다. draft가 가장 낮고, 그다음이 스탠더드 720p, 스탠더드 1080p입니다. 화면비와 사운드 설정은 가격에 영향을 주지 않으며, 거부되거나 실패한 요청에는 요금이 청구되지 않습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 최대 5,000자입니다. 피사체, 동작, 카메라, 빛, 소리를 설명하세요. 1자 이상 · 5000자 이하 |
aspect_ratio | 아니요 | 16:9(기본값), 9:16, 1:1, 4:3, 3:4, 21:9, 2:1 중 하나입니다. 모양은 가격에 영향을 주지 않습니다. |
quality | 아니요 | standard(기본값)는 선택한 해상도로 렌더하고, draft는 항상 720p ( |
resolution | 아니요 | 720p(기본값) 또는 1080p. 1080p가 더 비쌉니다. |
duration_seconds | 아니요 | 길이는 정수 초로 5~20, 기본값은 5입니다. 초당 과금되므로 등급과 함께 가격을 결정합니다. |
generate_audio | 아니요 | 화면과 동기화된 사운드를 생성합니다. 기본으로 켜져 있고, 끄면 무음 파일이 나옵니다. 기본값: |
요금
영상 1초당 과금되며 등급별로 draft가 가장 낮고, 그다음이 스탠더드 720p, 스탠더드 1080p입니다. 사운드를 켜든 끄든 가격은 같고 화면비는 가격에 영향을 주지 않습니다. 거부되거나 실패한 요청에는 요금이 청구되지 않습니다.
| 해상도 | 품질: 초안 | 품질: 표준 |
|---|---|---|
| $0.06 / 초 | $0.29 / 초 |
| $0.06 / 초 | $0.17 / 초 |
활용 사례
대사와 분위기 장면
인물 한 명, 대사 한 줄, 공간 소리, 천천히 움직이는 카메라입니다.
스토리보드
장면마다 드래프트로 미리 보고, 채택한 것만 다시 렌더하세요.
소셜 및 세로 클립
9:16과 1:1이 기본으로 들어 있고, 21:9와 2:1은 넓은 시네마틱 화면을 담당합니다.
프롬프트 가이드 및 실전 팁
샷을 쓰듯이 적으세요
피사체와 의상, 배경, 동작, 카메라 움직임, 빛 순으로 적고 마지막 줄은 Sound:로 시작하세요.
대사는 따옴표로
말하는 내용은 듣고 싶은 언어로 따옴표 안에 넣으세요.
클립마다 동작은 하나만
분명한 동작 하나와 카메라 움직임 하나가 가장 안정적입니다. 빛이나 장소가 크게 바뀌면 모델이 장면을 끊거나 디졸브할 수 있습니다.
드래프트부터
드래프트로 구도를 맞춘 뒤 같은 프롬프트를 스탠더드로 실행하세요.
콘텐츠 기대치를 조절하세요
렌더링되는 것은 약함 단계의 룩뿐이며, 그보다 강한 것은 거절되고 과금되지 않습니다.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "black-forest-labs/flux-3/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"quality": "standard",
"resolution": "720p",
"aspect_ratio": "16:9",
"duration_seconds": 5
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.


























