Black Forest Labs의 멀티모달 모델 FLUX 3는 텍스트 프롬프트, 하나 이상의 이미지(첫 프레임, 첫+마지막 프레임, 최대 10장의 스토리보드), 또는 기존 클립 이어가기로 동기화된 오디오가 포함된 5~20초 비디오를 생성합니다. 720p·1080p와 저비용 드래프트 모드를 지원합니다.
콘솔의 Playground에서 별도 코드 없이 이 모델을 즉시 테스트할 수 있어요
이 모델의 사용법을 Claude, ChatGPT 등에 복사
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "black-forest-labs/flux-3",
"input": {
"prompt": "a home video of a futuristic san francisco with people riding hoverboards",
"images": [],
"duration": "5",
"resolution": "720p",
"aspect_ratio": "auto",
"generate_audio": true,
"draft": false,
"safety_tolerance": 2
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
prompt | string | Yes | - | 생성할 비디오 설명. 장면·동작·카메라 움직임·원하는 오디오를 묘사 — 생성 전에 프롬프트가 해석·확장됨 |
images | array | No | [] | 선택 입력 이미지 (픽셀 그대로 배치): 1장 = 첫 프레임, 2장 = 첫·마지막 프레임, 3~10장 = 스토리보드(길이 지정 필요). PNG, JPEG, WebP. start_video와 함께 사용 불가 |
start_video | string | No | - | 마지막 프레임부터 이어서 생성할 영상 (mp4, 50MB·15초 이하). 영상 이어가기 요율로 과금. images와 함께 사용 불가 |
aspect_ratio | string | No | auto | 생성 비디오 화면 비율. 'auto'는 프롬프트와 입력에 맞춰 비율을 선택 auto21:92:116:94:31:13:49:16 |
resolution | string | No | 720p | 출력 해상도. 드래프트 모드에서는 무시됨 (드래프트는 720p) 720p1080p |
duration | string | No | 5 | 클립 길이 초 ("5"~"20"). 생략 시 "5". 'auto'는 모델이 5~20초 중 선택하며 실제 출력 길이로 과금됨(요청 시 20초분 예약) auto567891011121314151617181920 |
generate_audio | boolean | No | true | 동기화된 오디오(주변음, 음성, 효과음) 생성. 무음 클립이 필요하면 false |
draft | boolean | No | false | 최종 품질 대신 빠르고 저렴한 720p 드래프트 미리보기 생성 |
safety_tolerance | integer | No | 2 | 모더레이션 허용 수준, 0(가장 엄격)~4(가장 관대). 이미지·영상 입력이 있으면 최대 2 |
이 모델의 imagesstart_video 파라미터에 파일을 전달하는 방법은 3가지입니다.
공개 접근 가능한 URL을 직접 전달합니다. Storage API(POST /v1/files/upload-url)로 업로드하면 파일이 S3로 직접 올라가고(파일당 50MB), 반환된 file_url을 그대로 쓰면 됩니다.
{
"model": "black-forest-labs/flux-3",
"input": {
"prompt": "your prompt here",
"images": ["https://example.com/image.jpg"]
}
}POST /v1/predictions/upload에 파일을 직접 첨부합니다. 별도 업로드 과정이 없는 대신, 파일이 API 서버를 거치므로 요청 전체 10MB 제한이 적용됩니다.
curl -X POST "https://api.core.today/v1/predictions/upload" \
-H "X-API-Key: cdt_your_api_key" \
-F "model=black-forest-labs/flux-3" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:images=@your_file.png"POST /v1/predictions 요청 시 사용되는 공통 파라미터입니다.
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | Yes | - | 모델 식별자 |
input | object | Yes | - | 위 테이블의 모델별 파라미터를 포함하는 객체 |
output_folder | string | No | - | 결과물 저장 폴더 경로 (최대 256자, '..' 사용 불가) |
webhook_url | string | No | - | 완료 시 호출할 Webhook URL |
is_public | boolean | No | false | true 시 결과물을 영구 공개 URL로도 제공 |
오디오가 포함된 720p 5초 클립 — 5초 x 395/초 = 1,980 크레딧
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "black-forest-labs/flux-3",
"input": {
"prompt": "a home video of a futuristic san francisco with people riding hoverboards",
"images": [],
"duration": "5",
"resolution": "720p",
"aspect_ratio": "auto",
"generate_audio": true,
"draft": false,
"safety_tolerance": 2
}
}'아이디어 확인용 빠른 720p 드래프트 — 8초 x 140/초
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "black-forest-labs/flux-3",
"input": {
"prompt": "A red panda walks along a mossy log in a sunlit forest, one continuous shot, birdsong",
"duration": "8",
"draft": true
}
}'