Black Forest Labs의 최고 충실도 이미지 모델입니다. FLUX.2 라인업 중 최고의 프롬프트 준수율과 가장 일관된 편집 성능을 제공하며, 최대 8장의 레퍼런스 이미지로 색상·조명·얼굴·텍스트·오브젝트를 편집 간에 보존합니다.
콘솔의 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-2-max",
"input": {
"prompt": "A photorealistic wide shot of a minimalist digital billboard in a forest of purple and lavender-hued trees. Centered text reads \"FLUX.2 [max]\" in a modern sans-serif font. Soft daylight with a purple color cast, cinematic composition",
"resolution": "1 MP",
"aspect_ratio": "1:1"
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
prompt | string | Yes | - | 이미지 생성용 텍스트 프롬프트 |
input_images | array | No | [] | 이미지-이미지 생성용 레퍼런스 이미지 최대 8장 (jpeg/png/gif/webp) |
aspect_ratio | string | No | 1:1 | 화면 비율. 'match_input_image'는 첫 입력 이미지를 따르고 'custom'은 width/height 사용 match_input_imagecustom1:116:93:22:34:55:49:163:44:3 |
resolution | string | No | 1 MP | 출력 해상도 (메가픽셀). 2 MP 이하 권장, 최대 2048x2048. 해상도에 따라 과금 차등 match_input_image0.5 MP1 MP2 MP4 MP |
width | integer | No | - | 가로 크기 (256~2048, 16의 배수). aspect_ratio=custom일 때만 사용 |
height | integer | No | - | 세로 크기 (256~2048, 16의 배수). aspect_ratio=custom일 때만 사용 |
safety_tolerance | integer | No | 2 | 안전 필터 강도: 1이 가장 엄격, 5가 가장 관대 |
seed | integer | No | - | 재현 가능한 생성을 위한 랜덤 시드 |
output_format | string | No | webp | 출력 이미지 포맷 webpjpgpng |
output_quality | integer | No | 80 | 저장 품질 0~100 (png에는 미적용) |
이 모델의 input_images 파라미터에 파일을 전달하는 방법은 3가지입니다.
POST /v1/predictions/upload에 파일을 직접 첨부합니다. 별도 업로드 과정이 필요 없습니다.
curl -X POST "https://api.core.today/v1/predictions/upload" \
-H "X-API-Key: cdt_your_api_key" \
-F "model=black-forest-labs/flux-2-max" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:input_images=@your_file.png"공개 접근 가능한 URL을 직접 전달합니다. Storage API로 업로드한 파일의 file_url도 사용 가능합니다.
{
"model": "black-forest-labs/flux-2-max",
"input": {
"prompt": "your prompt here",
"input_images": ["https://example.com/image.jpg"]
}
}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로도 제공 |
이미지 내 텍스트가 정확히 렌더링되는 복잡한 장면
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-2-max",
"input": {
"prompt": "A photorealistic wide shot of a minimalist digital billboard in a forest of purple and lavender-hued trees. Centered text reads \"FLUX.2 [max]\" in a modern sans-serif font. Soft daylight with a purple color cast, cinematic composition",
"resolution": "1 MP",
"aspect_ratio": "1:1"
}
}'새로운 환경에서도 일관된 제품 목업
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-2-max",
"input": {
"prompt": "Place the product from the reference image on a marble kitchen counter with soft morning light, keeping the label text and colors exactly as shown",
"input_images": [
"https://example.com/product.jpg"
],
"resolution": "2 MP",
"aspect_ratio": "4:5"
}
}'