flux-pro-1-0-fill-finetuned의 기술 사양
flux-pro-1-0-fill-finetuned는 Black Forest Labs의 FLUX.1 Fill [pro] 파인튜닝 이미지 편집 엔드포인트에 대한 CometAPI의 플랫폼 식별자입니다. 인페인팅 워크플로를 위해 설계되었으며, 입력 이미지와 별도의 마스크 또는 알파 마스크를 제공하면 모델이 텍스트 프롬프트에 따라 지정된 영역만 편집합니다.
모델 개요
- Model ID:
flux-pro-1-0-fill-finetuned - Provider / underlying model family: Black Forest Labs FLUX.1 Fill [pro] 파인튜닝.
- Primary modality: 이미지-투-이미지, 이미지 편집, 마스크 기반 인페인팅.
- Commercial use: CometAPI에 상업적 이용 가능으로 표기. (cometapi.com)
- CometAPI pricing: 크롤 시점 기준 CometAPI 모델 페이지에서 요청당 $0.096. (cometapi.com)
문서화된 요청 입력
finetune_id: 적용할 파인튜닝 모델의 필수 ID.image: 필수 base64 인코딩된 소스 이미지.mask: 선택적 base64 인코딩된 흑백 마스크; 원본 이미지에 이미 알파 마스크가 있으면 생략 가능.prompt: 원하는 편집을 설명하는 텍스트 지시문.finetune_strength: 기본값 1.1, 허용 범위 0~2.0.steps: 기본값 50, 허용 범위 15~50.guidance: 기본값 60, 허용 범위 1.5~100.prompt_upsampling: 보다 창의적인 프롬프트 재작성을 위한 선택적 불리언.seed: 재현성을 위한 선택적 정수.output_format:jpeg또는png, 기본값jpeg.safety_tolerance: 0~6의 정수, 기본값 2.- 비동기 전달 지원:
webhook_url및webhook_secret지원.
문서화된 응답 필드
id: 생성 작업 ID.polling_url: 작업 상태 확인용 URL.cost,input_mp,output_mp: 사용량 및 이미지 크기 관련 메타데이터가 반환됨.
flux-pro-1-0-fill-finetuned란?
flux-pro-1-0-fill-finetuned는 개인화 인페인팅을 위한 특화된 FLUX 이미지 편집 모델 엔드포인트입니다. 실제로는 고급 FLUX.1 Fill [pro] 편집 워크플로와 사용자 학습 파인튜닝을 결합하여, 장면의 나머지 부분은 보존하면서 텍스트 프롬프트에 따라 기존 이미지의 선택 영역만 수정할 수 있습니다.
Black Forest Labs는 FLUX Pro 파인튜닝 시스템을 사용자의 예시 이미지를 활용해 FLUX.1 [pro]를 커스터마이즈하는 방법으로 설명하며, 특정 인물, 반려동물, 의류, 스티커, 브랜드, 시각적 스타일 등을 포함합니다. 또한 FLUX.1 Fill [pro]와 파인튜닝을 결합하면 주어진 이미지에 대해 반복적인 편집을 수행하는 개인화 인페인팅이 가능하다고 밝힙니다.
따라서 이미 파인튜닝된 FLUX Pro 컨셉 모델을 보유하고 있다면, 이 엔드포인트는 완전히 새로운 이미지를 처음부터 생성하는 대신 마스크된 영역 내부에 학습된 컨셉을 선택적으로 적용할 수 있는 편집 버전입니다. 이는 광고 소재 갱신, 제품 리터칭, 캐릭터 일관성 편집, 브랜드 자산 수정, 현지화 이미지 업데이트 등에 특히 유용합니다. 이는 엔드포인트 동작과 Black Forest Labs의 파인튜닝 설명에 근거한 추론입니다.
flux-pro-1-0-fill-finetuned의 주요 기능
- 개인화 인페인팅: 파인튜닝된 컨셉 모델을 활용해 기존 이미지의 마스크된 부분만 편집하면서, 사용자 지정 피사체나 스타일과의 정합성을 유지합니다.
- 파인튜닝 인지형 편집:
finetune_id가 필요하며, 이는 이미지 수정 시 미리 학습된 FLUX Pro 파인튜닝을 적용하도록 설계되었음을 의미합니다. - 마스크 기반 제어: 별도 마스크와 알파 마스크 워크플로 모두 지원하여, 정밀한 객체 교체, 정리, 향상 또는 영역별 재설계에 실용적입니다.
- 프롬프트 기반 변환: 선택 영역 내부에서 원하는 변경을 자연어 프롬프트로 기술해 수동 합성 없이 유연한 시각적 편집이 가능합니다.
- 조절 가능한 스타일 영향력:
finetune_strength로 파인튜닝된 컨셉의 영향력을 미세하게 제어해, 미묘한 반영부터 강한 개인화까지 조정할 수 있습니다. - 품질 및 창의성 제어:
steps,guidance,prompt_upsampling등의 파라미터로 충실도, 프롬프트 준수도, 창의적 변주를 제어할 수 있습니다. - 재현 가능한 출력: 선택적
seed지원으로 반복 테스트와 버전 간 통제된 반복 작업에 유리합니다. - 운영 환경 친화적 비동기 워크플로: 작업 ID와 폴링 URL을 반환하고, 웹훅도 지원하여 자동화 파이프라인에 적합합니다.
- 상용 배포 경로: CometAPI에서 상업적 이용 가능 모델로 표기되어 있습니다. (cometapi.com)
flux-pro-1-0-fill-finetuned에 액세스하고 통합하는 방법
Step 1: API 키 가입 및 발급
CometAPI에 가입한 후 대시보드에서 API 키를 생성합니다. 키를 확보하면 flux-pro-1-0-fill-finetuned API에 대한 요청을 인증해 애플리케이션에 모델을 통합할 수 있습니다. CometAPI는 통합을 간소화할 수 있는 샘플 코드와 API 리소스를 함께 제공합니다. (cometapi.com)
Step 2: flux-pro-1-0-fill-finetuned API로 요청 보내기
선호하는 HTTP 클라이언트나 SDK를 사용해 flux-pro-1-0-fill-finetuned API로 요청을 전송합니다. API 키, 모델 ID flux-pro-1-0-fill-finetuned, 그리고 사용 사례에 필요한 요청 페이로드를 포함합니다. 일반적으로 소스 이미지, 마스크 또는 알파 마스크, 프롬프트, 그리고 인페인팅 중에 학습된 컨셉을 적용할 수 있도록 finetune_id를 제공합니다. Black Forest Labs는 이 엔드포인트를 POST /v1/flux-pro-1.0-fill-finetuned로 문서화했으며, finetune_strength, steps, guidance, output_format, 선택적 웹훅 설정 등의 구성 가능한 파라미터를 제공합니다.
Step 3: 결과 가져오기 및 검증
API가 반환하는 응답 메타데이터를 사용해 생성 결과를 가져옵니다. flux-pro-1-0-fill-finetuned의 문서화된 응답에는 작업 id와 polling_url, 그리고 cost, input_mp, output_mp와 같은 사용량 관련 필드가 포함됩니다. 편집된 출력이 의도한 마스크 영역과 일치하는지, 주변 컨텍스트를 보존하는지, 파인튜닝된 컨셉이 일관되게 반영되는지 확인한 후 프로덕션 워크플로에 반영하십시오.