Image 제공: Black Forest Labs

Flux 2 Dev API

실험용으로 공개된 Flux 2 가중치.

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

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

model: "flux-2-dev"

Flux 2 Dev photorealistic hero banner of a hiking backpack on a mossy rock in morning mist with soft natural light

Flux 2 Dev의 특별한 점

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

Flux 2 Dev(으)로 제작

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

Flux 2 Dev three product renders of the same sneaker in white, black, and red with a consistent angle and lighting — Three product renders of the same sneaker in white, black, and red, consistent angle and lighting.

Flux 2 Dev 3D concept art frame of a futuristic train station interior with warm lighting and detailed reflections — A 3D concept art frame of a futuristic train station interior, warm lighting, detailed reflections.

Flux 2 Dev cozy reading nook with a velvet armchair, a stack of books, and a warm lamp in late afternoon light — A cozy reading nook with a velvet armchair, a stack of books, and a warm lamp, late afternoon light.

Flux 2 Dev ad creative for a cold brew can on crushed ice with condensation droplets and bright studio lighting — An ad creative for a cold brew can on crushed ice, condensation droplets, bright studio lighting.

Flux 2 Dev consistent mascot shown waving, sitting at a desk, and giving a thumbs up in a unified style — Using these reference images of our mascot, show it waving, sitting at a desk, and giving a thumbs up, in a consistent style.

개요

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

기능

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

이미지 입력지원

평균 시간~10초

빠른 시작

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

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

파라미터	유형	필수	기본값	허용값 / 범위	설명
prompt	string	필수	—	—	생성할 내용에 대한 텍스트 설명.
model	string	필수	"flux-2-dev"	"flux-2-dev"	이 엔드포인트의 모델 식별자.
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 Dev API에 대한 일반적인 질문입니다.

Flux 2 Dev API가 있나요?

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

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

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

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

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

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

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

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

고객 지원 문의 Discord 참여

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

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

무료 크레딧으로 시작

모든 모델을 위한 하나의 API

웹훅, SDK 및 멱등성

제공업체 계정 불필요

무료로 시작하기 문서 읽기

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