Hermes Agent에서 Flux Kontext 사용하기.
Black Forest Labs의 Flux Kontext는 캐릭터 일관성을 유지하며 텍스트 기반 이미지 편집 및 생성을 처리합니다. Hermes Agent는 채팅에 사용한 것과 동일한 key와 base URL로 custom:runapi provider를 통해 호출합니다.
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"
}
Hermes Agent에서 Flux Kontext를 세 단계로 사용하기
RunAPI 설정
RUNAPI_API_KEY 환경 변수를 설정하세요. 이미 Hermes Agent에서 채팅용 custom:runapi provider로 RunAPI를 추가했다면, 동일한 key와 base_url이 이미지 생성에도 사용됩니다 — 추가 설정이 필요 없습니다.
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 |
선택 사항. 출력 종횡비. |
Hermes Agent의 Flux Kontext란?
Flux Kontext는 Black Forest Labs가 120억 파라미터 정류 흐름 트랜스포머 위에 구축한 지시 기반 이미지 편집기로, 다중 라운드 편집을 지원합니다——여러 편집을 순차적으로 연결할 수 있으며 모델은 각 이전 단계의 컨텍스트를 유지합니다. Hermes Agent는 RunAPI 커스텀 provider 엔드포인트를 통해 호출하며, 멀티 스텝 편집 파이프라인 구축이 용이합니다.
Flux Kontext 활용 사례
다중 라운드 편집 워크플로
여러 편집 단계를 순서대로 연결합니다——이미지 생성, 조명 조정, 배경 교체, 텍스트 추가——각 단계가 이전 결과 위에 쌓입니다.
스타일 변환 파이프라인
피사체의 구도를 유지하면서 사진을 회화·스케치·애니메이션 스타일로 변환하며, 동일 콘텐츠의 스타일 변형 제작에 활용합니다.
날씨 및 조명 조정
전체 장면을 처음부터 다시 생성하지 않고 기존 사진의 시간대·날씨·조명 설정을 변경합니다.
Flux Kontext + Hermes Agent 자주 묻는 질문
네. Hermes Agent에서 RunAPI를 custom:runapi provider로 설정한 뒤, model을 flux-kontext-pro로 설정하여 text_to_image endpoint를 호출하세요. 채팅에 사용하는 RUNAPI_API_KEY가 이미지 생성에도 사용됩니다.
아니요. 동일한 RUNAPI_API_KEY가 LLM, 이미지, 비디오, 음악 등 모든 RunAPI 모델에 사용됩니다. 하나의 key, 하나의 결제 계정입니다.
비동기입니다. API는 즉시 task ID를 반환합니다. task status endpoint를 폴링하거나 webhook callback을 사용해 완성된 이미지 URL을 받으세요.
Flux Kontext Pro는 이미지당 2.5센트부터 시작합니다. Flux Kontext Max는 더 높은 품질을 위해 더 비쌉니다. 현재 요금은 RunAPI 가격 페이지에서 확인하세요 — 구독 없이 사용한 만큼 청구됩니다.
지금 Hermes Agent에서 Flux Kontext를 사용해보세요.
무료 RunAPI key를 발급받고, custom:runapi provider를 설정한 뒤 Flux Kontext로 이미지를 생성해보세요.