Image 제공: Black Forest Labs

Flux Fill Pro API

마스크로 인페인트하거나 캔버스를 확장하는 아웃페인트.

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

API 키 받기 Apiframe Studio에서 사용 Flux Fill Pro API 문서 보기

model: "flux-fill-pro"

Flux Fill Pro의 특별한 점

이미지→이미지 편집 및 참조 이미지 지원.
빠른 처리 — 생성당 평균 약 15초.
Black Forest Labs 계정 없이 사용한 만큼 지불. 성공한 생성에 대해서만 비용을 지불합니다.
Apiframe의 모든 모델에서 하나의 API 키, 통합 청구, 멱등성, 웹훅을 지원.

Flux Fill Pro(으)로 시도해 볼 프롬프트

Apiframe의 Flux Fill Pro API로 실행할 수 있는 프롬프트 예시입니다.

Mask the old sign on the storefront and replace it with a clean blue sign reading 'OPEN'.

Remove the parked car from the driveway and fill the space with matching pavement.

Extend this portrait outward to a wider 16:9 frame, continuing the background naturally.

Paint over the model's jacket and change it to a tan trench coat, keeping the lighting consistent.

Fill the empty wall behind the sofa with a large framed landscape painting.

Expand the top of this product photo to add headroom for a banner headline.

개요

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

기능

이미지 입력지원

평균 시간~15초

빠른 시작

API 키와 함께 POST /v2/images/edit 요청을 한 번 보내면 Flux Fill Pro로 생성이 시작됩니다. 응답으로 폴링하거나 웹훅으로 받을 수 있는 jobId가 반환됩니다.

curl -X POST https://api.apiframe.ai/v2/images/edit \
  -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-fill-pro",
        "fluxFillParams": {
            "image": "https://example.com/input.jpg",
            "mode": "inpaint",
            "mask": "https://example.com/input.jpg",
            "outpaint": "Zoom out 1.5x"
        }
    }'

import requests

response = requests.post(
    "https://api.apiframe.ai/v2/images/edit",
    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-fill-pro",
        "fluxFillParams": {
            "image": "https://example.com/input.jpg",
            "mode": "inpaint",
            "mask": "https://example.com/input.jpg",
            "outpaint": "Zoom out 1.5x"
        }
    },
)
print(response.json())  # { "jobId": "...", "status": "QUEUED" }

const response = await fetch("https://api.apiframe.ai/v2/images/edit", {
  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-fill-pro",
    "fluxFillParams": {
      "image": "https://example.com/input.jpg",
      "mode": "inpaint",
      "mask": "https://example.com/input.jpg",
      "outpaint": "Zoom out 1.5x"
    }
  }),
});
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 Fill Pro 엔드포인트가 허용하는 요청 파라미터입니다. 모델별 옵션은 아래에 표시된 파라미터 객체 안에 중첩됩니다.

파라미터	유형	필수	기본값	허용값 / 범위	설명
prompt	string	필수	—	—	생성할 내용에 대한 텍스트 설명.
model	string	필수	"flux-fill-pro"	"flux-fill-pro"	이 엔드포인트의 모델 식별자.
fluxFillParams.image	string (URL)	선택	—	—	Source image (URL)
fluxFillParams.mode	string	선택	"inpaint"	"inpaint", "outpaint"	Mode
fluxFillParams.mask	string (URL)	선택	—	—	White = repaint, black = keep. Required for inpaint.
fluxFillParams.outpaint	string	선택	"Zoom out 1.5x"	"Zoom out 1.5x", "Zoom out 2x", "Make square", "Left outpaint", "Right outpaint", "Top outpaint", "Bottom outpaint"	Required for outpaint mode.
fluxFillParams.prompt	string	선택	—	—	Prompt
fluxFillParams.prompt_upsampling	boolean	선택	false	—	Prompt upsampling
fluxFillParams.steps	number	선택	50	min 1, max 50, step 1	Steps
fluxFillParams.guidance	number	선택	3	min 2, max 5, step 0.1	Guidance
fluxFillParams.safety_tolerance	number	선택	2	min 1, max 6, step 1	1 = strictest, 6 = most permissive.
fluxFillParams.output_format	string	선택	"jpg"	"jpg", "png"	Output format
fluxFillParams.seed	number	선택	—	step 1	Reuse a number to reproduce the same result.

자주 묻는 질문

Flux Fill Pro API에 대한 일반적인 질문입니다.

Flux Fill Pro API가 있나요?

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

Flux Fill Pro API 비용은 얼마인가요?

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

Flux Fill Pro API는 어떻게 호출하나요?

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

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

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

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

고객 지원 문의 Discord 참여

Flux Fill Pro API로 개발을 시작하세요

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

무료 크레딧으로 시작

모든 모델을 위한 하나의 API

웹훅, SDK 및 멱등성

제공업체 계정 불필요

무료로 시작하기 문서 읽기

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