FLUX.3는 Black Forest Labs의 프런티어 비디오 모델입니다. 이 엔드포인트는 한 장의 스틸 이미지를 720p 또는 1080p, 5~20초의 자연스러운 움직임으로 애니메이션화하며, 영상과 함께 동기화된 오디오를 생성하고 세이프티 허용 수준을 조절할 수 있습니다.
콘솔의 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": "blackforestlabs/flux-3/image-to-video",
"input": {
"prompt": "A red panda walks along a mossy log in a sunlit forest, one continuous unbroken shot. Ambient birdsong and rustling leaves.",
"image_url": "https://storage.googleapis.com/falserverless/example_inputs/veo31_i2v_input.jpg",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "auto",
"generate_audio": true
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
prompt | string | Yes | - | 생성하고자 하는 영상을 서술하는 텍스트 프롬프트입니다. |
image_url | string | Yes | - | 영상이 시작될 이미지의 URL입니다 (PNG, JPEG, WebP). |
duration | integer | Yes | 5 | 생성될 영상의 길이(초, 5~20)입니다. 필수 항목입니다 — 업스트림은 "auto"도 허용하지만 요청 시점에 결과 길이를 알 수 없어 정확한 과금이 불가능하므로, 본 게이트웨이에서는 명시적인 길이를 요구합니다. |
resolution | string | No | 720p | 생성될 영상의 해상도입니다. 720p1080p |
aspect_ratio | string | No | auto | 생성될 영상의 화면비입니다. 'auto'로 두면 모델이 선택합니다. auto21:92:116:94:31:13:49:16 |
generate_audio | boolean | No | true | 영상에 대한 오디오를 생성할지 여부입니다. |
safety_tolerance | integer | No | 2 | 생성 영상에 적용할 세이프티 허용 수준입니다. 0이 가장 엄격하고 4가 가장 관대합니다. |
이 모델의 image_url 파라미터에 파일을 전달하는 방법은 3가지입니다.
공개 접근 가능한 URL을 직접 전달합니다. Storage API(POST /v1/files/upload-url)로 업로드하면 파일이 S3로 직접 올라가고(파일당 50MB), 반환된 file_url을 그대로 쓰면 됩니다.
{
"model": "blackforestlabs/flux-3/image-to-video",
"input": {
"prompt": "your prompt here",
"image_url": "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=blackforestlabs/flux-3/image-to-video" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:image_url=@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로도 제공 |
사진 한 장을 끊김 없는 5초 720p 원테이크로 애니메이션화하고, 앰비언스 사운드를 함께 생성합니다.
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "blackforestlabs/flux-3/image-to-video",
"input": {
"prompt": "A red panda walks along a mossy log in a sunlit forest, one continuous unbroken shot. Ambient birdsong and rustling leaves.",
"image_url": "https://storage.googleapis.com/falserverless/example_inputs/veo31_i2v_input.jpg",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "auto",
"generate_audio": true
}
}'720p에서 모션을 검증한 뒤, 최종 컷을 16:9 프레임의 1080p로 렌더링합니다.
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "blackforestlabs/flux-3/image-to-video",
"input": {
"prompt": "Slow dolly-in on a ceramic coffee cup as steam rises, morning light through a window, shallow depth of field.",
"image_url": "https://example.com/product-still.jpg",
"duration": 8,
"resolution": "1080p",
"aspect_ratio": "16:9",
"generate_audio": true
}
}'