요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
guidance_scale | 아니요 | 프롬프트를 얼마나 엄격히 따를지. ≥ 28 · ≤ 35 · 기본값: 30 |
image_url | 예 | 출발점이 되는 이미지. |
loras | 아니요 | 내 LoRA 파일을 불러와 스타일이나 캐릭터를 고정합니다. 기본값: [] |
mask_url | 예 | 바꿀 영역을 칠합니다. |
num_outputs | 아니요 | 한 번에 만들 결과 수. ≥ 1 · ≤ 4 · 기본값: 1 |
prompt | 예 | Describe what belongs in the white area of the mask, in the light and style of the rest of the picture. |
resolution | 아니요 | 출력 크기. 클수록 선명하고 가격도 올라갑니다. 1k · 1.5k · 기본값: 1k |
seed | 아니요 | 같은 숫자를 쓰면 같은 결과를 다시 얻을 수 있습니다. ≥ 0 · ≤ 2147483647 |
steps | 아니요 | 단계가 많을수록 디테일이 늘지만 더 오래 걸립니다. ≥ 1 · ≤ 50 · 기본값: 28 |
가격
가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.
| 옵션 | 크레딧 /장 | ≈ USD |
|---|---|---|
| 기본 | 6.3 | US$0.063 |
작업마다 크레딧은 정수로 올림 처리되므로, 가장 낮은 옵션으로 한 번 실행하면 7크레딧/장(US$0.07)입니다.
실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.
API 빠른 시작
FLUX.1 Fill Dev LoRA API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
- 요청 보내기. POST /jobs/createTask에 model은 black-forest-labs/flux-1-fill-dev-lora/edit, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
- 결과 받기. 작업 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-fill-dev-lora/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"mask_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"resolution": "1k",
"num_outputs": 1
}
}'
# 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 Fill Dev LoRA API 질문
FLUX.1 Fill Dev LoRA API 요금은 얼마인가요?
FLUX.1 Fill Dev LoRA 가격은 7크레딧(US$0.07) /장입니다. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.
API에서 FLUX.1 Fill Dev LoRA의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 이미지 편집: black-forest-labs/flux-1-fill-dev-lora/edit을(를) 넣으세요.
마스크는 어떤 모양이어야 합니까?
원본과 같은 크기의 흑백 이미지입니다. 흰색은 다시 그릴 부분, 검은색은 유지할 부분을 뜻합니다. 저희 테스트에서 전부 검은 마스크는 사진을 그대로 돌려주었고, 크기가 다른 마스크는 거부되지 않고 늘려서 맞춰졌습니다.
어떤 LoRA가 동작합니까?
FLUX.1 dev용으로 학습한 LoRA이며, .safetensors 파일의 직접 다운로드 링크로 넘깁니다. 저희 테스트에서 SDXL LoRA는 픽셀 하나 바꾸지 못했고, 예전 트레이너 형식으로 저장된 FLUX LoRA는 효과가 거의 없었습니다.
이미지를 상업적으로 써도 됩니까?
Black Forest Labs의 FLUX.1 [dev] 라이선스는 생성한 이미지를 개인, 연구, 상업 목적으로 쓰도록 허용합니다. 불러오는 각 LoRA의 라이선스는 제작자가 정하므로 모델 카드를 확인하십시오.
FLUX.1 Fill Dev LoRA API의 제한은 무엇인가요?
해상도: 1K · 1.5K; 호출당 출력 수: 1–4; 프롬프트 길이(글자): 5,000; 최대 업로드 크기: 10 MB. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.
코드 없이 FLUX.1 Fill Dev LoRA을(를) 써 볼 수 있나요?
네. Playground에서는 API 키 없이 PopNow 크레딧으로 FLUX.1 Fill Dev LoRA을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.
모든 FLUX 모델
FLUX.1 Schnell LoRA도 마스크로 인페인팅할 수 있고 더 빠르고 저렴해요.
- FLUX.2 Max APIFLUX 최상위: 사진 같은 빛과 정확한 브랜드 컬러11크레딧부터 /장
- FLUX 3 API사운드가 맞춰진 영상과 빠른 초안 등급45크레딧부터 / 5초 영상
- FLUX.2 Klein 9B LoRA API빠른 FLUX.2 Klein 9B, 내 LoRA 최대 3개3크레딧부터 /장
- FLUX.2 Klein Base 9B LoRA API증류하지 않은 Klein 9B, 내 LoRA로 다채롭게4크레딧부터 /장
- FLUX.2 Klein 4B LoRA API작고 빠른 FLUX.2 Klein 4B, 내 LoRA 사용3크레딧부터 /장
- FLUX.2 Klein Base 4B LoRA API증류하지 않은 Klein 4B, 내 LoRA 불러오기3크레딧부터 /장
- FLUX.2 Klein 9B API얼굴과 포즈를 그대로 지키는 빠른 FLUX 편집2크레딧부터 /장
- FLUX.2 Klein 4B API가장 작고 빠른 FLUX, 빠른 초안용2크레딧부터 /장
- FLUX.2 Dev LoRA APIFLUX.2 Dev 생성·편집, 내 LoRA 사용4크레딧부터 /장
- FLUX.2 Pro API읽히는 글자를 담은 사진급 이미지, HEX 색상 지정5크레딧부터 /장
- FLUX.2 Flex API제목과 라벨을 쓴 그대로 정확하게9크레딧부터 /장
- FLUX.2 Dev API오픈 웨이트 FLUX, 여러 인물을 한 장면에 합성2크레딧부터 /장
- FLUX.1 Krea Dev LoRA API사진 감성의 FLUX.1 Krea, 내 LoRA 사용4크레딧부터 /장
- FLUX.1 Dev ControlNet LoRA APIFLUX.1을 포즈·깊이·선화로 제어, 내 LoRA 사용6크레딧부터 /장
- FLUX.1 Fill Dev LoRA APIFLUX.1 Fill로 마스크 부분 다시 그리기, 내 LoRA 사용7크레딧부터 /장
- FLUX.1 Dev LoRA API클래식 FLUX.1 Dev, 내 LoRA 최대 3개3크레딧부터 /장
- FLUX.1 Schnell LoRA API빠른 FLUX.1 Schnell, 내 LoRA 불러오기1크레딧부터 /장


