flux-pro-1-0-canny의 기술 사양
| 사양 | 세부 정보 |
|---|---|
| 모델 ID | flux-pro-1-0-canny |
| 모델 계열 | FLUX.1 Canny [pro] |
| 제공처 / 출처 | Black Forest Labs의 FLUX 계열로, Replicate 및 fal과 같은 서드파티 추론 플랫폼을 통해서도 제공됩니다. |
| 모달리티 | 이미지-투-이미지 / 텍스트 프롬프트와 Canny 에지 제어 이미지를 함께 사용하는 제어형 이미지 생성. |
| 핵심 제어 방식 | 구조 보존 가이던스를 위한 Canny 에지 검출. |
| 주요 사용 사례 | 스케치-투-이미지, 구도를 유지한 리텍스처링, 제어된 스타일 변환, 건축/레이아웃 제약이 있는 시각화. |
| 입력 유형 | 프롬프트 텍스트와 제어 이미지/에지 맵; 공개 배포에서 흔히 노출되는 런타임 매개변수로는 steps, guidance, seed, 출력 형식, 안전 관련 제어 등이 포함됩니다. |
| 출력 | 제공된 에지 맵의 구조를 따르는 생성된 이미지 파일. |
| 추론 패턴 | 일반적으로 FLUX 스타일 API에서 결과 폴링을 동반한 비동기 작업 제출 방식. |
flux-pro-1-0-canny란?
flux-pro-1-0-canny는 FLUX 생태계의 전문가 지향 에지 가이드형 이미지 생성 모델인 FLUX.1 Canny [pro]에 대해 CometAPI가 사용하는 플랫폼 식별자입니다. 이 모델의 핵심 역량은 Canny 에지 검출을 구조적 컨디셔닝 신호로 활용한다는 점으로, 자연어 프롬프트에 반응하면서도 입력 이미지의 구도와 윤곽을 따르는 새로운 이미지를 생성할 수 있습니다.
실무 관점에서 이 모델은 일반적인 텍스트-투-이미지 생성보다 더 많은 제어를 원하는 사용자를 위해 설계되었습니다. 모든 것을 글로만 설명하는 대신, 스케치나 추출된 에지 맵, 구도 레퍼런스를 제공하고 다른 스타일, 소재 처리, 장면 컨텍스트로 렌더링하도록 요청할 수 있습니다. 공개된 모델 설명에서는 변환 작업에서 레이아웃과 구조를 보존하는 데 특히 유용하다고 일관되게 평가합니다.
기저 FLUX API는 작업 제출과 폴링을 자주 사용하므로, 이러한 모델과의 통합은 대개 비동기 워크플로로 구성됩니다. 요청을 제출하고 작업 ID를 받은 뒤, 처리가 완료되면 결과를 가져오는 방식입니다.
flux-pro-1-0-canny의 주요 특징
- 에지 기반 구조 제어: 생성 과정에서 Canny 에지 맵을 활용해 원본 이미지의 구도, 윤곽, 주요 형태를 보존합니다.
- 프롬프트 기반 재스타일링: 에지로 제어된 입력과 텍스트 프롬프트를 결합해 원래 구조를 유지한 채 외형, 분위기, 소재, 예술적 스타일을 변경할 수 있습니다.
- 스케치-투-이미지 워크플로에 최적: 공개 사례와 설명에서 스케치나 에지 기반 가이드를 정제된 아트워크와 프로덕션 준비된 비주얼로 전환하는 데 강점을 보인다고 강조합니다.
- 구도 보존 리텍스처링: 레이아웃을 안정적으로 유지하면서 장면이나 객체의 텍스처를 교체하는 데 적합하여 제품, 컨셉, 환경 시각화 워크플로에서 유용합니다.
- 유용한 매개변수 제어: 공개 API에서는 확산 단계, 가이던스 강도, 시드, 출력 형식, 안전 허용치 등 추론 설정을 흔히 제공하여 재현성과 튜닝을 지원합니다.
- 프로덕션 친화적 API 동작: FLUX API 통합 가이드는 엔드포인트 기반 작업 제출과 결과 폴링을 강조하며, 백엔드 자동화와 애플리케이션 파이프라인에 잘 부합합니다.
flux-pro-1-0-canny에 접근하고 통합하는 방법
1단계: API 키 가입/발급
CometAPI에 가입하고 대시보드에서 API 키를 발급하세요. 키는 안전하게 보관하고, flux-pro-1-0-canny API에 요청하기 전에 애플리케이션에서 환경 변수로 로드하세요.
2단계: flux-pro-1-0-canny API로 요청 보내기
CometAPI의 Flux 호환 엔드포인트 POST /flux/v1/{model}를 사용하세요.
curl https://api.cometapi.com/flux/v1/flux-pro-1-0-canny \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $COMETAPI_API_KEY" \
-d '{
"prompt": "A breathtaking landscape painting with golden hour lighting",
"width": 1024,
"height": 768,
"steps": 20,
"prompt_upsampling": true
}'
3단계: 결과 조회 및 검증
API는 작업 ID를 반환합니다. 생성 상태를 확인하고 완료 시 출력 이미지를 가져오기 위해 GET /flux/v1/get_result?id={task_id}로 폴링하세요.