가이드

Flux Kontext API 인증 설정 가이드

작성일 2026.03.20 | 수정일 2026.03.20

Flux Kontext API 인증 설정 가이드

Flux Kontext는 Black Forest Labs(BFL)에서 개발한 AI 이미지 생성 모델입니다. 텍스트 프롬프트를 기반으로 고품질 이미지를 생성하거나 기존 이미지를 편집할 수 있습니다.

사전 준비

API 키 발급 방법

1. 계정 생성

  1. BFL API 웹사이트에 접속하여 계정을 생성합니다.

  2. 크레딧을 충전하여 API를 사용할 수 있습니다.

2. API 키 확인

  1. BFL 대시보드에 로그인합니다.

  2. 계정 설정에서 API Key를 확인합니다.

워크플로우 인증 정보 입력

필드

설명

예시

API Key

BFL API 키

대시보드에서 확인한 API Key

API Endpoint

API 엔드포인트 리전 선택

아래 옵션 참고

API Endpoint 옵션

옵션

엔드포인트 URL

설명

Global

https://api.bfl.ai

글로벌 (기본값)

EU

https://api.eu.bfl.ai

유럽 리전

US

https://api.us.bfl.ai

미국 리전

지연 시간을 최소화하려면 사용자 위치에 가까운 리전을 선택하세요. 한국에서는 Global 엔드포인트를 권장합니다.

지원 모델

  • Flux Pro — 고품질 이미지 생성

  • Flux Kontext — 컨텍스트 기반 이미지 편집 및 생성

시스템 증명서 사용

워크플로우에서는 시스템 증명서를 통해 별도의 BFL API 키 없이도 Flux Kontext 노드를 사용할 수 있습니다.

동작 방식

  1. 워크플로우 노드에서 인증 정보를 선택할 때, 사용자 본인의 인증 정보가 먼저 검색됩니다.

  2. 사용자 인증 정보가 없으면 시스템 증명서로 자동 fallback됩니다.

  3. 시스템 증명서를 사용한 경우, 사용량에 따라 비용이 자동 정산됩니다.

Flux Kontext는 이미지 생성 건수 기반 과금 체계를 사용합니다. 시스템 증명서 사용 시 비용은 플랫폼 정책에 따라 정산됩니다.

참고 링크