flux-pro-1.0-depth API

flux-pro-1-0-depth의 기술 사양

flux-pro-1-0-depth란?

flux-pro-1-0-depth는 Black Forest Labs의 FLUX Pro 1.0 Depth 모델에 대한 CometAPI의 플랫폼 식별자입니다. 이 모델은 프롬프트 기반 변환을 적용하면서 장면의 3D 구조를 보존하도록 설계된 깊이 인식 기반 이미지 생성 및 편집 모델입니다. 이미지를 평면 픽셀로만 보지 않고, 깊이 가이던스를 통해 원근, 객체 배치, 상대적 스케일을 보다 잘 준수하도록 편집을 제어합니다.

이 때문에 기존 이미지를 공간적 일관성을 잃지 않고 리스타일링하거나 수정하고자 할 때 특히 유용합니다. FLUX.1 Depth에 대한 공개 설명에서 Black Forest Labs와 생태계 문서는 건축 장면, 제품 시각화, 구조 보존 스타일 전이, 사실적인 기하 유지가 중요한 편집 등의 사용 사례를 강조합니다.

또한 이 모델 이름을 사용하는 Black Forest Labs의 원래 엔드포인트는 2025년 10월 31일부로 사용 중단되었음을 유의하십시오. 이는 여기에서 사용해야 할 CometAPI 모델 코드에는 영향을 주지 않지만, 장기적 호환성과 마이그레이션 계획을 평가하는 개발자에게는 관련 있는 맥락입니다.

flux-pro-1-0-depth의 주요 특징

• 깊이 인식 제어: 깊이 가이던스를 활용해 생성된 편집이 장면의 기하와 원근에 보다 자연스럽게 맞춰지도록 설계되었습니다.
• 공간 관계 보존: 객체 간 3D 관계를 유지하도록 설계되어, 변환 이후에도 합성 결과의 현실감을 유지하는 데 도움이 됩니다.
• 구조 보존형 이미지 변환: FLUX 깊이 워크플로는 레이아웃을 유지하면서 재질 변경, 제어된 리스타일링, 구조화된 입력을 더 풍부한 비주얼로 변환하는 데 유용한 것으로 설명됩니다.
• 시각화 워크플로에 강점: 공개 문서는 건축 시각화, 제품 배치, 정확한 장면 구성 등을 핵심 강점으로 강조합니다.
• 단순 프롬프트 기반 생성보다 높은 창의적 제어: 텍스트 지시뿐 아니라 이미지 구조를 따를 수 있으므로 일관성과 제어 가능성이 중요한 편집에 더 적합합니다. 이는 모델의 문서화된 깊이 가이던스 설계와 명시된 사용 사례에 근거한 추론입니다.
• 전문급 FLUX 생태계 통합: 고급 이미지 생성 및 편집 워크플로를 위한 FLUX Pro 도구 모음에 속합니다.
• 상위 엔드포인트 사용 중단 상태: Black Forest Labs는 원래의 flux-pro-1.0-depth 엔드포인트가 2025년 10월 31일부로 사용 중단되었음을 공지하고 있습니다.

flux-pro-1-0-depth에 접근하고 통합하는 방법

1단계: API 키 등록

시작하려면 CometAPI에 가입하고 대시보드에서 API 키를 발급하세요. 이 키는 flux-pro-1-0-depth API로의 모든 요청을 인증하는 데 사용됩니다.

2단계: flux-pro-1-0-depth API로 요청 보내기

CometAPI의 Flux 호환 엔드포인트 POST /flux/v1/{model}을 사용하세요.

curl https://api.cometapi.com/flux/v1/flux-pro-1-0-depth \
  -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}를 폴링하세요.