Flux 2 Pro API
Black Forest Labs의 Flux 2 Pro를 하나의 통합 API로 사용해 고품질 AI 이미지를 생성하세요. 단일 REST 엔드포인트, 비동기 작업, 웹훅을 갖추었으며 별도의 제공업체 계정을 관리할 필요가 없습니다.
Flux 2 Pro을(를) 단 한 번의 API 호출로 통합하세요. 하나의 키, 하나의 통합 엔드포인트, 그리고 Apiframe의 모든 모델에 적용되는 통합 청구.
model: "flux-2-pro" 
Flux 2 Pro의 특별한 점
- 0.5MP / 1MP / 2MP / 4MP(으)로 출력.
- 1:1, 3:4, 4:3을(를) 포함한 5가지 화면 비율 지원.
- 이미지→이미지 편집 및 참조 이미지 지원.
- 빠른 처리 — 생성당 평균 약 15초.
- Black Forest Labs 계정 없이 사용한 만큼 지불. 성공한 생성에 대해서만 비용을 지불합니다.
- Apiframe의 모든 모델에서 하나의 API 키, 통합 청구, 멱등성, 웹훅을 지원.
Flux 2 Pro(으)로 제작
Apiframe의 Flux 2 Pro API로 생성한 출력 예시입니다.
Using these reference images of our mascot, show the same character waving, working at a desk, and holding a coffee cup, in a consistent style.
A photorealistic electric SUV on a coastal highway at golden hour, cinematic lighting, sharp reflections.
An event poster reading 'SUMMER SOUND FESTIVAL' with modern type, date and venue beneath, bold gradient background.
A matte black ceramic mug on sunlit marble, morning light through linen curtains, editorial product style.
Replace the plain background in this product photo with a soft studio gradient, keeping the product identical.
A cozy home office: wooden desk with a laptop, a steaming mug on the left, a potted monstera on the right, warm afternoon light.
개요
- 엔드포인트
- POST /v2/images/generate
- 모델 ID
- flux-2-pro
- 파라미터 키
- fluxParams
- 모달리티
- 이미지
- 제공업체
- Black Forest Labs
- 평균 완료 시간
- ~15s
기능
빠른 시작
API 키와 함께 POST /v2/images/generate 요청을 한 번 보내면 Flux 2 Pro로 생성이 시작됩니다. 응답으로 폴링하거나 웹훅으로 받을 수 있는 jobId가 반환됩니다.
curl -X POST https://api.apiframe.ai/v2/images/generate \
-H "X-API-Key: afk_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
"model": "flux-2-pro",
"fluxParams": {
"resolution": "2MP",
"image_prompt": "https://example.com/input.jpg",
"image_prompt_strength": 0.5,
"output_format": "jpg"
}
}'import requests
response = requests.post(
"https://api.apiframe.ai/v2/images/generate",
headers={
"X-API-Key": "afk_your_api_key_here",
"Content-Type": "application/json",
},
json={
"prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
"model": "flux-2-pro",
"fluxParams": {
"resolution": "2MP",
"image_prompt": "https://example.com/input.jpg",
"image_prompt_strength": 0.5,
"output_format": "jpg"
}
},
)
print(response.json()) # { "jobId": "...", "status": "QUEUED" }const response = await fetch("https://api.apiframe.ai/v2/images/generate", {
method: "POST",
headers: {
"X-API-Key": "afk_your_api_key_here",
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
"model": "flux-2-pro",
"fluxParams": {
"resolution": "2MP",
"image_prompt": "https://example.com/input.jpg",
"image_prompt_strength": 0.5,
"output_format": "jpg"
}
}),
});
const { jobId } = await response.json();
console.log(jobId);응답 및 작업 수명 주기
생성은 비동기로 처리됩니다. 제출이 성공하면 202 Accepted와 jobId가 반환됩니다. 상태가 COMPLETED가 될 때까지 GET /v2/jobs/{id}를 폴링하거나 webhook_url을 지정하면 result 필드에 출력 URL이 담깁니다.
1. 제출 응답 (202)
{
"jobId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
"status": "QUEUED"
}2. 결과 폴링
curl https://api.apiframe.ai/v2/jobs/JOB_ID \
-H "X-API-Key: afk_your_api_key_here"import requests, time
while True:
job = requests.get(
"https://api.apiframe.ai/v2/jobs/JOB_ID",
headers={"X-API-Key": "afk_your_api_key_here"},
).json()
if job["status"] in ("COMPLETED", "FAILED"):
break
time.sleep(2)
print(job["result"])let job;
do {
await new Promise((r) => setTimeout(r, 2000));
job = await fetch("https://api.apiframe.ai/v2/jobs/JOB_ID", {
headers: { "X-API-Key": "afk_your_api_key_here" },
}).then((r) => r.json());
} while (job.status !== "COMPLETED" && job.status !== "FAILED");
console.log(job.result);입력 스키마
Flux 2 Pro 엔드포인트가 허용하는 요청 파라미터입니다. 모델별 옵션은 아래에 표시된 파라미터 객체 안에 중첩됩니다.
| 파라미터 | 유형 | 필수 | 기본값 | 허용값 / 범위 | 설명 |
|---|---|---|---|---|---|
| prompt | string | 필수 | — | — | 생성할 내용에 대한 텍스트 설명. |
| model | string | 필수 | "flux-2-pro" | "flux-2-pro" | 이 엔드포인트의 모델 식별자. |
| fluxParams.resolution | string | 선택 | "2MP" | "0.5MP", "1MP", "2MP", "4MP" | Resolution |
| fluxParams.image_prompt | string (URL) | 선택 | — | — | Reference image (URL) |
| fluxParams.image_prompt_strength | number | 선택 | 0.5 | min 0, max 1, step 0.05 | How closely to follow the reference image (0–1). |
| fluxParams.output_format | string | 선택 | "jpg" | "jpg", "png", "webp" | Output format |
| fluxParams.output_quality | number | 선택 | 90 | min 0, max 100, step 1 | Output quality |
| fluxParams.prompt_upsampling | boolean | 선택 | false | — | Let the model rewrite your prompt for better quality. |
| fluxParams.seed | number | 선택 | — | step 1 | Reuse a number to reproduce the same result. |
자주 묻는 질문
Flux 2 Pro API에 대한 일반적인 질문입니다.
Flux 2 Pro API가 있나요?
네. Apiframe는 단일 REST 엔드포인트(`POST /v2/images/generate`, `model: "flux-2-pro"`)로 Flux 2 Pro을(를) 제공합니다. 지원되는 모든 모델에서 통합된 API, 키, 청구를 사용할 수 있으며 별도의 Black Forest Labs 계정이 필요하지 않습니다.
Flux 2 Pro API 비용은 얼마인가요?
Flux 2 Pro은(는) Apiframe에서 간단한 사용량 기반 과금을 사용하며, 성공한 생성에 대해서만 비용을 지불합니다. 요금제와 대량 할인은 가격 페이지를 참고하세요.
Flux 2 Pro API는 어떻게 호출하나요?
`X-API-Key`와 `model: "flux-2-pro"`을(를) 포함한 JSON 본문을 담아 `/v2/images/generate`에 POST 요청을 보냅니다. 응답으로 반환되는 `jobId`를 `GET /v2/jobs/{id}`로 폴링하거나 웹훅으로 결과를 받습니다.
Flux 2 Pro은(는) 어떤 파라미터를 지원하나요?
Flux 2 Pro은(는) 공통 `prompt`, `webhook_url` 필드와 함께 `fluxParams` 아래에 중첩된 7개의 모델별 파라미터를 허용합니다. 유형과 기본값을 포함한 전체 목록은 위의 입력 스키마를 참고하세요.
아직 궁금한 점이 있으신가요?
Flux 2 Pro API로 개발을 시작하세요
API 키를 받아 몇 분 만에 Flux 2 Pro을(를) 통합하세요 — 사용한 만큼 지불.
궁금하신 점이 있으신가요? Discord에 참여하거나 영업팀에 문의하세요.