HERMES + FLUX KONTEXT

Hermes Agent에서 Flux Kontext 사용하기.

Black Forest Labs의 Flux Kontext는 캐릭터 일관성을 유지하며 텍스트 기반 이미지 편집 및 생성을 처리합니다. Hermes Agent는 채팅에 사용한 것과 동일한 key와 base URL로 custom:runapi provider를 통해 호출합니다.

하나의 API key · 텍스트-이미지 엔드포인트 · 비동기 작업 폴링
Use RunAPI to generate an image with Flux Kontext Pro through Hermes Agent.

Requirements:
- Use the custom:runapi provider already configured in Hermes Agent
- Call the RunAPI text_to_image endpoint at https://runapi.ai/v1/text_to_image
- Set model to "flux-kontext-pro"
- The RUNAPI_API_KEY environment variable provides 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
작동 방식

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

1

RunAPI 설정

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

export RUNAPI_API_KEY=runapi_xxx
2

Flux Kontext 호출

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

text_to_image
3

결과 가져오기

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 선택 사항. 출력 종횡비.

Hermes Agent의 Flux Kontext란?

Flux Kontext는 Black Forest Labs가 120억 파라미터 정류 흐름 트랜스포머 위에 구축한 지시 기반 이미지 편집기로, 다중 라운드 편집을 지원합니다——여러 편집을 순차적으로 연결할 수 있으며 모델은 각 이전 단계의 컨텍스트를 유지합니다. Hermes Agent는 RunAPI 커스텀 provider 엔드포인트를 통해 호출하며, 멀티 스텝 편집 파이프라인 구축이 용이합니다.

Flux Kontext 활용 사례

다중 라운드 편집 워크플로

여러 편집 단계를 순서대로 연결합니다——이미지 생성, 조명 조정, 배경 교체, 텍스트 추가——각 단계가 이전 결과 위에 쌓입니다.

스타일 변환 파이프라인

피사체의 구도를 유지하면서 사진을 회화·스케치·애니메이션 스타일로 변환하며, 동일 콘텐츠의 스타일 변형 제작에 활용합니다.

날씨 및 조명 조정

전체 장면을 처음부터 다시 생성하지 않고 기존 사진의 시간대·날씨·조명 설정을 변경합니다.

FAQ

Flux Kontext + Hermes Agent 자주 묻는 질문

Hermes Agent 일반 설정

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

Hermes Agent 설정 가이드 →

Flux Kontext 모델 카탈로그

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

Flux Kontext 모델 →

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

무료 RunAPI key를 발급받고, custom:runapi provider를 설정한 뒤 Flux Kontext로 이미지를 생성해보세요.