API 키 받기

Black Forest Labs

FLUX.1을 포즈·깊이·선화로 제어, 내 LoRA 사용

black-forest-labs/flux-1-dev-controlnet-lora/text-to-image6크레딧부터/장 · US$0.06
  • 최대 1.5K
  • 한 번에 최대 4장
  • 내 LoRA 불러오기
  • 이미지 만들기
Atelier night grayscale예시 보기

FLUX.1 Dev ControlNet LoRA 소개

FLUX.1 Dev ControlNet LoRA는 Black Forest Labs의 FLUX.1 [dev]를 Shakker Labs의 ControlNet Union Pro 2.0으로 이끌어 이미지를 만들며, FLUX.1 dev용으로 학습한 LoRA 파일을 최대 3개까지 불러옵니다. 제어 이미지 한 장(포즈 스켈레톤, 깊이 맵, canny나 soft-edge 선화, 또는 흑백 사진)이 구도를 고정하고, 나머지는 프롬프트가 정하며, 어떤 것도 필터링되지 않습니다.

POST /jobs/createTask에서 모델 이름을 black-forest-labs/flux-1-dev-controlnet-lora/text-to-image(으)로 지정하면 호출할 수 있습니다. 6크레딧/장부터(US$0.06). 새 계정에는 30크레딧이 지급되니 Playground에서 먼저 무료로 써 보세요.

이 가이드는 당분간 영어로만 제공됩니다. →

요청 파라미터

파라미터필수설명
control_guidance_end아니요Fraction of the denoising steps at which the control image stops applying, from 0 to 1; not before the start. ≥ 0 · ≤ 1 · 기본값: 0.8
control_guidance_start아니요Fraction of the denoising steps at which the control image starts to apply, from 0 to 1. ≥ 0 · ≤ 1 · 기본값: 0
control_image_url예Control image: a pose skeleton, depth map, canny or soft-edge line map, or a grayscale or plain photo. The result keeps its aspect ratio.
control_strength아니요How strongly the result follows the control image, from 0 to 1. ≥ 0 · ≤ 1 · 기본값: 0.7
guidance_scale아니요프롬프트를 얼마나 엄격히 따를지. ≥ 0 · ≤ 20 · 기본값: 3.5
loras아니요내 LoRA 파일을 불러와 스타일이나 캐릭터를 고정합니다. 기본값: []
num_outputs아니요한 번에 만들 결과 수. ≥ 1 · ≤ 4 · 기본값: 1
output_format아니요결과 파일 형식. jpeg · png · webp · 기본값: jpeg
prompt예Describe the picture you want: subject, clothing, setting and light. The control image only sets the layout.
resolution아니요출력 크기. 클수록 선명하고 가격도 올라갑니다. 1k · 1.5k · 기본값: 1k
seed아니요같은 숫자를 쓰면 같은 결과를 다시 얻을 수 있습니다. ≥ 0 · ≤ 2147483647
steps아니요단계가 많을수록 디테일이 늘지만 더 오래 걸립니다. ≥ 1 · ≤ 50 · 기본값: 28

가격

가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.

옵션크레딧 /장≈ USD
기본5.4US$0.054

작업마다 크레딧은 정수로 올림 처리되므로, 가장 낮은 옵션으로 한 번 실행하면 6크레딧/장(US$0.06)입니다.

실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.

API 빠른 시작

FLUX.1 Dev ControlNet LoRA API를 3단계로 호출하기

  1. API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
  2. 요청 보내기. POST /jobs/createTask에 model은 black-forest-labs/flux-1-dev-controlnet-lora/text-to-image, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
  3. 결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 callBackUrl을 넘기면 결과를 그 주소로 보내 드립니다. 작업이 성공하면 출력 링크에서 내려받으세요.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "black-forest-labs/flux-1-dev-controlnet-lora/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "control_image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "resolution": "1k",
    "num_outputs": 1,
    "output_format": "jpeg"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.

FLUX.1 Dev ControlNet LoRA API 질문

FLUX.1 Dev ControlNet LoRA API 요금은 얼마인가요?

FLUX.1 Dev ControlNet LoRA 가격은 6크레딧(US$0.06) /장입니다. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.

API에서 FLUX.1 Dev ControlNet LoRA의 모델 이름은 무엇인가요?

POST /jobs/createTask의 model 필드에 이미지 만들기: black-forest-labs/flux-1-dev-controlnet-lora/text-to-image을(를) 넣으세요.

제어 이미지란 무엇입니까?

원하는 구조를 담은 맵입니다. 색이 입혀진 포즈 스켈레톤, 흑백 깊이 맵, 검은 바탕의 흰색 canny 또는 soft-edge 선, 혹은 흑백 사진이 해당합니다. 모델은 맵의 구도와 포즈를 따르고 나머지는 프롬프트에서 가져옵니다.

포즈나 깊이를 대신 감지해 줍니까?

아니요. 맵 자체를 보내십시오. 일반 사진도 받지만, 흑백 맵처럼 화면을 제약하므로 윤곽과 옷의 형태가 그대로 넘어옵니다.

어떤 LoRA가 동작합니까?

FLUX.1 dev용으로 학습한 LoRA이며, .safetensors 파일의 직접 다운로드 링크로 넘깁니다. 저희 테스트에서 SDXL LoRA는 요청이 실패했으니, 불러오기 전에 LoRA 페이지에서 기본 모델을 확인하십시오.

이미지를 상업적으로 써도 됩니까?

Black Forest Labs의 FLUX.1 [dev] 라이선스는 생성한 이미지를 개인, 연구, 상업 목적으로 쓰도록 허용합니다. 불러오는 각 LoRA의 라이선스는 제작자가 정하므로 모델 카드를 확인하십시오.

FLUX.1 Dev ControlNet LoRA API의 제한은 무엇인가요?

해상도: 1K · 1.5K; 호출당 출력 수: 1–4; 프롬프트 길이(글자): 5,000; 최대 업로드 크기: 10 MB. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.

코드 없이 FLUX.1 Dev ControlNet LoRA을(를) 써 볼 수 있나요?

네. Playground에서는 API 키 없이 PopNow 크레딧으로 FLUX.1 Dev ControlNet LoRA을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.

모든 FLUX 모델

FLUX.1 Dev LoRA는 컨트롤 이미지가 없고 자유로운 구도에 알맞아요.

FLUX.1 Dev ControlNet LoRA 더 알아보기