Black Forest Labs · 이미지

OpenClaw x Flux Kontext

Flux Kontext는 12B 파라미터 Flux 아키텍처를 기반으로 한 Black Forest Labs의 컨텍스트 인식 편집 모델입니다. RunAPI를 통해 Kontext Pro와 Max 변형 모두 단일 키를 공유합니다.

2 variants 최저 $0.11 / 회 상업적 사용 지원
API 키 받기 OpenClaw 문서 보기

Prerequisite: npx runapi mcp install

Prompt

프롬프트 모델

작업에 맞는 경우 flux-kontext-max를 사용하세요: 4K 출력, 우수한 텍스트 렌더링, 고급 컨텍스트 편집.

You have access to RunAPI task tools for Flux Kontext.

Available Flux Kontext models:
- flux-kontext-max: 4K 출력, 우수한 텍스트 렌더링, 고급 컨텍스트 편집
  endpoints: /api/v1/flux_kontext/text_to_image
  request fields: model, prompt
- flux-kontext-pro: 컨텍스트 편집에서 균형 잡힌 속도와 품질
  endpoints: /api/v1/flux_kontext/text_to_image
  request fields: model, prompt

Use the model ID and endpoint that match the user's request.
Example prompt: 이 제품 사진을 편집해 주세요: 제품을 정확히 동일하게 유지하면서 배경을 열대 해변으로 변경해 주세요.
/api/v1/flux_kontext/text_to_image: Submit the task, poll for its status, then verify the completed output. POST /api/v1/flux_kontext/text_to_image를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/flux_kontext/text_to_image/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.

공개 버전 및 엔드포인트

모델 ID 엔드포인트 시작 가격 모델 카탈로그
flux-kontext-max
/api/v1/flux_kontext/text_to_image
$0.17 / 회 모델 상세
flux-kontext-pro
/api/v1/flux_kontext/text_to_image
$0.11 / 회 모델 상세

검증

Task가 최종 상태에 도달할 때까지 폴링합니다

<model-id>를 선택하면 검증 명령을 생성합니다.

설정

가이드 엔드포인트: <endpoint>

<model-id>를 선택하면 엔드포인트의 공개 입력 계약에 맞는 요청을 생성합니다.
사용 절차

3단계로 시작하기

  1. 모델 ID 선택

    공개 모델 ID를 선택하고 엔드포인트와 현재 시작 가격을 확인합니다.

  2. RunAPI 설정

    엔드포인트 요청 전에 RUNAPI_API_KEY를 설정합니다.

  3. 결과 검증

    비동기 엔드포인트는 Task가 최종 상태가 될 때까지 같은 엔드포인트를 폴링합니다.

OpenClaw + Flux Kontext로 만들 수 있는 것

  • 피사체는 그대로 두고 배경 교체

    제품 사진이나 인물 사진의 배경을 바꾸면서 피사체 위치는 유지합니다. 마스크나 인페인팅 없이 텍스트 지시만으로 가능합니다.

  • 의상과 외모 변경

    얼굴 특징은 유지한 채 캐릭터의 의상, 머리 색, 액세서리를 바꿀 수 있어 패션 목업과 캐릭터 디자인 반복 작업에 유용합니다.

  • 간판과 라벨의 텍스트 교체

    새 문구를 프롬프트에 적기만 하면 기존 이미지 속 간판, 제품 라벨, 매장 전면의 텍스트를 바꿀 수 있습니다.

Flux Kontext을(를) RunAPI + OpenClaw로 사용하는 이유

  • 2개 변형 모델, 하나의 API 키

    하나의 RunAPI 연결에서 사용 가능한 모델 변형을 선택할 수 있어 통합 방식을 바꿀 필요가 없습니다.

  • 명확한 사용 요금

    요청을 보내기 전에 현재 카탈로그 요금을 확인하세요. 구독이나 최소 사용 금액이 없습니다.

  • 자동화된 작업 워크플로

    수동 폴링 코드를 작성하지 않고 일관된 작업 흐름으로 비동기 결과를 제출하고 확인하고 수집하세요.

OpenClaw + Flux Kontext 자주 묻는 질문

OpenClaw에서 Flux Kontext를 사용할 수 있나요?

네. OpenClaw에서 RunAPI를 공급자로 설정한 뒤 이 페이지에 표시된 Flux Kontext 엔드포인트를 호출하세요. 채팅에 쓰는 같은 RunAPI API 키로 이미지 생성과 편집도 처리됩니다.

Flux Kontext는 비동기로 동작하나요?

네. API가 즉시 작업 ID를 반환합니다. 작업 상태를 폴링하거나 콜백을 사용해 완성된 이미지 URL을 받으세요.

Flux Kontext로 이미지 속 텍스트를 편집할 수 있나요?

네. 원본 이미지를 전달하고 프롬프트에 텍스트 변경 내용을 적으세요. 모델이 원본과 같은 위치와 스타일로 새 텍스트를 렌더링합니다.

어떤 모델 ID를 사용해야 하나요?

버전 표에서 공개 모델 ID를 선택하세요. 각 ID가 제공하는 엔드포인트는 해당 행에 표시됩니다.

이 가이드는 채팅 모델을 설정하나요?

아니요. 이 Model Line은 여기에 표시된 엔드포인트 절차를 사용하며 Agent 채팅 모델로 제공되지 않습니다.

OpenClaw에서 Flux Kontext 사용 시작하기

API 키 받기 빠른 시작 읽기

팀과 함께 구축하고 계신가요?

엔터프라이즈 설정, 통합, 기술 문의를 도와드립니다.

문의하기