Image 제공: Black Forest Labs

Flux 2 Flex API

스텝과 가이던스를 조절할 수 있는 Flux 2.

Flux 2 Flex을(를) 단 한 번의 API 호출로 통합하세요. 하나의 키, 하나의 통합 엔드포인트, 그리고 Apiframe의 모든 모델에 적용되는 통합 청구.

API 키 받기 Apiframe Studio에서 사용 Flux 2 Flex API 문서 보기

model: "flux-2-flex"

Flux 2 Flex kombucha bottle label mockup reading 'WILD GINGER' with 'Organic, 330ml' beneath in crisp small text

Flux 2 Flex의 특별한 점

0.5MP / 1MP / 2MP / 4MP(으)로 출력.
1:1, 3:4, 4:3을(를) 포함한 5가지 화면 비율 지원.
이미지→이미지 편집 및 참조 이미지 지원.
빠른 처리 — 생성당 평균 약 15초.
Black Forest Labs 계정 없이 사용한 만큼 지불. 성공한 생성에 대해서만 비용을 지불합니다.
Apiframe의 모든 모델에서 하나의 API 키, 통합 청구, 멱등성, 웹훅을 지원.

Flux 2 Flex(으)로 제작

Apiframe의 Flux 2 Flex API로 생성한 출력 예시입니다.

Flux 2 Flex clean infographic titled 'How Solar Panels Work' with four labeled steps in a flat modern style — A clean infographic titled 'How Solar Panels Work' with four labeled steps, flat modern style.

Flux 2 Flex mobile app dashboard mockup with a balance card reading '$2,480.00', three menu tabs, and legible button labels — A mobile app dashboard with a balance card reading '$2,480.00', three menu tabs, and legible button labels.

A minimalist logo for a bakery called 'FLOUR & STONE', clean serif lettering, warm neutral palette.

Flux 2 Flex concert poster reading 'NIGHT MARKET LIVE' with the date 'AUG 14' and venue in a bold typographic layout — A concert poster reading 'NIGHT MARKET LIVE' with the date 'AUG 14' and venue, bold typographic layout.

Flux 2 Flex square social promo reading '24-HOUR FLASH SALE, UP TO 50% OFF' with clean type on a bright gradient — A square promo reading '24-HOUR FLASH SALE, UP TO 50% OFF' with clean type and a bright gradient.

개요

엔드포인트: POST /v2/images/generate
모델 ID: flux-2-flex
파라미터 키: fluxParams
모달리티: 이미지
제공업체: Black Forest Labs
평균 완료 시간: ~15s

기능

화면 비율1:1, 3:4, 4:3, 9:16, 16:9

해상도0.5MP, 1MP, 2MP, 4MP

이미지 입력지원

평균 시간~15초

빠른 시작

API 키와 함께 POST /v2/images/generate 요청을 한 번 보내면 Flux 2 Flex로 생성이 시작됩니다. 응답으로 폴링하거나 웹훅으로 받을 수 있는 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-flex",
        "fluxParams": {
            "resolution": "2MP",
            "image_prompt": "https://example.com/input.jpg",
            "image_prompt_strength": 0.5,
            "steps": 28
        }
    }'

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-flex",
        "fluxParams": {
            "resolution": "2MP",
            "image_prompt": "https://example.com/input.jpg",
            "image_prompt_strength": 0.5,
            "steps": 28
        }
    },
)
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-flex",
    "fluxParams": {
      "resolution": "2MP",
      "image_prompt": "https://example.com/input.jpg",
      "image_prompt_strength": 0.5,
      "steps": 28
    }
  }),
});
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 Flex 엔드포인트가 허용하는 요청 파라미터입니다. 모델별 옵션은 아래에 표시된 파라미터 객체 안에 중첩됩니다.

파라미터	유형	필수	기본값	허용값 / 범위	설명
prompt	string	필수	—	—	생성할 내용에 대한 텍스트 설명.
model	string	필수	"flux-2-flex"	"flux-2-flex"	이 엔드포인트의 모델 식별자.
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.steps	number	선택	28	min 1, max 50, step 1	Steps
fluxParams.guidance	number	선택	3	min 1.5, max 10, step 0.1	How strictly to follow the prompt.
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.go_fast	boolean	선택	false	—	Go fast
fluxParams.seed	number	선택	—	step 1	Reuse a number to reproduce the same result.

자주 묻는 질문

Flux 2 Flex API에 대한 일반적인 질문입니다.

Flux 2 Flex API가 있나요?

네. Apiframe는 단일 REST 엔드포인트(`POST /v2/images/generate`, `model: "flux-2-flex"`)로 Flux 2 Flex을(를) 제공합니다. 지원되는 모든 모델에서 통합된 API, 키, 청구를 사용할 수 있으며 별도의 Black Forest Labs 계정이 필요하지 않습니다.

Flux 2 Flex API 비용은 얼마인가요?

Flux 2 Flex은(는) Apiframe에서 간단한 사용량 기반 과금을 사용하며, 성공한 생성에 대해서만 비용을 지불합니다. 요금제와 대량 할인은 가격 페이지를 참고하세요.

Flux 2 Flex API는 어떻게 호출하나요?

`X-API-Key`와 `model: "flux-2-flex"`을(를) 포함한 JSON 본문을 담아 `/v2/images/generate`에 POST 요청을 보냅니다. 응답으로 반환되는 `jobId`를 `GET /v2/jobs/{id}`로 폴링하거나 웹훅으로 결과를 받습니다.

Flux 2 Flex은(는) 어떤 파라미터를 지원하나요?

Flux 2 Flex은(는) 공통 `prompt`, `webhook_url` 필드와 함께 `fluxParams` 아래에 중첩된 10개의 모델별 파라미터를 허용합니다. 유형과 기본값을 포함한 전체 목록은 위의 입력 스키마를 참고하세요.

아직 궁금한 점이 있으신가요?

고객 지원 문의 Discord 참여

Flux 2 Flex API로 개발을 시작하세요

API 키를 받아 몇 분 만에 Flux 2 Flex을(를) 통합하세요 — 사용한 만큼 지불.

무료 크레딧으로 시작

모든 모델을 위한 하나의 API

웹훅, SDK 및 멱등성

제공업체 계정 불필요

무료로 시작하기 문서 읽기

궁금하신 점이 있으신가요? Discord에 참여하거나 영업팀에 문의하세요.