Flux Kontext에 별도의 API key가 필요한가요?

아니요. 동일한 RUNAPI_API_KEY가 LLM, 이미지, 비디오, 음악 등 모든 RunAPI 모델에 사용됩니다. 하나의 key, 하나의 결제 계정입니다.

Flux Kontext는 비동기인가요, 동기인가요?

비동기입니다. API는 즉시 task ID를 반환합니다. task status endpoint를 폴링하거나 webhook callback을 사용해 완성된 이미지 URL을 받으세요.

Flux Kontext 비용은 얼마인가요?

Flux Kontext Pro는 이미지당 2.5센트부터 시작합니다. Flux Kontext Max는 더 높은 품질을 위해 더 비쌉니다. 현재 요금은 RunAPI 가격 페이지에서 확인하세요 — 구독 없이 사용한 만큼 청구됩니다.

OPENCLAW + FLUX KONTEXT

OpenClaw에서 Flux Kontext 사용하기.

Black Forest Labs의 Flux Kontext는 캐릭터 일관성을 유지하며 텍스트 기반 이미지 편집 및 생성을 처리합니다. OpenClaw agent는 채팅에 사용한 것과 동일한 API key로 RunAPI를 통해 호출합니다 — 프롬프트를 보내면 이미지 URL을 받습니다.

API Key 받기 문서 읽기

하나의 API key · 텍스트-이미지 엔드포인트 · 비동기 작업 폴링

Use RunAPI to generate an image with Flux Kontext Pro.

Requirements:
- Call the RunAPI text_to_image endpoint at https://runapi.ai/v1/text_to_image
- Set model to "flux-kontext-pro"
- Use the RUNAPI_API_KEY environment variable for authorization
- The response is async — poll the task status endpoint until the task completes, then retrieve the image URL

curl -X POST https://runapi.ai/v1/text_to_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-kontext-pro",
    "prompt": "a matte-black water bottle on a beige stone surface, soft side light, studio photography"
  }'

{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "flux-kontext-pro"
}

curl 명령어를 복사하여 테스트하세요 flux-kontext

작동 방식

OpenClaw에서 Flux Kontext를 세 단계로 사용하기

RunAPI 설정

RUNAPI_API_KEY 환경 변수를 설정하세요. 이미 OpenClaw에서 채팅용 provider로 RunAPI를 설정했다면, 동일한 key가 이미지 생성에도 사용됩니다 — 추가 설정이 필요 없습니다.

export RUNAPI_API_KEY=runapi_xxx

Flux Kontext 호출

model을 flux-kontext-pro로 설정하여 text_to_image endpoint에 POST 요청을 보내세요. 원하는 이미지를 설명하는 텍스트 프롬프트를 포함하세요. 컨텍스트 편집을 위해 선택적으로 image_url을 전달할 수 있습니다.

text_to_image

결과 가져오기

endpoint는 task ID를 반환합니다. status가 completed로 변경될 때까지 task status endpoint를 폴링한 뒤, 응답에서 생성된 이미지 URL을 가져오세요.

task_id: tsk_abc123

파라미터

Flux Kontext API 파라미터

파라미터	유형	설명
`model`	`string`	필수. flux-kontext-pro 또는 flux-kontext-max.
`prompt`	`string`	생성 또는 편집을 위한 텍스트 지시문.
`image_url`	`string`	컨텍스트 편집을 위한 소스 이미지 URL.
`aspect_ratio`	`string`	선택 사항. 출력 종횡비.

OpenClaw의 Flux Kontext란?

Flux Kontext는 Black Forest Labs가 만든 연속 이미지 편집 모델입니다. 변경할 부분을 텍스트로 설명하면 해당 부분만 수정하고 나머지는 그대로 유지합니다——옷을 바꿔도 얼굴은 변하지 않고, 배경을 교체해도 제품 위치는 그대로입니다. OpenClaw agent는 RunAPI의 text_to_image 엔드포인트를 통해 호출합니다.

Flux Kontext 활용 사례

피사체를 유지한 배경 교체

제품이나 인물 사진의 배경을 피사체가 완전히 동일한 위치에 있는 채로 교체합니다——마스킹도 인페인팅도 필요 없이 텍스트 한 줄로 완료됩니다.

의상 및 외모 변경

캐릭터의 얼굴 특징을 유지하면서 옷·머리색·액세서리를 변경하며, 패션 목업과 캐릭터 디자인 반복 작업에 활용합니다.

간판 및 레이블 텍스트 교체

기존 이미지의 간판·제품 레이블·매장 전면의 텍스트를 교체합니다——프롬프트에 새 텍스트를 입력하면 Flux Kontext가 제자리에 렌더링합니다.

FAQ

Flux Kontext + OpenClaw 자주 묻는 질문

OpenClaw 일반 설정

아직 설정하지 않으셨나요? OpenClaw용 RunAPI 설정 가이드로 시작하세요.

OpenClaw 설정 가이드 →

Flux Kontext 모델 카탈로그

Flux Kontext의 모든 변형, 가격, API 문서를 확인하세요.

Flux Kontext 모델 →

지금 OpenClaw에서 Flux Kontext를 사용해보세요.

무료 RunAPI key를 발급받고, OpenClaw에 프롬프트를 붙여넣어 Flux Kontext로 이미지를 생성해보세요.

모델 보기 →