요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
aspect_ratio | 아니요 | 화면 모양: 가로, 정사각형, 세로. 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 · 2:1 |
duration_seconds | 아니요 | 클립 길이. 초 단위로 요금이 붙습니다. 5–20 · 기본값: 5 |
generate_audio | 아니요 | 화면에 맞는 소리(목소리, 주변음, 효과음)를 더합니다. 기본값: true |
image_url | 예 | 출발점이 되는 이미지. |
last_image_url | 아니요 | 선택 사항인 마지막 프레임. 원하는 장면에서 클립을 끝냅니다. |
prompt | 예 | Describe the subject, action, camera, light and sound for the shot. |
quality | 아니요 | 시간과 비용을 더 들여 디테일을 높입니다. standard · draft · 기본값: standard |
resolution | 아니요 | 출력 크기. 클수록 선명하고 가격도 올라갑니다. 720p · 1080p · 기본값: 720p |
가격
가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.
| 옵션 | 크레딧 /초 | ≈ USD |
|---|---|---|
| quality draft · resolution 1080p | 9 | US$0.09 |
| quality draft · resolution 720p | 9 | US$0.09 |
| quality standard · resolution 720p | 25.5 | US$0.26 |
| quality standard · resolution 1080p | 43.5 | US$0.44 |
실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.
API 빠른 시작
FLUX 3 API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
- 요청 보내기. POST /jobs/createTask에 model은 black-forest-labs/flux-3/image-to-video, 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-3/image-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"quality": "standard",
"resolution": "720p",
"duration_seconds": 5
}
}'
# 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 3 API 질문
FLUX 3 API 요금은 얼마인가요?
FLUX 3 가격은 가장 저렴한 이미지로 영상 만들기 기준 45크레딧(US$0.45) / 5초 영상부터입니다. 옵션별 가격: draft · 1080p 9크레딧/초, draft · 720p 9크레딧/초, standard · 720p 25.5크레딧/초, standard · 1080p 43.5크레딧/초. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.
API에서 FLUX 3의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 동영상 만들기: black-forest-labs/flux-3/text-to-video; 이미지로 영상 만들기: black-forest-labs/flux-3/image-to-video; 영상 이어 만들기: black-forest-labs/flux-3/video-extend; 영상 화질 개선: black-forest-labs/flux-3/upscale을(를) 넣으세요.
비디오 확장은 클립 전체를 돌려줍니까?
아닙니다. 결과에는 원본 클립이 아니라 새로 생성한 구간만 담기므로 편집기에서 두 클립을 이어 붙이세요. 새 구간은 원본의 마지막 프레임에서 시작하며, 저희 테스트에서는 짧은 디졸브로 시작한 뒤 다음 동작으로 넘어갔습니다.
20초짜리 롱테이크를 만들 수 있습니까?
최대 20초까지 요청할 수 있지만, 특히 빛이나 동작이 크게 바뀔 때는 클립 안에서 모델이 장면을 끊거나 디졸브할 수 있습니다. 통제하려면 짧은 클립을 만들어 확장으로 이으세요.
마지막 프레임을 줄 수 있습니까?
이미지→비디오에서 가능합니다. 클립은 첫 이미지에서 마지막 이미지로 움직입니다. 두 프레임의 빛이나 장소가 크게 다르면 모델이 점진적으로 바꾸지 않고 중간에서 장면을 끊을 수 있으니, 부드럽게 이어지길 원하면 두 프레임을 비슷하게 유지하세요.
FLUX 3 API의 제한은 무엇인가요?
영상 길이: 5–20 s; 해상도: 720p · 1080p; 화면 비율: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 · 2:1; 프롬프트 길이(글자): 5,000. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.
코드 없이 FLUX 3을(를) 써 볼 수 있나요?
네. Playground에서는 API 키 없이 PopNow 크레딧으로 FLUX 3을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.
모든 FLUX 모델
LTX 2.5는 네이티브 4K를 지원하고 마찬가지로 20초까지 돼요. FLUX 3는 저렴한 초안 단계에 더해 연장과 업스케일을 한곳에서 쓸 수 있어요.
- 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크레딧부터 /장

