flux-pro-1-0-canny-finetuned의 기술 사양
| Specification | Details |
|---|---|
| Model ID | flux-pro-1-0-canny-finetuned |
| Model family | FLUX.1 [pro] |
| Modality | 구조적 가이던스를 활용한 이미지-투-이미지 생성 |
| Control type | Canny 엣지 컨디셔닝 |
| Custom adaptation | 학습된 finetune_id가 필요한 파인튜닝 변형 |
| Core inputs | 프롬프트, 제어/소스 이미지, 파인튜닝 구성 |
| Fine-tune controls | finetune_id 지원; 관련 FLUX.1 [pro] 파인튜닝 엔드포인트는 적응 영향도를 제어하는 finetune_strength도 제공 |
| Primary use cases | 스타일 제어 생성, 구조 보존 편집, 브랜드 비주얼 적응, 가이드된 크리에이티브 변환 |
| Provider ecosystem | Black Forest Labs FLUX.1 [pro] API를 기반으로 하며 서드파티 추론 플랫폼을 통해 배포 |
| Lifecycle status | Black Forest Labs는 2025년 10월 31일부로 flux-pro-1.0-canny-finetuned를 파인튜닝 관련 엔드포인트 중 사용 중단 대상으로 목록화 |
flux-pro-1-0-canny-finetuned란 무엇인가?
flux-pro-1-0-canny-finetuned는 Canny 엣지 제어와 맞춤 파인튜닝을 결합한 FLUX.1 [pro] 기반 이미지 생성 모델에 대해 CometAPI가 사용하는 플랫폼 식별자입니다. 실제로 이는 입력 이미지에서 추출한 구조적 윤곽을 따르면서도 학습된 파인튜닝을 적용해, 출력이 특정 피사체, 비주얼 아이덴티티, 혹은 스타일 영역에 더 잘 부합하도록 만듭니다.
"canny" 부분은 엣지 기반 컨디셔닝을 의미합니다. 모델이 텍스트만으로 이미지를 생성하는 대신, 참조 이미지의 엣지 정보를 사용해 구도, 레이아웃, 객체 경계를 보존합니다. 이는 포즈, 실루엣, 장면 기하, 그래픽 구조 등에서 프롬프트만으로는 얻기 어려운 더 강력한 제어가 필요할 때 유용합니다.
"finetuned" 부분은 추론이 일반적으로 finetune_id로 참조되는 맞춤 학습 파인튜닝에 연계됨을 나타냅니다. 이를 통해 팀은 기본 FLUX.1 [pro] 모델을 특정 브랜드 룩, 제품 스타일, 캐릭터 아이덴티티, 반복되는 아트 디렉션에 맞게 조정하면서도 컨트롤 이미지 가이던스의 이점을 유지할 수 있습니다.
Black Forest Labs의 2025년 10월 31일자 사용 중단 공지에 따르면, flux-pro-1.0-canny-finetuned는 중단된 파인튜닝 관련 엔드포인트 중 하나로 포함되어 있습니다. CometAPI를 통해 이를 통합하는 경우, 가용성은 원본 업스트림 엔드포인트만이 아니라 CometAPI의 라우팅 및 지원 레이어에 따라 달라질 수 있습니다.
flux-pro-1-0-canny-finetuned의 주요 기능
- Canny 엣지 가이던스: 입력 이미지의 엣지 맵 또는 엣지에서 도출된 구조를 사용해, 프롬프트만으로 생성할 때보다 구도와 윤곽을 더 일관되게 유지합니다.
- 맞춤 파인튜닝 지원: 학습된
finetune_id와 함께 작동하도록 설계되어, 출력이 맞춤 비주얼 도메인, 브랜드 스타일, 특정 피사체에 정렬되도록 합니다. - 구조 보존형 이미지 변환: 원본 레이아웃을 유지하면서 텍스처, 스타일링, 분위기, 렌더링 품질 등을 변경하고자 하는 워크플로에 적합합니다.
- 상위급 FLUX.1 [pro] 품질 기반: Black Forest Labs 생태계에서 고품질 이미지 모델 계열로 포지셔닝된 FLUX.1 [pro] 생성 스택을 계승합니다.
- 프로덕션 파이프라인을 위한 크리에이티브 컨트롤: 컨셉 아트, 마케팅 애셋 변형, 제품 시각화, 반복 가능한 비주얼 생성 등에서 스타일 일관성과 공간 제어가 모두 중요한 경우에 유용합니다. 이는 모델의 컨트롤 이미지 및 파인튜닝 설계를 바탕으로 한 설명입니다.
- 파인튜닝 강도-스타일 균형 조절: 관련 FLUX.1 [pro] 파인튜닝 엔드포인트는 파인튜닝이 최종 이미지에 미치는 정도를 조절할 수 있어, 기본 구조 준수와 맞춤 스타일 영향 사이의 균형을 설정하는 데 도움이 됩니다.
- 사용 중단을 고려한 통합 유의사항: 업스트림 파인튜닝 API와
flux-pro-1.0-canny-finetuned가 사용 중단된 만큼, 프로덕션 도입 전에 현재 지원 상태, 레이턴시, 폴백 동작을 검증해야 합니다.
flux-pro-1-0-canny-finetuned에 접근하고 통합하는 방법
1단계: API 키 등록
CometAPI에 가입하고 대시보드에서 API 키를 생성합니다. 키는 서버의 환경 변수에 안전하게 보관하세요. 프로덕션 API 키를 클라이언트 앱이나 공개 저장소에 노출하지 마세요.
2단계: flux-pro-1-0-canny-finetuned API로 요청 보내기
CometAPI의 OpenAI 호환 API 형식을 사용하고, model 필드를 flux-pro-1-0-canny-finetuned로 설정합니다.
curl https://api.cometapi.com/v1/responses \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $COMETAPI_API_KEY" \
-d '{
"model": "flux-pro-1-0-canny-finetuned",
"input": "Generate a refined image based on the provided canny-guided composition and prompt."
}'
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.COMETAPI_API_KEY,
baseURL: "https://api.cometapi.com/v1"
});
const response = await client.responses.create({
model: "flux-pro-1-0-canny-finetuned",
input: "Generate a refined image based on the provided canny-guided composition and prompt."
});
console.log(response);
3단계: 결과 수신 및 검증
API 응답을 읽고, 애플리케이션에 필요한 생성 결과, 에셋 URL, 구조화된 필드를 추출합니다. 프로덕션 환경에서는 응답 상태를 검증하고, 재시도 처리, 요청 ID 로깅, 반환 결과가 기대하는 형식과 품질 요건을 충족하는지 확인한 뒤 최종 사용자에게 노출하세요.